Runspace05 Sample

This sample shows how to add a snap-in to an InitialSessionState object so that the cmdlet of the snap-in is available when the runspace is opened. The snap-in provides a Get-Proc cmdlet (defined by the GetProcessSample01 Sample) that is run synchronously by using a PowerShell object.


This sample requires Windows PowerShell 2.0.


This sample demonstrates the following.


This sample creates a runspace that uses an InitialSessionState object to define the elements that are available when the runspace is opened. In this sample, a snap-in that defines a Get-Proc cmdlet is added to the initial session state.

namespace Microsoft.Samples.PowerShell.Runspaces
  using System;
  using System.Collections.ObjectModel;
  using System.Management.Automation;
  using System.Management.Automation.Runspaces;
  using PowerShell = System.Management.Automation.PowerShell;
  /// <summary>
  /// This class contains the Main entry point for this host application.
  /// </summary>
  internal class Runspace05
    /// <summary>
    /// This sample shows how to define an initial session state that is 
    /// used when creating a runspace. The sample invokes a command from 
    /// a Windows PowerShell snap-in that is present in the console file.
    /// </summary>
    /// <param name="args">The parameter is not used.</param>
    /// <remarks>
    /// This sample assumes that user has coppied the GetProcessSample01.dll 
    /// that is produced by the GetProcessSample01 sample to the current 
    /// directory. 
    /// This sample demonstrates the following:
    /// 1. Creating a default initial session state.
    /// 2. Adding a snap-in to the initial session state.
    /// 3. Creating a runspace that uses the initial session state.
    /// 4. Creating a PowerShell object that uses the runspace.
    /// 5. Adding the snap-in's get-proc cmdlet to the PowerShell object.
    /// 6. Using PSObject objects to extract and display properties from 
    ///    the objects returned by the cmdlet.
    /// </remarks>
    private static void Main(string[] args)
      // Create the default initial session state. The default initial 
      // session state contains all the elements provided by Windows 
      // PowerShell.
      InitialSessionState iss = InitialSessionState.CreateDefault();
      PSSnapInException warning;
      iss.ImportPSSnapIn("GetProcPSSnapIn01", out warning);
      // Create a runspace. Notice that no PSHost object is supplied to the 
      // CreateRunspace method so the default host is used. See the Host 
      // samples for more information on creating your own custom host.
      using (Runspace myRunSpace = RunspaceFactory.CreateRunspace(iss))
        // Create a PowerShell object. 
        using (PowerShell powershell = PowerShell.Create())
          // Add the snap-in cmdlet and specify the runspace.
          powershell.Runspace = myRunSpace;
          // Run the cmdlet synchronously.
          Collection<PSObject> results = powershell.Invoke();
          Console.WriteLine("Process              HandleCount");
          // Display the results.
          foreach (PSObject result in results)
                              "{0,-20} {1}",
        // Close the runspace to release any resources.
      System.Console.WriteLine("Hit any key to exit...");

See Also

© 2014 Microsoft