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

az devops

Note

This reference is part of the azure-devops extension for the Azure CLI (version 2.30.0 or higher). The extension will automatically install the first time you run an az devops command. Learn more about extensions.

管理 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	List banners.	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	Manage extensions.	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 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	Add membership.	Extension	GA
az devops security group membership list	列出组或用户的成员身份。	Extension	GA
az devops security group membership remove	Remove membership.	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	Manage teams.	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	Manage users.	Extension	GA
az devops user add	Add user.	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	Manage wikis.	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 [--defaults]
                    [--list]
                    [--use-git-aliases {false, true}]

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Output format.

属性	值
默认值:	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]
                 [--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 --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

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--accept-media-type

指定响应的内容类型。

属性	值
默认值:	application/json

--api-version

要面向的 API 的版本。

属性	值
默认值:	5.0

--area

要查找资源的区域。

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

Output format.

属性	值
默认值:	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 [--org --organization]

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--org --organization

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

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	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 [--org --organization]

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--org --organization

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

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	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

命令

az devops configure

可选参数

az devops invoke

示例

可选参数

az devops login

可选参数

az devops logout

可选参数

反馈