Runspace08 – exempel

Det här exemplet visar hur du lägger till kommandon och argument i pipelinen för ett System.Management.Automation.PowerShell-objekt och hur du kör kommandona synkront.

Krav

Det här exemplet kräver Windows PowerShell 2.0.

Demonstrerar

Det här exemplet visar följande.

• Skapa ett System.Management.Automation.Runspaces.Runspace-objekt med hjälp av klassen System.Management.Automation.Runspaces.RunspaceFactory.

• Skapa ett System.Management.Automation.PowerShell-objekt som använder körningsytan.

• Lägga till cmdletar i pipelinen för objektet System.Management.Automation.PowerShell.

• Köra cmdletarna synkront.

• Extrahera egenskaper från System.Management.Automation.PSObject objekt som returneras av kommandot.

Exempel

Det här exemplet kör cmdletarna Get-Process och Sort-Object med hjälp av ett System.Management.Automation.PowerShell-objekt.

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.
        powershell.AddCommand("Get-Process");

        // 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");
      Console.WriteLine("--------------------------------");

      // Display the results returned by the commands.
      foreach (PSObject result in results)
      {
        Console.WriteLine(
                          "{0,-20} {1}",
                          result.Members["ProcessName"].Value,
                          result.Members["HandleCount"].Value);
      }

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

Se även

Skriva ett Windows PowerShell-värdprogram