The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Runspace08 Sample


This sample shows how to add commands and arguments to the pipeline of a PowerShell object and how to run the commands synchronously.


This sample requires Windows PowerShell 2.0.


This sample demonstrates the following.

  • Creating a Runspace object by using the RunspaceFactory class.

  • Creating a PowerShell object that uses the runspace.

  • Adding cmdlets to the pipeline of the PowerShell object.

  • Running the cmdlets synchronously.

  • Extracting properties from the PSObject objects returned by the command.


This sample runs the Get-Process and Sort-Object cmdlets by using a PowerShell object.

namespace Microsoft.Samples.PowerShell.Runspaces
  using System;
  using System.Collections.Generic;
  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 Runspace08
    /// <summary>
    /// This sample shows how to use a PowerShell object to run commands. The  
    /// PowerShell object builds a pipeline that include the get-process cmdlet, 
    /// which is then piped to the sort-object cmdlet. Parameters are added to the 
    /// sort-object cmdlet to sort the HandleCount property in descending order. 
    /// </summary>
    /// <param name="args">Parameter is not used.</param>
    /// <remarks>
    /// This sample demonstrates:
    /// 1. Creating a PowerShell object
    /// 2. Adding individual commands to the PowerShell object.
    /// 3. Adding parameters to the commands. 
    /// 4. Running the pipeline of the PowerShell object synchronously.
    /// 5. Working with PSObject objects to extract properties 
    ///    from the objects returned by the commands.
    /// </remarks>
    private static void Main(string[] args)
      Collection<PSObject> results; // Holds the result of the pipeline execution.

      // Create the PowerShell object. Notice that no runspace is specified so a 
      // new default runspace is used.
      PowerShell powershell = PowerShell.Create();

      // Use the using statement so that we can dispose of the PowerShell object
      // when we are done.
      using (powershell)
        // Add the get-process cmdlet to the pipeline of the PowerShell object.

        // Add the sort-object cmdlet and its parameters to the pipeline of 
        // the PowerShell object so that we can sort the HandleCount property 
        //  in descending order.
        powershell.AddCommand("sort-object").AddParameter("descending").AddParameter("property", "handlecount");

        // Run the commands of the pipeline synchronously.
        results = powershell.Invoke();

      // Even after disposing of the PowerShell object, we still 
      // need to set the powershell variable to null so that the 
      // garbage collector can clean it up.
      powershell = null;

      Console.WriteLine("Process              HandleCount");

      // Display the results returned by the commands. 
      foreach (PSObject result in results)
                          "{0,-20} {1}",

      System.Console.WriteLine("Hit any key to exit...");