RunspaceFactory.CreateRunspace Method (PSHost)

Creates a single runspace that uses a custom host.


Namespace: System.Management.Automation.Runspaces
Assembly: System.Management.Automation (in System.Management.Automation.dll)

'Usage
Dim host As PSHost
Dim returnValue As Runspace

returnValue = RunspaceFactory.CreateRunspace(host)

public static Runspace CreateRunspace (
	PSHost host
)
public static Runspace CreateRunspace (
	PSHost host
)
public static function CreateRunspace (
	host : PSHost
) : Runspace

Parameters

host

A PSHost object that represents the host. A host is used to interact or communicate directly with the user through prompting.

Return Value

Returns a Runspace object that represents the runspace. When the runspace is opened, the host defines how the invoked commands are handled by Windows PowerShell.

A runspace is the operating environment used when invoking the commands of a pipeline. After the runspace is created, it must be opened by using one of the following methods before it can be used:

  • To open the runspace synchronously, call the Open method.

  • To open the runspace asynchronously, call the OpenAsync method.

When using the default host, there is no way to interact or communicate directly with the user through prompting.


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.
Show:
© 2014 Microsoft