Runspace06 示例

此示例演示如何将模块添加到 System.Management.Automation.Runspaces.Initialsessionstate 对象，以便在打开运行空间时加载该模块。该模块提供使用 System.Management.Automation.Powershell 对象同步运行的 Get-Proc cmdlet（由 GetProcessSample02 示例定义）。

要求

此示例需要 Windows PowerShell 2.0。

示范

该示例演示了以下内容。

• 创建 System.Management.Automation.Runspaces.Initialsessionstate 对象。

• 将模块添加到 System.Management.Automation.Runspaces.Initialsessionstate 对象。

• 创建使用 System.Management.Automation.Runspaces.Initialsessionstate 对象的 System.Management.Automation.Runspaces.Runspace 对象。

• 创建使用运行空间的 System.Management.Automation.Powershell 对象。

• 将模块的 get-proc cmdlet 添加到 System.Management.Automation.Powershell 对象的管道中。

• 同步运行命令。

• 从命令返回的 System.Management.Automation.PSObject 对象中提取属性。

例子

此示例创建一个运行空间，该运行空间使用 System.Management.Automation.Runspaces.Initialsessionstate 对象来定义打开运行空间时可用的元素。在此示例中，定义 Get-Proc cmdlet 的模块被添加到初始会话状态。

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 Runspace06
  {
    /// <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 binary module that is loaded by the initial session state.
    /// </summary>
    /// <param name="args">Parameter not used.</param>
    /// <remarks>
    /// This sample assumes that user has copied the GetProcessSample02.dll
    /// that is produced by the GetProcessSample02 sample to the current
    /// directory.
    /// This sample demonstrates the following:
    /// 1. Creating a default initial session state.
    /// 2. Adding a module 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 module's get-proc cmdlet to the PowerShell object.
    /// 6. Running the command synchronously.
    /// 7. 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 and add the module.
      InitialSessionState iss = InitialSessionState.CreateDefault();
      iss.ImportPSModule(new string[] { @".\GetProcessSample02.dll" });

      // 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))
      {
        myRunSpace.Open();

        // Create a PowerShell object.
        using (PowerShell powershell = PowerShell.Create())
        {
          // Add the cmdlet and specify the runspace.
          powershell.AddCommand(@"GetProcessSample02\get-proc");
          powershell.Runspace = myRunSpace;

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

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

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

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

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

参见

编写 Windows PowerShell 主机应用程序