你当前正在访问 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 admin

管理管理操作。

分机 GA
az devops admin banner

管理组织横幅。

分机 GA
az devops admin banner add

添加新横幅并立即显示它。

扩展 GA
az devops admin banner list

列出横幅。

扩展 GA
az devops admin banner remove

删除横幅。

分机 GA
az devops admin banner show

显示横幅的详细信息。

分机 GA
az devops admin banner update

更新横幅的消息、级别或到期日期。

分机 GA
az devops configure

配置 Azure DevOps CLI 或查看配置。

扩展 GA
az devops extension

管理扩展。

扩展 GA
az devops extension disable

禁用扩展。

分机 GA
az devops extension enable

启用扩展。

扩展 GA
az devops extension install

安装扩展。

扩展 GA
az devops extension list

列出组织中安装的扩展。

分机 GA
az devops extension search

从市场搜索扩展。

分机 GA
az devops extension show

获取单个扩展的详细信息。

分机 GA
az devops extension uninstall

卸载扩展。

扩展 GA
az devops feedback

显示有关如何向 Azure DevOps CLI 团队提供反馈的信息。

分机 已放弃
az devops invoke

此命令将调用任何 DevOps 区域和资源的请求。 请仅使用 json 输出,因为此命令的响应未修复。 有用的文档 - https://docs.microsoft.com/en-us/rest/api/azure/devops/.

扩展 GA
az devops login

将凭据 (PAT) 设置为用于特定组织。

分机 GA
az devops logout

清除所有或特定组织的凭据。

分机 GA
az devops project

管理团队项目。

扩展 GA
az devops project create

创建团队项目。

扩展 GA
az devops project delete

删除团队项目。

分机 GA
az devops project list

列出团队项目。

扩展 GA
az devops project show

显示团队项目。

分机 GA
az devops security

管理与安全相关的操作。

扩展 GA
az devops security group

管理安全组。

扩展 GA
az devops security group create

创建新的 Azure DevOps 组。

分机 GA
az devops security group delete

删除 Azure DevOps 组。

分机 GA
az devops security group list

列出项目或组织中的所有组。

分机 GA
az devops security group membership

管理安全组的成员身份。

分机 GA
az devops security group membership add

添加成员身份。

分机 GA
az devops security group membership list

列出组或用户的成员身份。

分机 GA
az devops security group membership remove

删除成员身份。

分机 GA
az devops security group show

显示组详细信息。

分机 GA
az devops security group update

更新 Azure DevOps 组的名称 AND/OR 说明。

扩展 GA
az devops security permission

管理安全权限。

分机 GA
az devops security permission list

列出给定用户/组和命名空间的令牌。

分机 GA
az devops security permission namespace

管理安全命名空间。

扩展 GA
az devops security permission namespace list

列出组织的所有可用命名空间。

分机 GA
az devops security permission namespace show

显示每个命名空间中可用权限的详细信息。

分机 GA
az devops security permission reset

重置给定权限位的权限。

分机 GA
az devops security permission reset-all

清除用户/组此令牌的所有权限。

分机 GA
az devops security permission show

显示给定令牌、命名空间和用户/组的权限。

分机 GA
az devops security permission update

为给定的用户/组分配允许或拒绝权限。

扩展 GA
az devops service-endpoint

管理服务终结点/连接。

分机 GA
az devops service-endpoint azurerm

管理 Azure RM 服务终结点/连接。

分机 GA
az devops service-endpoint azurerm create

创建 Azure RM 类型服务终结点。

扩展 GA
az devops service-endpoint create

使用配置文件创建服务终结点。

扩展 GA
az devops service-endpoint delete

删除服务终结点。

扩展 GA
az devops service-endpoint github

管理 GitHub 服务终结点/连接。

分机 GA
az devops service-endpoint github create

创建 GitHub 服务终结点。

分机 GA
az devops service-endpoint list

列出项目中的服务终结点。

分机 GA
az devops service-endpoint show

获取服务终结点的详细信息。

扩展 GA
az devops service-endpoint update

