使用-File参数时PowerShell字符串数组参数无法正常工作

原因 #

通过powershell.exe -File调用脚本时，PowerShell命令行界面（CLI）的参数解析逻辑和交互式PowerShell环境存在差异：

• 交互式环境中，逗号分隔的参数值（如'arg1', 'arg2', 'arg3'）会被自动识别为数组，匹配脚本的数组类型参数。
• 但使用-File参数时，CLI会把整个逗号分隔的字符串当作单个参数值传递，脚本里期望数组类型的-requiresSystem参数接收到的是单个字符串，进而触发类型转换错误。

解决方法 #

方法1：修改调用命令（无需改动脚本） #

用-Command替代-File，让CLI将整个命令当作PowerShell代码解析，数组语法可正常生效：

powershell.exe -Command "& 'C:\路径\到\SnoozeGuard.ps1' -requiresSystem 'arg1', 'arg2', 'arg3'"

注意：脚本路径若包含空格，必须用引号包裹，并用&调用。

方法2：调整调用参数格式（配合脚本小修改） #

如果必须使用-File，可将数组元素作为独立参数传递，同时确保脚本参数支持接收多个值：

1. 调用命令：

powershell.exe -File 'C:\路径\到\SnoozeGuard.ps1' -requiresSystem 'arg1' 'arg2' 'arg3'

2. 脚本参数确认：
   检查脚本开头的param块，确保-requiresSystem参数类型为[string[]]（若原本已是该类型，则无需修改，直接用上述调用方式即可，因为[string[]]默认支持接收多个参数值）：

param(
    [string[]]$requiresSystem
)

方法3：脚本内兼容处理（适配两种调用方式） #

若希望脚本同时兼容交互式和-File调用，可在脚本开头添加逻辑，自动将单个逗号分隔的字符串转为数组：

param(
    [string[]]$requiresSystem
)

# 处理单个字符串转数组的情况
if ($requiresSystem.Count -eq 1 -and $requiresSystem[0] -match ',') {
    $requiresSystem = $requiresSystem[0] -split ',\s*'
}

这样即使通过-File传递-requiresSystem 'arg1, arg2, arg3'，脚本也能自动分割为数组。

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