Runspace.Close Method

Closes the runspace and makes it unavailable for use.

Namespace: System.Management.Automation.Runspaces
Assembly: System.Management.Automation (in System.Management.Automation.dll)
Dim instance As Runspace

public abstract void Close ()
public abstract void Close ()
public abstract function Close ()
Exception typeCondition

The runspace is not in a state that allows it to be closed.


The runspace failed to close a remote session.

For runspaces that are using nested pipelines, this method closes all active pipelines.

To find out the state of the runspace, use the RunspaceStateInfo property.

To close a namespace asynchronously, call the CloseAsync method.

For more information about runspaces and runspace pools, see Host Application Runspaces.

The user at the command line may not necessarily realize that the commands that Windows PowerShell runs are being processed within a runspace. From the command-line user’s point of view, commands are run in a Windows PowerShell session. From a host application’s point of view, commands are run within a runspace.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.


Target Platforms

Windows 98, Windows 2000, Windows 2000 Server, Windows CE, Windows Server 2008, Windows 98 Second Edition, Pocket PC, Smart Phone, Windows Server 2003, Windows XP Professional, Windows Vista, Windows Server 2003 R2, Windows XP, Windows 7, Windows 2008 R2, Windows Developer Preview, Windows Server Developer Preview

Send comments about this topic to Microsoft.
© 2014 Microsoft. All rights reserved.