PowerShell 5.1实现类似ConvertTo-SecureString的强制参数关联

仅靠[Parameter()]属性和参数集无法完全实现需求，必须结合函数内的代码校验。原因有两个：

• 参数集只能控制参数的存在与否，无法校验-Force的具体布尔值（比如阻止-Force:$false）
• 当参数集要求的参数缺失时，PowerShell默认会提示用户输入，而不是直接抛出异常，这和ConvertTo-SecureString的行为不符

完整实现方案 #

下面是一个示例函数，完全复刻ConvertTo-SecureString的参数约束逻辑：

function Test-SecureString {
    [CmdletBinding(DefaultParameterSetName = 'Default')]
    param(
        [Parameter(Mandatory, ParameterSetName = 'Default')]
        [string]$String,

        [Parameter(Mandatory, ParameterSetName = 'PlainTextWithForce')]
        [switch]$AsPlainText,

        [Parameter(Mandatory, ParameterSetName = 'PlainTextWithForce')]
        [switch]$Force
    )

    # 核心校验逻辑：当指定-AsPlainText时，必须确保-Force为$true
    if ($AsPlainText.IsPresent) {
        if (-not $Force.IsPresent -or $Force -eq $false) {
            throw "必须在使用 -AsPlainText 参数时指定 -Force 参数。"
        }
        Write-Host "已通过校验：使用-AsPlainText时指定了有效的-Force"
    } else {
        Write-Host "使用默认参数集处理字符串"
    }
}

验证效果 #

• 仅传-AsPlainText：直接抛出异常，不会提示输入

  Test-SecureString -AsPlainText "test"
  # 输出：必须在使用 -AsPlainText 参数时指定 -Force 参数。
  

• 传-AsPlainText -Force:$false：同样抛出异常

  Test-SecureString -AsPlainText "test" -Force:$false
  # 输出：必须在使用 -AsPlainText 参数时指定 -Force 参数。
  

• 传-AsPlainText -Force：正常执行

  Test-SecureString -AsPlainText "test" -Force
  # 输出：已通过校验：使用-AsPlainText时指定了有效的-Force
  

关键说明 #

1. 参数集的作用：确保-AsPlainText和-Force必须成对出现（如果其中一个被指定，另一个也必须被指定），但这只是基础约束
2. 函数内校验的作用：
   • 阻止-Force:$false这种无效传入
   • 当-AsPlainText被指定但-Force缺失时，直接抛出异常，替代PowerShell默认的输入提示行为

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