GetProcessSample01 示例

此示例演示如何实现一个用于检索本地计算机上的进程的 cmdlet。 此 cmdlet 是 Get-Process Windows PowerShell 2.0 提供的 cmdlet 的简化版本。

如何使用 Visual Studio 生成示例。

1. 安装 Windows PowerShell 2.0 SDK 后，导航到 GetProcessSample01 文件夹。 默认位置是 (x86) \microsoft sdk \ Windows \v7.0\Samples\sysmgmt\WindowsPowerShell\csharp\GetProcessSample01. 的 C:\Program 文件。

2. 双击解决方案的图标 ( .sln) 文件。 这会在 Microsoft Visual Studio 中打开示例项目。

3. 在“生成”菜单中选择“生成解决方案” 。

示例库将在默认的 \bin 或 \bin\debug 文件夹中生成。

如何运行示例

1. 打开“命令提示”窗口。

2. 导航到包含示例 .dll 文件的目录。

3. 运行 installutil.exe "GetProcessSample01.dll"。

4. 启动 Windows PowerShell。

5. 运行以下命令，将管理单元添加到 shell 中。

   Add-PSSnapin GetProcPSSnapIn01

6. 输入以下命令以运行 cmdlet。 get-proc

   get-proc

   这是通过以下步骤生成的示例输出。

   Id              Name            State      HasMoreData     Location             Command
   --              ----            -----      -----------     --------             -------
   1               26932870-d3b... NotStarted False                                 Write-Host "A f...
   
   

   Set-Content $env:temp\test.txt "This is a test file"
   

   A file was created in the TEMP directory
   

要求

此示例需要 Windows PowerShell 1.0 或更高版本。

演示

此示例演示以下各项。

• 创建基本的示例 cmdlet。

• 使用 Cmdlet 特性定义 cmdlet 类。

• 创建可与 Windows PowerShell 1.0 和 Windows PowerShell 2.0 一起使用的管理单元。 后续示例使用模块，而不是管理单元，因此它们需要 Windows PowerShell 2.0。

示例

此示例演示如何创建一个简单的 cmdlet 及其管理单元。

using System;
using System.Diagnostics;
using System.Management.Automation;             //Windows PowerShell namespace
using System.ComponentModel;

namespace Microsoft.Samples.PowerShell.Commands
{

   #region GetProcCommand

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

      /// <summary>
      /// The ProcessRecord method calls the Process.GetProcesses
      /// method to retrieve the processes of the local computer.
      /// Then, the WriteObject method writes the associated processes
      /// to the pipeline.
      /// </summary>
      protected override void ProcessRecord()
      {
         // Retrieve the current processes.
         Process[] processes = Process.GetProcesses();

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

      #endregion Overrides

   } //GetProcCommand

   #endregion GetProcCommand

   #region PowerShell snap-in

   /// <summary>
   /// Create this sample as an PowerShell snap-in
   /// </summary>
   [RunInstaller(true)]
   public class GetProcPSSnapIn01 : PSSnapIn
   {
       /// <summary>
       /// Create an instance of the GetProcPSSnapIn01
       /// </summary>
       public GetProcPSSnapIn01()
           : base()
       {
       }

       /// <summary>
       /// Get a name for this PowerShell snap-in. This name will be used in registering
       /// this PowerShell snap-in.
       /// </summary>
       public override string Name
       {
           get
           {
               return "GetProcPSSnapIn01";
           }
       }

       /// <summary>
       /// Vendor information for this PowerShell snap-in.
       /// </summary>
       public override string Vendor
       {
           get
           {
               return "Microsoft";
           }
       }

       /// <summary>
       /// Gets resource information for vendor. This is a string of format:
       /// resourceBaseName,resourceName.
       /// </summary>
       public override string VendorResource
       {
           get
           {
               return "GetProcPSSnapIn01,Microsoft";
           }
       }

       /// <summary>
       /// Description of this PowerShell snap-in.
       /// </summary>
       public override string Description
       {
           get
           {
               return "This is a PowerShell snap-in that includes the get-proc cmdlet.";
           }
       }
   }

   #endregion PowerShell snap-in
}

另请参阅

编写 Windows PowerShell Cmdlet