你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az devops

Note

此参考是 Azure CLI 的 azure-devops 扩展的一部分（版本 2.30.0 或更高版本）。该扩展将在首次运行 az devops 命令时自动安装。了解更多关于扩展的信息。

管理Azure DevOps组织级别操作。

相关组 az pipelines： Manage Azure Pipelines az boards： Manage Azure Boards az repos： Manage Azure Repos az artifacts： Manage Azure Artifacts.

命令

名称	说明	类型	Status
az devops admin	管理管理作。	Extension	GA
az devops admin banner	管理组织横幅。	Extension	GA
az devops admin banner add	添加新横幅并立即显示它。	Extension	GA
az devops admin banner list	列出横幅。	Extension	GA
az devops admin banner remove	删除横幅。	Extension	GA
az devops admin banner show	显示横幅的详细信息。	Extension	GA
az devops admin banner update	更新横幅的消息、级别或到期日期。	Extension	GA
az devops configure	配置Azure DevOps CLI 或查看配置。	Extension	GA
az devops extension	管理扩展。	Extension	GA
az devops extension disable	禁用扩展。	Extension	GA
az devops extension enable	启用扩展。	Extension	GA
az devops extension install	安装扩展。	Extension	GA
az devops extension list	列出组织中安装的扩展。	Extension	GA
az devops extension search	从市场搜索扩展。	Extension	GA
az devops extension show	获取单个扩展的详细信息。	Extension	GA
az devops extension uninstall	卸载扩展。	Extension	GA
az devops invoke	此命令将调用任何 DevOps 区域和资源的请求。请仅使用 json 输出，因为此命令的响应未修复。有用的文档 - https://docs.microsoft.com/en-us/rest/api/azure/devops/。	Extension	GA
az devops login	将凭据（PAT）设置为用于特定组织。	Extension	GA
az devops logout	清除所有或特定组织的凭据。	Extension	GA
az devops migrations	管理企业实时迁移。	Extension	Preview
az devops migrations abandon	放弃迁移。	Extension	Preview
az devops migrations create	为存储库创建迁移。	Extension	Preview
az devops migrations cutover	管理迁移直接转换。	Extension	Preview
az devops migrations cutover approve	通过接受未处理的项和/或验证重新连接管道来批准直接转换。	Extension	Preview
az devops migrations cutover cancel	取消计划的直接转换。	Extension	Preview
az devops migrations cutover review	在直接转换之前查看未处理的迁移项。	Extension	Preview
az devops migrations cutover set	计划迁移的直接转换。	Extension	Preview
az devops migrations list	列出组织中的迁移。	Extension	Preview
az devops migrations pause	暂停活动迁移。	Extension	Preview
az devops migrations pipelines	管理迁移的管道重排。（预览版）。	Extension	Preview
az devops migrations pipelines delete	删除用于迁移的管道重新重排数据。（预览版）。	Extension	Preview
az devops migrations pipelines list	列出管道重新重排配置和每管道状态。	Extension	Preview
az devops migrations pipelines retry	重试失败的管道重新重排条目。（预览版）。	Extension	Preview
az devops migrations pipelines submit	提交用于重排的管道。（预览版）。	Extension	Preview
az devops migrations pipelines update	批量更新管道重新重排配置。（预览版）。	Extension	Preview
az devops migrations resume	恢复已停止的（已暂停、失败）迁移。	Extension	Preview
az devops migrations status	获取存储库的迁移状态。	Extension	Preview
az devops project	管理团队项目。	Extension	GA
az devops project create	创建团队项目。	Extension	GA
az devops project delete	删除团队项目。	Extension	GA
az devops project list	列出团队项目。	Extension	GA
az devops project show	显示团队项目。	Extension	GA
az devops security	管理与安全相关的作。	Extension	GA
az devops security group	管理安全组。	Extension	GA
az devops security group create	创建新的Azure DevOps组。	Extension	GA
az devops security group delete	删除Azure DevOps组。	Extension	GA
az devops security group list	列出项目或组织中的所有组。	Extension	GA
az devops security group membership	管理安全组的成员身份。	Extension	GA
az devops security group membership add	添加成员身份。	Extension	GA
az devops security group membership list	列出组或用户的成员身份。	Extension	GA
az devops security group membership remove	删除成员身份。	Extension	GA
az devops security group show	显示组详细信息。	Extension	GA
az devops security group update	更新Azure DevOps组的名称 AND/OR 说明。	Extension	GA
az devops security permission	管理安全权限。	Extension	GA
az devops security permission list	列出给定用户/组和命名空间的令牌。	Extension	GA
az devops security permission namespace	管理安全命名空间。	Extension	GA
az devops security permission namespace list	列出组织的所有可用命名空间。	Extension	GA
az devops security permission namespace show	显示每个命名空间中可用权限的详细信息。	Extension	GA
az devops security permission reset	重置给定权限位的权限。	Extension	GA
az devops security permission reset-all	清除用户/组此令牌的所有权限。	Extension	GA
az devops security permission show	显示给定令牌、命名空间和用户/组的权限。	Extension	GA
az devops security permission update	为给定的用户/组分配允许或拒绝权限。	Extension	GA
az devops service-endpoint	管理服务终结点/连接。	Extension	GA
az devops service-endpoint azurerm	管理Azure RM 服务终结点/连接。	Extension	GA
az devops service-endpoint azurerm create	创建Azure RM 类型服务终结点。	Extension	GA
az devops service-endpoint create	使用配置文件创建服务终结点。	Extension	GA
az devops service-endpoint delete	删除服务终结点。	Extension	GA
az devops service-endpoint github	管理GitHub服务终结点/连接。	Extension	GA
az devops service-endpoint github create	创建GitHub服务终结点。	Extension	GA
az devops service-endpoint list	列出项目中的服务终结点。	Extension	GA
az devops service-endpoint show	获取服务终结点的详细信息。	Extension	GA
az devops service-endpoint update	更新服务终结点。	Extension	GA
az devops team	管理团队。	Extension	GA
az devops team create	创建团队。	Extension	GA
az devops team delete	删除团队。	Extension	GA
az devops team list	列出项目中的所有团队。	Extension	GA
az devops team list-member	列出团队成员。	Extension	GA
az devops team show	显示团队详细信息。	Extension	GA
az devops team update	更新团队的名称和/或说明。	Extension	GA
az devops user	管理用户。	Extension	GA
az devops user add	添加用户。	Extension	GA
az devops user list	列出组织中的用户[除通过 AAD 组添加的用户除外]。	Extension	GA
az devops user remove	从组织中删除用户。	Extension	GA
az devops user show	显示用户详细信息。	Extension	GA
az devops user update	更新用户的许可证类型。	Extension	GA
az devops wiki	管理 Wiki。	Extension	GA
az devops wiki create	创建 Wiki。	Extension	GA
az devops wiki delete	删除 Wiki。	Extension	GA
az devops wiki list	列出项目或组织中的所有 Wiki。	Extension	GA
az devops wiki page	管理 Wiki 页面。	Extension	GA
az devops wiki page create	添加新页面。	Extension	GA
az devops wiki page delete	删除页面。	Extension	GA
az devops wiki page show	获取页面的内容或打开页面。	Extension	GA
az devops wiki page update	编辑页面。	Extension	GA
az devops wiki show	显示 Wiki 的详细信息。	Extension	GA

