PowerShell脚本通过[string[]]类型参数支持多格式服务器列表输入，包括数组、逗号字符串、文件读取及管道传递，并需校验、去空行、过滤注释，配合Invoke-Command并行部署且可集成Azure/Jenkins。
powershell 脚本在自动化部署中传递服务器列表，核心是把服务器名作为参数接收，并支持多种灵活输入方式：字符串数组、逗号分隔字符串、文件路径或从管道传入。关键不在“怎么传”，而在“怎么设计才可靠、易用、可维护”。
支持多格式输入的参数定义
在脚本开头用 param() 声明一个服务器参数，推荐使用 [string[]] 类型，它天然兼容以下所有场景：
- 直接传数组：
.\Deploy.ps1 -Servers "srv01", "srv02", "srv03" - 传逗号分隔字符串（自动拆分为数组）：
.\Deploy.ps1 -Servers "srv01,srv02,srv03" - 从变量传入：
$list = "srv01","srv02"; .\Deploy.ps1 -Servers $list - 从文件读取（先处理再传）：
$Servers = Get-Content servers.txt | ForEach-Object { $_.Trim() } | Where-Object { $_ }
从外部文件加载服务器列表
生产环境通常把服务器清单放在独立文件中，便于版本控制和权限管理。脚本内可这样安全加载：
Windows TTS (WSL2)
下载
在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。
- 检查文件是否存在且非空：
if (-not (Test-Path $ServerListFile)) { throw "服务器列表文件未找到: $ServerListFile" } - 按行读取、去空格、过滤空行和注释行：
Get-Content $ServerListFile | ForEach-Object { $_.Trim() } | Where-Object { $_ -and !$_.StartsWith('#') } - 支持 CSV 格式（含角色/环境字段）：
Import-Csv servers.csv | Where-Object { $_.Environment -eq 'prod' } | ForEach-Object { $_.Hostname }
配合远程执行批量调用
拿到服务器列表后，常用 Invoke-Command 并行部署。注意三点：
- 用 -ComputerName 直接传入整个数组，PowerShell 自动并行处理（默认最多32台）
- 加 -ThrottleLimit 控制并发数，避免目标服务器负载突增：
-ThrottleLimit 5 - 脚本块内避免硬编码路径，用 $using:xxx 引用本地变量，例如：
{ Copy-Item -Path $using:LocalPackage -Destination "C:\temp\" }
与 Azure 自动化或 Jenkins 集成时的传参
当脚本被上层平台调用时，参数传递方式略有不同：
- Azure 自动化 Runbook：在门户中配置输入参数为 Array 类型，启动时填入
["srv01","srv02"]；或用 JSON 字符串解析 - Jenkins PowerShell 步骤：在“执行 Windows 批处理命令”中拼接参数，例如：
powershell.exe -File .\Deploy.ps1 -Servers "%SERVER_LIST%"，其中%SERVER_LIST%是 Jenkins 参数化构建的字符串 - 为防特殊字符（如空格、逗号）出错，建议始终对服务器名做 .Trim() 和 ValidatePattern 校验，例如：
[ValidatePattern('^[a-zA-Z0-9\-_\.]+$')]
