如何为自定义可执行文件配置PowerShell动态参数自动补全

你遇到的问题核心是：Register-ArgumentCompleter对外部可执行文件使用带路径的命令名（如.example.exe）不生效，且脚本块未正确处理补全上下文参数。以下是两种基础实现方案：

方案1：直接给可执行文件注册补全（需exe在PATH或当前目录） #

使用不带路径的可执行文件名作为-CommandName值，同时脚本块需处理补全上下文：

Register-ArgumentCompleter -CommandName example.exe -ParameterName Name -ScriptBlock {
    param($wordToComplete, $commandAst, $cursorPosition)
    # 筛选匹配当前输入前缀的候选值
    'foo', 'bar' | Where-Object { $_ -like "$wordToComplete*" }
}

使用方式：执行example.exe -Name f后按TAB，会自动补全为foo；输入example.exe -Name b按TAB则补全为bar。

方案2：通过包装函数实现补全（适合指定路径的exe） #

如果需要固定使用.\example.exe这类带路径的调用方式，可先定义包装函数，再给函数注册补全：

# 定义包装外部exe的函数
function Invoke-Example {
    param(
        [Parameter()]
        [string]$Name
    )
    .\example.exe -Name $Name
}

# 为函数的Name参数注册补全
Register-ArgumentCompleter -CommandName Invoke-Example -ParameterName Name -ScriptBlock {
    param($wordToComplete, $commandAst, $cursorPosition)
    'foo', 'bar' | Where-Object { $_ -like "$wordToComplete*" }
}

使用方式：执行Invoke-Example -Name 后按TAB，即可看到foo和bar的补全提示。

注意事项 #

• 脚本块必须接收$wordToComplete、$commandAst、$cursorPosition三个参数，PowerShell会自动传入当前补全的上下文信息。
• 若要让补全规则永久生效，可将注册命令添加到PowerShell配置文件（执行notepad $PROFILE打开配置文件，粘贴命令后保存）。

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