如何在Azure的PowerShell任务中从环境变量访问通用服务连接密钥

步骤1：在PowerShell任务中映射服务连接密钥到环境变量 #

打开Pipeline编辑页面，找到目标PowerShell任务，进入配置界面：

• 定位到环境变量区域，添加自定义变量（比如DOWNTIME_API_KEY）
• 变量值填写：$(DowntimeApiKeyGen.Password)

  规则说明：服务连接名称 + .Password，对应你存储API密钥的'Password/Token Key'字段

步骤2：在PowerShell脚本中读取环境变量 #

PowerShell中通过$env:前缀访问环境变量，示例脚本：

# 读取API密钥
$apiKey = $env:DOWNTIME_API_KEY

# 验证读取结果（可选，仅用于测试，避免明文输出完整密钥）
Write-Host "API Key 前4位掩码展示: $($apiKey.Substring(0,4))***"

常见问题排查 #

• 服务连接权限：确保Pipeline已授权使用该服务连接，且代理阶段有权限访问服务连接资源
• 名称拼写：检查服务连接名称DowntimeApiKeyGen是否完全匹配（区分大小写）
• 语法规则：禁止在脚本中直接写$(DowntimeApiKeyGen.Password)，必须通过任务环境变量映射后再读取，代理环境无法直接解析这种管道语法

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