GetProcessSample03 示例
此示例演示如何实现检索本地计算机上的进程的 cmdlet。 它提供一个 Name 参数，该参数可以接受管道中的对象，也可以接受其属性名称与参数名称相同的对象的属性的值。 此 cmdlet 是 Windows PowerShell 2.0 提供的 Get-Process cmdlet 的简化版本。
如何使用 Visual Studio 生成示例
安装 Windows PowerShell 2.0 SDK 后，导航到 GetProcessSample03 文件夹。 默认位置为
C:\Program Files (x86)\Microsoft SDKs\Windows\v7.0\Samples\sysmgmt\WindowsPowerShell\csharp\GetProcessSample03。双击解决方案（.sln）文件的图标。 这将在 Visual Studio 中打开示例项目。
在 生成 菜单中，选择 “生成解决方案”，以在默认
\bin或\bin\debug文件夹中为示例生成库。
如何运行示例
创建以下模块文件夹：
[user]\Documents\WindowsPowerShell\Modules\GetProcessSample03将示例程序集复制到模块文件夹。
启动 Windows PowerShell。
运行以下命令将程序集加载到 Windows PowerShell 中：
Import-Module getprossessample03运行以下命令以运行 cmdlet：
Get-Proc
要求
此示例需要 Windows PowerShell 2.0。
演示
此示例演示了以下内容。
使用 Cmdlet 属性声明 cmdlet 类。
使用 Parameter 属性声明 cmdlet 参数。
指定参数的位置。
指定参数从管道获取输入。 输入可以从对象中获取，也可以从属性名称与参数名称相同的对象的属性获取值。
声明参数输入的验证属性。
示例
此示例演示 Get-Proc cmdlet 的实现，该 cmdlet 包含接受管道输入的 Name 参数。
namespace Microsoft.Samples.PowerShell.Commands
{
using System;
using System.Diagnostics;
using System.Management.Automation; // Windows PowerShell namespace
#region GetProcCommand
/// <summary>
/// This class implements the Get-Proc cmdlet.
/// </summary>
[Cmdlet(VerbsCommon.Get, "Proc")]
public class GetProcCommand : Cmdlet
{
#region Parameters
/// <summary>
/// The names of the processes retrieved by the cmdlet.
/// </summary>
private string[] processNames;
/// <summary>
/// Gets or sets the names of the
/// process that the cmdlet will retrieve.
/// </summary>
[Parameter(
Position = 0,
ValueFromPipeline = true,
ValueFromPipelineByPropertyName = true)]
[ValidateNotNullOrEmpty]
public string[] Name
{
get { return this.processNames; }
set { this.processNames = value; }
}
#endregion Parameters
#region Cmdlet Overrides
/// <summary>
/// The ProcessRecord method calls the Process.GetProcesses
/// method to retrieve the processes specified by the Name
/// parameter. Then, the WriteObject method writes the
/// associated processes to the pipeline.
/// </summary>
protected override void ProcessRecord()
{
// If no process names are passed to the cmdlet, get all
// processes.
if (this.processNames == null)
{
WriteObject(Process.GetProcesses(), true);
}
else
{
// If process names are passed to the cmdlet, get and write
// the associated processes.
foreach (string name in this.processNames)
{
WriteObject(Process.GetProcessesByName(name), true);
}
} // End if (processNames ...)
} // End ProcessRecord.
#endregion Overrides
} // End GetProcCommand.
#endregion GetProcCommand
}
