Export (0) Print
Expand All

RunspaceFactory.CreateRunspace Method ()

Creates a single runspace that uses the default host and runspace configuration.

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

Dim returnValue As Runspace

returnValue = RunspaceFactory.CreateRunspace

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

Return Value

Returns a Runspace object that represents the runspace. When this runspace is opened, the default host and runspace configuration that are defined by Windows PowerShell will be used.

This example creates a runspace, opens it synchronously, and then uses the runspace when the pipeline is invoked.

namespace HostPS4
    using System;
    using System.Management.Automation;           // Windows PowerShell namespace.
    using System.Management.Automation.Runspaces; // Windows PowerShell namespace.

  class HostPS4
    static void Main(string[] args)

    // Call the CreateRunspace() method to create the 
    // runspace. This call does not specify any 
    // configuration information such as a custom host 
    // or initial session state information.
    Runspace rs = RunspaceFactory.CreateRunspace();

      // Call the Create() method to create the PowerShell 
      // object, and then specify the runspace and 
      // create the pipeline.
      PowerShell ps = PowerShell.Create();
      ps.Runspace = rs;

      Console.WriteLine("Process               Id");

      // Using the PowerShell object, invoke the pipeline 
      // synchronously.
      foreach (PSObject result in ps.Invoke())
      } // End foreach.

      // Close the runspace and release any resources.
    } // End Main.
  } // End HostPS4.

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