Voorbeeld Runspace03

In dit voorbeeld ziet u hoe u de klasse System.Management.Automation.Powershell gebruikt om een script synchroon uit te voeren en hoe u niet-beëindigingsfouten kunt afhandelen. Het script ontvangt een lijst met procesnamen en haalt deze processen vervolgens op. De resultaten van het script, inclusief eventuele niet-beëindigingsfouten die zijn gegenereerd bij het uitvoeren van het script, worden weergegeven in een consolevenster.

Vereisten

Voor dit voorbeeld is Windows PowerShell 2.0 vereist.

Demonstreert

In dit voorbeeld wordt het volgende gedemonstreerd.

• Een System.Management.Automation.Powershell-object maken om een script uit te voeren.

• Een script toevoegen aan de pijplijn van het object System.Management.Automation.Powershell.

• Invoerobjecten doorgeven aan het script vanuit het aanroepende programma.

• Het script synchroon uitvoeren.

• Gebruik System.Management.Automation.PSObject-objecten om eigenschappen te extraheren en weer te geven van de objecten die door het script worden geretourneerd.

• Het ophalen en weergeven van foutrecords die zijn gegenereerd toen het script werd uitgevoerd.

Voorbeeld

In dit voorbeeld wordt een script synchroon uitgevoerd in de standaardrunspace die door Windows PowerShell. De uitvoer van het script en eventuele niet-beëindigingsfouten die zijn gegenereerd, worden weergegeven in een consolevenster.

namespace Microsoft.Samples.PowerShell.Runspaces
{
  using System;
  using System.Collections;
  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 Runspace03
  {
    /// <summary>
    /// This sample shows how to use the PowerShell class to run a
    /// script that retrieves process information for the list of
    /// process names passed to the script. It shows how to pass input
    /// objects to a script and how to retrieve error objects as well
    /// as the output objects.
    /// </summary>
    /// <param name="args">Parameter not used.</param>
    /// <remarks>
    /// This sample demonstrates the following:
    /// 1. Creating a PowerSHell object to run a script.
    /// 2. Adding a script to the pipeline of the PowerShell object.
    /// 3. Passing input objects to the script from the calling program.
    /// 4. Running the script synchronously.
    /// 5. Using PSObject objects to extract and display properties from
    ///    the objects returned by the script.
    /// 6. Retrieving and displaying error records that were generated
    ///    when the script was run.
    /// </remarks>
    private static void Main(string[] args)
    {
      // Define a list of processes to look for.
      string[] processNames = new string[]
      {
        "lsass", "nosuchprocess", "services", "nosuchprocess2"
      };

      // The script to run to get these processes. Input passed
      // to the script will be available in the $input variable.
      string script = "$input | get-process -name {$_}";

      // Create a PowerShell object. Creating this object takes care of
      // building all of the other data structures needed to run the script.
      using (PowerShell powershell = PowerShell.Create())
      {
        powershell.AddScript(script);

        Console.WriteLine("Process              HandleCount");
        Console.WriteLine("--------------------------------");

        // Invoke the script synchronously and display the
        // ProcessName and HandleCount properties of the
        // objects that are returned.
        foreach (PSObject result in powershell.Invoke(processNames))
        {
          Console.WriteLine(
                            "{0,-20} {1}",
                            result.Members["ProcessName"].Value,
                            result.Members["HandleCount"].Value);
        }

        // Process any error records that were generated while running
        //  the script.
        Console.WriteLine("\nThe following non-terminating errors occurred:\n");
        PSDataCollection<ErrorRecord> errors = powershell.Streams.Error;
        if (errors != null && errors.Count > 0)
        {
          foreach (ErrorRecord err in errors)
          {
            System.Console.WriteLine("    error: {0}", err.ToString());
          }
        }
      }

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

Zie ook

Een Windows PowerShell-hosttoepassing schrijven