如何在PowerShell脚本中实现带交互式提示的必选参数？

需求说明 #

希望脚本同时支持两种运行模式：

• 手动直接运行时，弹出交互式选择提示（如Press 1 for Option blah）让用户选择操作
• 熟悉脚本后，可通过CLI直接指定参数调用（如.\myscript.ps1 -Option 1）

此前已通过ChoiceDescription数组实现纯交互式选择，现在要结合参数实现双模式兼容。

解决方案 #

核心是将参数设为可选参数，若用户未传入参数则自动触发交互式选择流程，最终统一处理选中的选项。

完整代码示例 #

# 定义可选参数：接受1-4的整数，不强制用户输入
param(
    [Parameter(Mandatory=$false)]
    [ValidateRange(1,4)]
    [int]$Option
)

# 未传入参数时，启动交互式选择
if (-not $PSBoundParameters.ContainsKey('Option')) {
    # 构建选项列表（可替换为你之前的动态生成逻辑）
    $options = @(
        [System.Management.Automation.Host.ChoiceDescription]::new('&1. Option blah', '执行选项blah的操作'),
        [System.Management.Automation.Host.ChoiceDescription]::new('&2. Option bleh', '执行选项bleh的操作'),
        [System.Management.Automation.Host.ChoiceDescription]::new('&3. Option blih', '执行选项blih的操作'),
        [System.Management.Automation.Host.ChoiceDescription]::new('&4. Option bloh', '执行选项bloh的操作')
    )

    $title = '选择操作选项'
    $message = '请按对应数字选择，hover 可查看选项描述'
    # 获取用户选择的索引（从0开始），转换为1-4的数字
    $selectedIndex = $host.ui.PromptForChoice($title, $message, $options, 0)
    $Option = $selectedIndex + 1
}

# 根据选择结果执行对应逻辑
switch ($Option) {
    1 { Write-Host "执行 Option blah 的操作" }
    2 { Write-Host "执行 Option bleh 的操作" }
    3 { Write-Host "执行 Option blih 的操作" }
    4 { Write-Host "执行 Option bloh 的操作" }
}

关键说明 #

1. 参数设计：将-Option设为非必选参数，配合ValidateRange限制输入范围，避免无效值
2. 交互式触发：通过$PSBoundParameters.ContainsKey('Option')判断用户是否传入参数，未传入则启动选择流程
3. 索引转换：PromptForChoice返回选项数组的索引（从0开始），需+1转换为和参数一致的1-4数字
4. 动态选项兼容：示例中静态定义的$options可直接替换为你之前的动态生成逻辑（遍历variablearray生成ChoiceDescription）

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