如何在PowerShell中正确求值Azure DevOps模板Counter表达式

$[counter()] 是Azure DevOps流水线引擎的编译期内置表达式，仅能被YAML层的流水线引擎识别解析，不属于PowerShell的语法范畴。你直接将表达式写在内联PowerShell的脚本内容里时，流水线引擎不会深入解析脚本块内部的字符串，会把$[counter(xxx)]原样传给PowerShell进程，PowerShell无法识别这个指令，就会抛出你看到的报错。
另外你提到的参数传入无法完成求值的判断是对的：模板参数的求值时机在模板展开阶段，早于counter的本次构建计数递增时机，外部传参无法拿到当前构建对应的正确计数值。

counter表达式必须写在YAML的variables节点下，由流水线引擎在编译阶段完成求值，再通过流水线变量传入PowerShell脚本使用，修正后的模板代码如下：

parameters:
- name: major 
  type: string
  default: '1'
- name: minor 
  type: string
  default: '0'

steps: 
- task: PowerShell@2
  displayName: Set NuGet package version
  # 仅main分支构建时定义counter变量，避免无效构建占用计数
  ${{ if eq(variables['Build.SourceBranch'], 'refs/heads/main') }}:
    variables:
      # 用major+minor作为counter前缀，不同版本线独立计数，初始值为1
      revision: $[counter(format('{0}.{1}', parameters.major, parameters.minor), 1)]
  inputs:
    targetType: 'inline'
    script: |
      $isMain = ('$(Build.SourceBranch)' -eq 'refs/heads/main')
      $major = ${{ parameters.major }}
      $minor = ${{ parameters.minor }}

      if ($isMain) {
        # 直接引用引擎已经求值完成的revision变量即可
        $revision = '$(revision)'
        $packageVersion = "$major.$minor.$revision"
        Write-Host "Generated official package version: $packageVersion"
        # 如需后续任务使用版本号，可通过日志命令设置为流水线全局变量
        # Write-Host "##vso[task.setvariable variable=NuGetPackageVersion;isOutput=true]$packageVersion"
      } else {
        # 非main分支可自行配置预览版版本规则
        $previewRevision = $env:BUILD_BUILDID
        $packageVersion = "$major.$minor.$previewRevision-preview"
        Write-Host "Generated preview package version: $packageVersion"
      }

• counter的计数前缀必须是编译期可确定的固定值，使用模板参数拼接前缀完全符合要求，不同前缀的计数器会独立维护计数序列，比如1.0.x版本线计数到15时，切换到1.1.x版本线会从1重新开始计数，符合语义化版本规则。
• 不要尝试在PowerShell代码内部直接调用counter逻辑，该函数仅存在于流水线引擎解析层，PowerShell运行环境中没有对应实现。
• 你原脚本还存在变量名笔误：定义的变量是$revision1，输出时调用的是$revision，就算counter逻辑正常执行，这行输出也会拿到空值。
• counter只要被流水线引擎求值就会触发计数递增，如果仅需要在正式发布分支生成正式版本号，建议给counter变量加上分支判断，避免PR验证、本地测试触发的流水线占用计数序号。

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