PowerShell中开关参数（SwitchParameter）是布尔型参数，不接收值，出现即为$true、不出现即为$false；定义时在param块中声明为[switch]类型，不可赋值或用[bool]替代。

powershell 中的开关参数（switchparameter）是一种布尔型参数，它不接收值，只通过是否出现在命令行中来控制“开启”或“关闭”。配置它不需要赋值，也不用写 -paramname $true，直接出现即为 $true，不出现即为 $false。

如何在函数或脚本中定义 SwitchParameter

在 param 块中声明时，只需指定类型为 [switch]，不加方括号里的默认值，也不加 [bool]：

function Test-Feature {
    [CmdletBinding()]
    param(
        [switch]$EnableLogging,
        [switch]$Force,
        [string]$Name
    )
    if ($EnableLogging) { Write-Host "日志已启用" }
    if ($Force) { Write-Host "强制模式开启" }
    Write-Host "名称: $Name"
}

调用示例：

Test-Feature -Name "demo"              # EnableLogging=$false, Force=$false
Test-Feature -EnableLogging -Name "a" # EnableLogging=$true, Force=$false
Test-Feature -Force -EnableLogging      # 两者都为 $true

注意事项和常见写法

• 开关参数不能接受 $true 或 $false 显式赋值（如 -EnableLogging:$true 是冗余写法，虽语法允许但不推荐）。
• 如果你确实需要支持显式布尔赋值（极少数场景），应改用 [bool] 类型参数，而非 [switch]。
• 在 #Requires 或模块依赖检查中，开关参数本身不参与版本/模块校验，但它可用来控制脚本行为分支。
• 使用 Get-Help 查看帮助时，开关参数会显示为 [-EnableLogging]，表示“存在即启用”。

在脚本文件（.ps1）中使用时的要点

若脚本顶部有 param() 块，同样适用：

直播间话术巡检-windows

直播话术巡检系统(Windows版) — 实时语音转写、关键词检测、场景自动切换、告警推送、大屏可视化。支持 Windows VB-Cable 虚拟声卡音频采集，阿里云 ASR 实时识别。一键启动脚本，自动安装环境。

下载

# deploy.ps1
param(
    [switch]$WhatIf,
    [switch]$Confirm,
    [string]$TargetPath
)

if ($WhatIf) { Write-Host "模拟执行：不会真正修改 $TargetPath" }
if ($Confirm) { $choice = Read-Host "确认操作？(y/n)" }

运行方式：

.\deploy.ps1 -TargetPath "C:\app" -WhatIf

不需要写 -WhatIf:$true —— 那样反而违背了开关参数的设计意图。