RunspaceFactory.CreateRunspace Method (RunspaceConnectionInfo, PSHost, TypeTable)

Creates a single runspace that can be opened on a remote computer. The runspace uses a custom host, connection information, and type table (serialization) information. 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 returnValue As Runspace

returnValue = RunspaceFactory.CreateRunspace(connectionInfo, host, typeTable)
public static Runspace CreateRunspace (
	RunspaceConnectionInfo connectionInfo,
	PSHost host,
	TypeTable typeTable
)
public static Runspace CreateRunspace (
	RunspaceConnectionInfo connectionInfo, 
	PSHost host, 
	TypeTable typeTable
)
public static function CreateRunspace (
	connectionInfo : RunspaceConnectionInfo, 
	host : PSHost, 
	typeTable : TypeTable
) : 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.

Return Value

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

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

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. All rights reserved.