az devops configure

配置Azure DevOps CLI 或查看配置。

az devops configure [--acquire-policy-token]
                    [--change-reference]
                    [--defaults]
                    [--list]
                    [--use-git-aliases {false, true}]

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性	值
参数组:	Global Policy Arguments

--change-reference

此资源操作的相关更改引用 ID。

属性	值
参数组:	Global Policy Arguments

--defaults -d

常见参数默认值的空格分隔“name=value”对，例如“--defaults project=my-project-name organization=my-org-url arg=value”。使用“”清除默认值，例如 --defaults project='”。

--list -l

列出配置文件的内容。

属性	值
默认值:	False

--use-git-aliases

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

属性	值
接受的值:	false, true

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

属性	值
默认值:	False

az devops invoke

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

az devops invoke [--accept-media-type]
                 [--acquire-policy-token]
                 [--api-version]
                 [--area]
                 [--change-reference]
                 [--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 --organization]
                 [--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

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性	值
参数组:	Global Policy Arguments

--api-version

要面向的 API 的版本。

属性	值
默认值:	5.0

--area

要查找资源的区域。

--change-reference

此资源操作的相关更改引用 ID。

属性	值
参数组:	Global Policy Arguments

--detect

自动检测组织。

属性	值
接受的值:	false, true

--encoding

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

属性	值
默认值:	utf-8
接受的值:	ascii, utf-16be, utf-16le, utf-8

--http-method

指定用于请求的方法。

属性	值
默认值:	GET
接受的值:	DELETE, GET, HEAD, OPTIONS, PATCH, POST, PUT

--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

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

属性	值
默认值:	False

将凭据（PAT）设置为用于特定组织。

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

az devops login [--acquire-policy-token]
                [--change-reference]
                [--org --organization]

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性	值
参数组:	Global Policy Arguments

--change-reference

此资源操作的相关更改引用 ID。

属性	值
参数组:	Global Policy Arguments

--org --organization

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

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

属性	值
默认值:	False

az devops logout

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

az devops logout [--acquire-policy-token]
                 [--change-reference]
                 [--org --organization]

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性	值
参数组:	Global Policy Arguments

--change-reference

此资源操作的相关更改引用 ID。

属性	值
参数组:	Global Policy Arguments

--org --organization

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

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

属性	值
默认值:	False

反馈

此页面是否有帮助？