RunspaceFactory.CreateRunspace Method (InitialSessionState)

Creates a single runspace that uses the default host and specified initial session state information.


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

'Usage
Dim initialSessionState As InitialSessionState
Dim returnValue As Runspace

returnValue = RunspaceFactory.CreateRunspace(initialSessionState)

[SuppressMessageAttribute("Microsoft.Naming", "CA1704:IdentifiersShouldBeSpelledCorrectly", MessageId="Runspace")] 
public static Runspace CreateRunspace (
	InitialSessionState initialSessionState
)
/** @attribute SuppressMessageAttribute("Microsoft.Naming", "CA1704:IdentifiersShouldBeSpelledCorrectly", MessageId="Runspace") */ 
public static Runspace CreateRunspace (
	InitialSessionState initialSessionState
)
SuppressMessageAttribute("Microsoft.Naming", "CA1704:IdentifiersShouldBeSpelledCorrectly", MessageId="Runspace") 
public static function CreateRunspace (
	initialSessionState : InitialSessionState
) : Runspace

Parameters

initialSessionState

An InitialSessionState object that defines the session state configuration when the runspace is opened.

Return Value

Returns a Runspace object. When the runspace is opened, the specified initial session state is used to define the elements, such as modules, cmdlets, scripts, functions, and variables that are accessible to the runspace.

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