Azure Pipeline中PowerShell脚本调用Invoke-RestMethod报错排查与解决

问题背景 #

在Azure Pipeline中配置PowerShell任务，目标是从指定API获取产品版本号，并用该版本号更新指定meta文件，主机名存储在Azure变量EndpointQA中。初始脚本在本地Windows PowerShell可正常运行，但在Pipeline执行时出现报错。

初始脚本及第一个错误 #

初始脚本内容：

- task: PowerShell@2
  displayName: 'Update meta file with latest product version'
  inputs:
     targetType: 'inline'
     script: |
       $url = "$(EndpointQA)/api/status"
       $status = Invoke-RestMethod -Uri $url
       ((Get-Content -path "$(Build.SourcesDirectory)/SitecorePackages/Import/Data/meta" -Raw) -replace '{product_version}', $status.product_version) | Set-Content -Path $(Build.SourcesDirectory)/SitecorePackages/Import/Data/meta

Pipeline执行时触发错误：

Invalid URI: The hostname could not be parsed.

第一次修改及新错误 #

给Azure变量添加括号（格式改为$($EndpointQA)）后，URI解析问题得到解决，但出现新错误：

The term 'status.product_version' is not recognized as a name of a cmdlet, function, script file, or executable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.

最终解决方法 #

移除原生PowerShell变量的多余括号，保持Azure变量的正确引用格式，同时正常调用PowerShell本地变量属性。最终可正常运行的脚本：

- task: PowerShell@2
  displayName: 'Update meta file with latest product version'
  inputs:
     targetType: 'inline'
     script: |
       $url = "$($EndpointQA)/api/status"
       $status = Invoke-RestMethod -Uri $url
       ((Get-Content -path "$(Build.SourcesDirectory)/SitecorePackages/Import/Data/meta" -Raw) -replace '{product_version}', $status.product_version) | Set-Content -Path "$(Build.SourcesDirectory)/SitecorePackages/Import/Data/meta"

关键注意点 #

• Azure Pipeline变量在PowerShell字符串中引用时，需使用$($变量名)格式，确保变量被正确解析，避免直接使用$(变量名)导致的URI解析异常。
• PowerShell本地变量（如$status）调用属性时，直接使用$status.product_version即可，不要额外添加括号，否则会被错误解析为命令而非属性访问。

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