如何让自定义PowerShell函数的Name参数实现命令名自动补全？

在PowerShell 7.4中，你可以通过参数补全属性或注册参数补全器两种方式，让自定义函数的Name参数实现和Get-Command一致的命令/函数名Tab补全效果，覆盖已加载和未加载的命令。

方法1：内嵌参数补全逻辑（推荐） #

直接在函数的Name参数上添加[ArgumentCompleter()]属性，将补全逻辑内嵌到函数定义中，无需额外注册操作：

# 建议改名避免覆盖内置Get-Help命令
Function Get-MyHelp {
    Param(
        [Parameter()]
        [ArgumentCompleter({
            # 补全逻辑脚本块，自动接收三个参数
            param($wordToComplete, $commandAst, $cursorPosition)
            # 获取所有匹配输入前缀的命令，包含未加载模块中的命令
            Get-Command "$wordToComplete*" -All | Select-Object -ExpandProperty Name | Sort-Object
        })]
        $Name
    )

    # 此处编写你的自定义帮助逻辑
    if ($Name) {
        Write-Host "显示 $Name 的自定义帮助内容..."
        # 示例：根据Name查询你的自有帮助资源
    } else {
        Write-Host "请指定要查询的命令/函数名称"
    }
}

关键逻辑说明： #

• [ArgumentCompleter()]：PowerShell 5.1+支持的属性，专为单个参数定义补全逻辑
• $wordToComplete：用户当前输入的部分字符串，用于匹配命令名前缀
• Get-Command "$wordToComplete*" -All：-All参数会返回所有可用命令（包括未加载模块中的命令），和Get-Command自身的Tab补全逻辑完全一致
• Sort-Object：对补全结果按字母排序，提升用户体验

方法2：注册全局参数补全器 #

如果你的函数已经存在（不想修改原函数定义），可以使用Register-ArgumentCompleter命令为其参数注册补全逻辑：

# 为已存在的Get-Help函数的Name参数注册补全器
Register-ArgumentCompleter -CommandName Get-Help -ParameterName Name -ScriptBlock {
    param($wordToComplete, $commandAst, $cursorPosition)
    Get-Command "$wordToComplete*" -All | Select-Object -ExpandProperty Name | Sort-Object
}

注意事项： #

• 内置的Get-Help命令本身已有补全逻辑，自定义同名函数会覆盖原命令，建议给你的自定义函数换个名称（比如Get-MyHelp）避免冲突
• 两种方法都能实现目标效果，输入Get-MyHelp -Name 后按Tab键，即可看到所有匹配的命令/函数名

内容的提问来源于stack exchange，提问作者Ralf_Reddings