更新服务终结点。

分机 GA
az devops team

管理团队。

分机 GA
az devops team create

创建团队。

扩展 GA
az devops team delete

删除团队。

分机 GA
az devops team list

列出项目中的所有团队。

分机 GA
az devops team list-member

列出团队成员。

分机 GA
az devops team show

显示团队详细信息。

分机 GA
az devops team update

更新团队的名称和/或说明。

扩展 GA
az devops user

管理用户。

分机 GA
az devops user add

Add user.

扩展 GA
az devops user list

列出组织中的用户[除通过 AAD 组添加的用户除外]。

扩展 GA
az devops user remove

从组织中删除用户。

扩展 GA
az devops user show

显示用户详细信息。

分机 GA
az devops user update

更新用户的许可证类型。

分机 GA
az devops wiki

管理 Wiki。

分机 GA
az devops wiki create

创建 Wiki。

分机 GA
az devops wiki delete

删除 Wiki。

扩展 GA
az devops wiki list

列出项目或组织中的所有 Wiki。

扩展 GA
az devops wiki page

管理 Wiki 页面。

分机 GA
az devops wiki page create

添加新页面。

分机 GA
az devops wiki page delete

删除页面。

分机 GA
az devops wiki page show

获取页面的内容或打开页面。

分机 GA
az devops wiki page update

编辑 页面。

扩展 GA
az devops wiki show

显示 Wiki 的详细信息。

扩展 GA

az devops configure

配置 Azure DevOps CLI 或查看配置。

az devops configure [--defaults]
                    [--list]
                    [--use-git-aliases {false, true}]

可选参数

--defaults -d

公共参数默认值的空格分隔“name=value”对,例如“--defaults project=my-project-name organization=https://dev.azure.com/organizationName arg=value”。 使用“”清除默认值,例如 --defaults project='”。

--list -l

列出配置文件的内容。

默认值: False
--use-git-aliases

设置为“true”以配置 Git 别名全局 git 配置文件(若要启用“git pr 列表”等命令)。 设置为“false”以删除工具设置的任何别名。

接受的值: false, true
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az devops feedback

已放弃

此命令已弃用,将在将来的版本中删除。 请改用“az feedback”。

显示有关如何向 Azure DevOps CLI 团队提供反馈的信息。

az devops feedback
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --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

可选参数

--accept-media-type

指定响应的内容类型。

默认值: application/json
--api-version

要面向的 API 的版本。

默认值: 5.0
--area

要查找资源的区域。

--detect

自动检测组织。

接受的值: false, true
--encoding

输入文件的编码。 与 --in-file 结合使用。

接受的值: ascii, utf-16be, utf-16le, utf-8
默认值: utf-8
--http-method

指定用于请求的方法。

接受的值: DELETE, GET, HEAD, OPTIONS, PATCH, POST, PUT
默认值: GET
--in-file

包含请求内容的文件的路径和文件名。

--media-type

指定请求的内容类型。

默认值: application/json
--org --organization

Azure DevOps 组织 URL。 可以使用 az devops configure -d organization=ORG_URL 配置默认组织。 如果未配置为默认或未通过 git 配置选取,则为必需。示例:https://dev.azure.com/MyOrganizationName/

--out-file

此函数保存响应正文的文件的路径和文件名。

--query-parameters

指定查询参数的列表。

--resource

要操作的资源的名称。

--route-parameters

指定路由参数的列表。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az devops login

将凭据 (PAT) 设置为用于特定组织。

请参阅 https://aka.ms/azure-devops-cli-auth 有关提供 PAT 作为输入的详细信息。

az devops login [--org]

可选参数

--org --organization

Azure DevOps 组织 URL。 示例:https://dev.azure.com/MyOrganizationName

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az devops logout

清除所有或特定组织的凭据。

az devops logout [--org]

可选参数

--org --organization

Azure DevOps 组织 URL。 示例:https://dev.azure.com/MyOrganizationName/。 如果未指定任何组织,则会注销所有组织。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。