在 PowerShell 中调用 Azure CLI 创建资源时，若密码含 () 等特殊字符，会因 Shell 解析优先级导致命令失败；需通过嵌套引号（单引号包裹双引号）实现安全传递。
在 powershell 中调用 azure cli 创建资源时，若密码含 `()` 等特殊字符，会因 shell 解析优先级导致命令失败；需通过嵌套引号（单引号包裹双引号）实现安全传递。
在 Azure CLI 的 PowerShell 脚本中使用含圆括号（( 和 )）的密码（如 "Abcde12345()()"）时，常见错误如 () was unexpected at this time 或 Failed to load python executable，其根本原因并非 Azure CLI 本身限制，而是 PowerShell + Windows Command Prompt 双层 Shell 解析冲突：
- PowerShell 首先解析变量和字符串，将未加保护的
()视为子表达式（subexpression）或命令分组符号； - 随后 CLI 启动时经由
cmd.exe（Azure CLI Windows 安装版默认通过批处理包装器调用python.exe），()在 cmd 中具有语法意义（如if语句块、命令组合），导致解析中断。
✅ 正确解决方案：使用单引号包裹整个带双引号的密码值，即 ' "password_with_()" '。
该写法利用了 PowerShell 的字符串规则：单引号内内容完全字面量化（no interpolation, no escaping），内部双引号被原样保留，并最终作为完整参数值透传给底层 CLI 进程。
✅ 推荐写法（PowerShell）
$Group = @("--resource-group", "rg-shared")
$Name = @("--name", "servy")
$User = @("--admin-user", "BigCahoona")
$Pass = @("--admin-password", '"Abcde12345()()"') # 注意：外层单引号，内层双引号
az sql server create $Group $Name $User $Pass
或更清晰的展开式调用（支持换行续行）：
az sql server create ` --resource-group "rg-shared" ` --name "servy" ` --admin-user "BigCahoona" ` --admin-password '"Abcde12345()()"'
? 验证技巧：可在执行前用
Write-Host检查实际传入值：Write-Host "Password arg: $($Pass[1])"→ 输出：Password arg: "Abcde12345()()"
⚠️ 其他常见错误写法及说明
| 写法 | 是否有效 | 原因 |
|---|---|---|
"Abcde12345()()" |
❌ 失败 | PowerShell 尝试解析 ()，触发语法错误 |
'Abcde12345()()' |
❌ 失败（cmd 层报错） | 单引号在 cmd 中无特殊含义，() 直接暴露给 cmd 解析器 |
"Abcde12345()", ``"Abcde12345()`" `` |
❌ 不可靠 | PowerShell 转义复杂，且 cmd 层仍可能误判 |
--admin-password 'Abcde12345()()'（直接写在命令中） |
❌ Windows 下通常失败 | cmd.exe 不识别单引号为字符串边界 |
✅ 补充建议
- 若长期管理复杂密码，推荐使用 Azure Key Vault 存储并动态获取，避免明文出现在脚本中；
- 在 CI/CD（如 GitHub Actions、Azure DevOps）中，应结合
secrets机制 + 上述引号方案，防止日志泄露； - Linux/macOS 用户无需此技巧（bash/zsh 对
()处理更宽松），但统一使用' "pwd" '格式可提升跨平台兼容性。
通过精准控制 PowerShell 字符串字面量行为，即可安全、稳定地在 Azure CLI 中使用含圆括号及其他 shell 元字符（如 &, |, , <code>>）的强密码，无需妥协安全性或改用替代字符集。
