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

az boards area team

注意

此参考是 Azure CLI(版本 2.30.0 或更高版本)的 azure-devops 扩展的一部分。 该扩展将在首次运行 az boards 区域团队 命令时自动安装。 详细了解扩展。

管理团队的区域。

命令

名称 说明 类型 状态
az boards area team add

向团队添加区域。

分机 GA
az boards area team list

列出团队的区域。

分机 GA
az boards area team remove

从团队中删除区域。

分机 GA
az boards area team update

更新团队区域。

分机 GA

az boards area team add

向团队添加区域。

每个团队都需要配置一个不能为空的默认区域。 因此,需要在将第一个区域添加到团队时传递 --set-as-default。 稍后可以使用命令配置已添加到 az boards area team update -h 团队的任何其他区域。

az boards area team add --path
                        --team
                        [--detect {false, true}]
                        [--include-sub-areas {false, true}]
                        [--org]
                        [--project]
                        [--set-as-default]

示例

向团队添加区域。

az boards area team add --team 'ContosoTeam' --path '\ContosoProject\MyProjectAreaName'

必需参数

--path

区域路径。 示例:\ProjectName\AreaName。

--team

团队的名称或 ID。

可选参数

--detect

自动检测组织。

接受的值: false, true
--include-sub-areas

包括此区域的子节点。

接受的值: false, true
--org --organization

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

--project -p

项目的名称或 ID。 可以使用 az devops configure -d project=NAME_OR_ID 配置默认项目。 如果未配置为默认或通过 git 配置进行选取,则为必需。

--set-as-default

将此区域路径设置为此团队的默认区域。 默认值:False。

默认值: False
全局参数
--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 boards area team list

列出团队的区域。

az boards area team list --team
                         [--detect {false, true}]
                         [--org]
                         [--project]

必需参数

--team

团队的名称或 ID。

可选参数

--detect

自动检测组织。

接受的值: false, true
--org --organization

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

--project -p

项目的名称或 ID。 可以使用 az devops configure -d project=NAME_OR_ID 配置默认项目。 如果未配置为默认或通过 git 配置进行选取,则为必需。

全局参数
--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 boards area team remove

从团队中删除区域。

az boards area team remove --path
                           --team
                           [--detect {false, true}]
                           [--org]
                           [--project]

必需参数

--path

区域路径。 示例:\ProjectName\AreaName。

--team

团队的名称或 ID。

可选参数

--detect

自动检测组织。

接受的值: false, true
--org --organization

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

--project -p

项目的名称或 ID。 可以使用 az devops configure -d project=NAME_OR_ID 配置默认项目。 如果未配置为默认或通过 git 配置进行选取,则为必需。

全局参数
--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 boards area team update

更新团队区域。

更新任何区域以包含/排除子区域或已添加区域设置为默认值。

az boards area team update --path
                           --team
                           [--detect {false, true}]
                           [--include-sub-areas {false, true}]
                           [--org]
                           [--project]
                           [--set-as-default]

必需参数

--path

区域路径。 示例:\ProjectName\AreaName。

--team

团队的名称或 ID。

可选参数

--detect

自动检测组织。

接受的值: false, true
--include-sub-areas

包括此区域的子节点。

接受的值: false, true
--org --organization

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

--project -p

项目的名称或 ID。 可以使用 az devops configure -d project=NAME_OR_ID 配置默认项目。 如果未配置为默认或通过 git 配置进行选取,则为必需。

--set-as-default

设置为默认团队区域路径。 默认值:False。

默认值: False
全局参数
--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 获取完整的调试日志。