你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
az devops
注意
此参考是 Azure CLI(版本 2.30.0 或更高版本)的 azure-devops 扩展的一部分。 该扩展将在首次运行 az devops 命令时自动安装。 详细了解扩展。
管理 Azure DevOps 组织级别操作。
相关组 az pipelines: Manage Azure Pipelines az boards: Manage Azure Boards az repos: Manage Azure Repos az artifacts: Manage Azure Artifacts.
命令
az devops configure
配置 Azure DevOps CLI 或查看配置。
az devops configure [--defaults]
[--list]
[--use-git-aliases {false, true}]
可选参数
公共参数默认值的空格分隔“name=value”对,例如“--defaults project=my-project-name organization=https://dev.azure.com/organizationName arg=value”。 使用“”清除默认值,例如 --defaults project='”。
列出配置文件的内容。
设置为“true”以配置 Git 别名全局 git 配置文件(若要启用“git pr 列表”等命令)。 设置为“false”以删除工具设置的任何别名。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az devops feedback
此命令已弃用,将在将来的版本中删除。 请改用“az feedback”。
显示有关如何向 Azure DevOps CLI 团队提供反馈的信息。
az devops feedback
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az devops invoke
此命令将调用任何 DevOps 区域和资源的请求。 请仅使用 json 输出,因为此命令的响应未修复。 有用的文档 - https://docs.microsoft.com/en-us/rest/api/azure/devops/.
az devops invoke [--accept-media-type]
[--api-version]
[--area]
[--detect {false, true}]
[--encoding {ascii, utf-16be, utf-16le, utf-8}]
[--http-method {DELETE, GET, HEAD, OPTIONS, PATCH, POST, PUT}]
[--in-file]
[--media-type]
[--org]
[--out-file]
[--query-parameters]
[--resource]
[--route-parameters]
示例
发现与“Wiki”相关的区域
az devops invoke --query "[?contains(area,'wiki')]"
获取项目中的所有 Wiki
az devops invoke --area wiki --resource wikis --route-parameters project={Project Name} -o json
az devops invoke --area wiki --resource wikis --route-parameters project=WikiIssue -o json
向 Wiki 添加页面
az devops invoke --area wiki --resource pages --route-parameters project={Project Name}
wikiIdentifier={Wiki Id} --in-file {Full File Path containing text to add to wiki}
--query-parameters path={Page Path In Wiki} --http-method PUT --api-version 5.1-preview -o json
az devops invoke --area wiki --resource pages --route-parameters project=WikiIssue
wikiIdentifier=e479f402-2be8-4953-bb0b-3a0209cbc2d2 --in-file D:/temp/createWikiRequestBody.txt
--encoding 'utf-8' --query-parameters path=sample738 --http-method PUT --api-version 5.1-preview -o json
可选参数
指定响应的内容类型。
要面向的 API 的版本。
要查找资源的区域。
自动检测组织。
输入文件的编码。 与 --in-file 结合使用。
指定用于请求的方法。
包含请求内容的文件的路径和文件名。
指定请求的内容类型。
Azure DevOps 组织 URL。 可以使用 az devops configure -d organization=ORG_URL 配置默认组织。 如果未配置为默认或未通过 git 配置选取,则为必需。示例:https://dev.azure.com/MyOrganizationName/。
此函数保存响应正文的文件的路径和文件名。
指定查询参数的列表。
要操作的资源的名称。
指定路由参数的列表。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az devops login
将凭据 (PAT) 设置为用于特定组织。
请参阅 https://aka.ms/azure-devops-cli-auth 有关提供 PAT 作为输入的详细信息。
az devops login [--org]
可选参数
Azure DevOps 组织 URL。 示例:https://dev.azure.com/MyOrganizationName。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az devops logout
清除所有或特定组织的凭据。
az devops logout [--org]
可选参数
Azure DevOps 组织 URL。 示例:https://dev.azure.com/MyOrganizationName/。 如果未指定任何组织,则会注销所有组织。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。