正在尝试编写接受管道输入的powershell cmdlet

基础概念

PowerShell 是一种跨平台的任务自动化和配置管理框架，主要面向系统管理员和开发人员。它包含命令行界面（CLI）和脚本语言。Cmdlet（发音为 "command-let"）是 PowerShell 中的一种轻量级命令，用于执行特定的操作。

管道（Pipeline）是 PowerShell 的核心特性之一，允许将一个 Cmdlet 的输出作为另一个 Cmdlet 的输入。这种机制使得用户可以构建复杂的命令链，以实现数据处理的流水线化。

类型

Cmdlet 可以分为以下几类：

cmdlet：标准的 PowerShell 命令。
function：用户自定义的函数，类似于 Cmdlet。
script：包含多个 Cmdlet 或函数的脚本文件。

应用场景

系统管理：如文件管理、进程管理、注册表操作等。
自动化任务：如批量部署、日志分析、备份恢复等。
开发工具：如代码生成、测试脚本、持续集成等。

编写接受管道输入的 PowerShell Cmdlet

要编写一个接受管道输入的 Cmdlet，可以使用 System.Management.Automation.Cmdlet 类，并重写相应的方法。以下是一个简单的示例，展示如何编写一个接受管道输入的 Cmdlet：

using System;
using System.Management.Automation;

[Cmdlet(VerbsCommon.Get, "MyInputObject")]
public class GetMyInputObject : Cmdlet
{
    protected override void ProcessRecord()
    {
        // 获取管道输入
        foreach (PSObject inputObject in MyInvocation.ExpectingInput)
        {
            // 处理输入对象
            WriteObject(inputObject);
        }
    }
}

遇到的问题及解决方法

问题：为什么我的 Cmdlet 没有接收到管道输入？

原因：

输入对象类型不匹配：确保管道输入的对象类型与 Cmdlet 期望的类型匹配。
Cmdlet 标记不正确：确保 Cmdlet 使用了正确的 [Cmdlet] 属性标记。
管道输入为空：确保在调用 Cmdlet 之前，管道中有数据。

解决方法：

检查输入对象的类型，确保它们与 Cmdlet 期望的类型一致。
确保 Cmdlet 使用了正确的 [Cmdlet] 属性标记，并且 Verb 和 Noun 正确。
在调用 Cmdlet 之前，确保管道中有数据。可以使用 Write-Output 命令生成测试数据。

示例代码

以下是一个完整的示例，展示如何编写一个接受管道输入的 Cmdlet，并处理输入对象：

using System;
using System.Management.Automation;

[Cmdlet(VerbsCommon.Get, "MyInputObject")]
public class GetMyInputObject : Cmdlet
{
    protected override void ProcessRecord()
    {
        // 获取管道输入
        foreach (PSObject inputObject in MyInvocation.ExpectingInput)
        {
            // 处理输入对象
            WriteObject(inputObject);
        }
    }
}

// 注册 Cmdlet
if (PowerShell.Create().AddCommand("Get-MyInputObject").Invoke() is { } result)
{
    Console.WriteLine("Cmdlet executed successfully.");
}
else
{
    Console.WriteLine("Failed to execute Cmdlet.");
}