Windows Dev Center

RunspaceFactory.CreateRunspace Method (RunspaceConnectionInfo, PSHost, TypeTable, PSPrimitiveDictionary)

Creates a single runspace that can be opened on a remote computer. The runspace uses a custom host, connection information, type table (serialization) information, and endpoint application arguments. This method is introduced in Windows PowerShell 2.0.


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

'Usage
Dim connectionInfo As RunspaceConnectionInfo
Dim host As PSHost
Dim typeTable As TypeTable
Dim applicationArguments As PSPrimitiveDictionary
Dim returnValue As Runspace

returnValue = RunspaceFactory.CreateRunspace(connectionInfo, host, typeTable, applicationArguments)

public static Runspace CreateRunspace (
	RunspaceConnectionInfo connectionInfo,
	PSHost host,
	TypeTable typeTable,
	PSPrimitiveDictionary applicationArguments
)
public static Runspace CreateRunspace (
	RunspaceConnectionInfo connectionInfo, 
	PSHost host, 
	TypeTable typeTable, 
	PSPrimitiveDictionary applicationArguments
)
public static function CreateRunspace (
	connectionInfo : RunspaceConnectionInfo, 
	host : PSHost, 
	typeTable : TypeTable, 
	applicationArguments : PSPrimitiveDictionary
) : Runspace

Parameters

connectionInfo

An object that derives from the RunspaceConnectionInfo abstract class. This object defines the information used to connect to a specific computer.

host

A PSHost object that represents the host that provides communications between Windows PowerShell and the user.

typeTable

A TypeTable object that contains information used to serialize and deserialize objects passed between computers.

applicationArguments

A PSPrimitiveDictionary object that contains the application arguments for the endpoint on the remote computer.

Return Value

Returns a Runspace object that represents the runspace that uses the specified connection information, host, type table, and application arguments.

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.


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


Show:
© 2015 Microsoft