如何将本地执行的Azure DevOps Wiki更新命令整合到Azure Pipelines中

推荐直接使用PowerShell任务实现，和你本地测试的运行环境一致，不需要额外适配语法，踩坑更少。

前置配置 #

• 给Pipeline服务账号开通对应Wiki的贡献者权限：进入DevOps项目设置 -> 管道 -> 服务账户，找到当前Pipeline对应的构建服务账号，添加Wiki权限即可
• 开启Pipeline脚本访问OAuth令牌权限：下述YAML示例中通过env传递SYSTEM_ACCESSTOKEN即可满足要求，不需要额外配置单独的服务连接

完整YAML示例（PowerShell版本） #

trigger:
- main # 替换为你的实际触发分支

pool:
  vmImage: 'windows-latest' # 也可以使用ubuntu-latest + pwsh实现跨平台运行

steps:
- task: PowerShell@2
  inputs:
    targetType: 'inline'
    script: |
      # 安装/升级az devops扩展，避免agent缺失扩展报错
      az extension add --name azure-devops --upgrade
      # 配置默认组织和项目，直接使用Pipeline内置变量，不需要硬编码
      az devops configure --defaults organization=$(System.CollectionUri) project=$(System.TeamProject)
      # 获取当前Wiki页面的eTag
      $etagVar = (az devops wiki page show --path '/MyWiki/HelloWorld' --wiki [MyWiki_wiki] --query eTag -o tsv)
      # 更新Wiki页面（已修正你原命令中wiki参数缺失右方括号的笔误）
      az devops wiki page update --path '/MyWiki/HelloWorld' --wiki [MyWiki_wiki] --content "Yessssss, it worked !!!" --version $etagVar
  env:
    SYSTEM_ACCESSTOKEN: $(System.AccessToken) # 传递Pipeline访问令牌，无需手动登录az cli

Bash版本实现（如果你需要用Linux环境） #

之前Bash运行失败大概率是变量语法、权限或者转义问题，以下是可直接运行的示例：

pool:
  vmImage: 'ubuntu-latest'

steps:
- task: Bash@3
  inputs:
    targetType: 'inline'
    script: |
      az extension add --name azure-devops --upgrade
      az devops configure --defaults organization=$SYSTEM_COLLECTIONURI project=$SYSTEM_TEAMPROJECT
      # Bash变量赋值不需要在变量名前加$，不需要括号包裹命令
      etagVar=$(az devops wiki page show --path '/MyWiki/HelloWorld' --wiki [MyWiki_wiki] --query eTag -o tsv)
      az devops wiki page update --path '/MyWiki/HelloWorld' --wiki [MyWiki_wiki] --content "Yessssss, it worked !!!" --version $etagVar
  env:
    SYSTEM_ACCESSTOKEN: $(System.AccessToken)

其他注意事项 #

• 如果你的Wiki是组织级别的，需要去掉命令中的--project参数，调整对应路径规则
• Wiki页面路径大小写敏感，需要和实际路径完全匹配
• 如果更新的内容较长或者包含特殊字符，建议把内容存到文本文件中，使用--content @yourfile.txt的方式传入，避免转义错误

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