Voorbeeld Runspace10

In dit voorbeeld ziet u hoe u een standaard initiële sessietoestand maakt, hoe u een cmdlet toevoegt aan system.Management.Automation.Runspaces.Initialsessionstate,hoe u een runspace maakt die gebruikmaakt van de initiële sessietoestand en hoe u de opdracht kunt uitvoeren met behulp van een System.Management.Automation.Powershell-object.

Vereisten

Voor dit voorbeeld is Windows PowerShell 2.0 vereist.

Demonstreert

In dit voorbeeld wordt het volgende gedemonstreerd.

• Een System.Management.Automation.Runspaces.Initialsessionstate-object maken.

• Een cmdlet toevoegen (gedefinieerd door de hosttoepassing) aan het object System.Management.Automation.Runspaces.Initialsessionstate.

• Een System.Management.Automation.Runspaces.Runspace-object maken dat gebruikmaakt van het -object.

• Een System.Management.Automation.Powershell-object maken dat gebruikmaakt van het object System.Management.Automation.Runspaces.Runspace.

• Voeg de opdracht toe aan de pijplijn van het object System.Management.Automation.Powershell.

• Eigenschappen extraheren uit de System.Management.Automation.PSObject-objecten die worden geretourneerd door de opdracht .

Voorbeeld

In dit voorbeeld wordt een runspace gemaakt die gebruikmaakt van een System.Management.Automation.Runspaces.Initialsessionstate-object om de elementen te definiëren die beschikbaar zijn wanneer de runspace wordt geopend. In dit voorbeeld wordt de Get-Proc-cmdlet (gedefinieerd door de hosttoepassing) toegevoegd aan de initiële sessietoestand en wordt de cmdlet synchroon uitgevoerd met behulp van een System.Management.Automation.Powershell-object.

namespace Microsoft.Samples.PowerShell.Runspaces
{
  using System;
  using System.Collections.Generic;
  using System.Collections.ObjectModel;
  using System.Diagnostics;
  using System.Management.Automation;
  using System.Management.Automation.Runspaces;
  using PowerShell = System.Management.Automation.PowerShell;

  #region GetProcCommand

  /// <summary>
  /// Class that implements the GetProcCommand.
  /// </summary>
  [Cmdlet(VerbsCommon.Get, "Proc")]
  public class GetProcCommand : Cmdlet
  {
    #region Cmdlet Overrides

    /// <summary>
    /// For each of the requested process names, retrieve and write
    /// the associated processes.
    /// </summary>
    protected override void ProcessRecord()
    {
      // Get the current processes.
      Process[] processes = Process.GetProcesses();

      // Write the processes to the pipeline making them available
      // to the next cmdlet. The second argument (true) tells the
      // system to enumerate the array, and send one process object
      // at a time to the pipeline.
      WriteObject(processes, true);
    }

    #endregion Overrides
  } // End GetProcCommand class.

  #endregion GetProcCommand

  /// <summary>
  /// This class contains the Main entry point for this host application.
  /// </summary>
  internal class Runspace10
  {
    /// <summary>
    /// This sample shows how to create a default initial session state, how to add
    /// add a cmdlet to the InitialSessionState object, and then how to create
    /// a Runspace object.
    /// </summary>
    /// <param name="args">Parameter is not used.</param>
    /// This sample demonstrates:
    /// 1. Creating an InitialSessionState object.
    /// 2. Adding a cmdlet to the InitialSessionState object.
    /// 3. Creating a runspace that uses the InitialSessionState object.
    /// 4. Creating a PowerShell object that uses the Runspace object.
    /// 5. Running the added command synchronously.
    /// 6. Working with PSObject objects to extract properties
    ///    from the objects returned by the pipeline.
    private static void Main(string[] args)
    {
      // Create a default InitialSessionState object. The default
      // InitialSessionState object contains all the elements provided
      // by Windows PowerShell.
      InitialSessionState iss = InitialSessionState.CreateDefault();

      // Add the get-proc cmdlet to the InitialSessionState object.
      SessionStateCmdletEntry ssce = new SessionStateCmdletEntry("get-proc", typeof(GetProcCommand), null);
      iss.Commands.Add(ssce);

      // Create a Runspace object that uses the InitialSessionState object.
      // Notice that no PSHost object is specified, so the default host is used.
      // See the Hosting samples for information on creating your own custom host.
      using (Runspace myRunSpace = RunspaceFactory.CreateRunspace(iss))
      {
        myRunSpace.Open();

        using (PowerShell powershell = PowerShell.Create())
        {
          powershell.Runspace = myRunSpace;

          // Add the get-proc cmdlet to the pipeline of the PowerShell object.
          powershell.AddCommand("get-proc");

          Collection<PSObject> results = powershell.Invoke();

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

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

        // Close the runspace to release resources.
        myRunSpace.Close();
      }

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

Zie ook

Een Windows PowerShell-hosttoepassing schrijven