Azure Pipelines中如何在自定义任务内访问阶段变量？

一、无需显式传递的Stage变量访问方法 #

你遇到的$(environment)报错，是因为$(...)是Azure Pipelines的YAML模板替换语法，只会在YAML解析阶段生效，PowerShell脚本里直接写会被当成未定义的cmdlet。不用显式在env块传递的话，有两种直接访问的方式：

1. 直接访问自动注入的环境变量 #

Azure Pipelines会自动将Stage/Job/Pipeline级的变量转换为大写+下划线命名的环境变量注入到任务运行环境中。比如你定义的environment变量，会被转为ENVIRONMENT，在PowerShell脚本里直接用：

Write-Host "当前环境：$env:ENVIRONMENT"

就能拿到Production的值，不需要额外配置YAML。

2. 使用Azure DevOps任务SDK的Get-VstsTaskVariable #

关于Get-VstsTaskVariable的作用

这是Azure DevOps任务SDK提供的命令，专门用于从任务上下文读取所有层级（Stage/Job/Pipeline/任务输入等）的变量，支持严格校验变量是否存在。

使用方式

首先要确保你的自研任务脚本开头已经导入了任务SDK模块（一般自研任务会包含这个模块）：

Import-Module $PSScriptRoot\ps_modules\VstsTaskSdk -ErrorAction Stop

然后直接调用命令获取变量：

$environment = Get-VstsTaskVariable -Name 'environment' -Require
# -Require 参数表示如果变量不存在会抛出错误，不加则返回null
Write-Host "当前环境：$environment"

这种方式可以直接读取Stage级变量，无需显式传递。

二、其他访问Stage变量的方式 #

• 通过任务输入参数传递：在YAML里将变量作为任务输入参数传入，比如：

  - task: CustomTask_Powershell@1
    inputs:
      foo: bar
      environment: $(environment)
  

  然后在脚本里通过$env:INPUT_ENVIRONMENT访问（任务输入会自动转为INPUT_前缀的环境变量，大写+下划线格式）。
• 通过任务上下文对象直接读取：导入SDK后，也可以直接访问上下文变量集合：

  $environment = $VstsTaskContext.Variables['environment'].Value
  Write-Host "当前环境：$environment"
  

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