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

az repos policy

注意

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

管理分支策略。

命令

名称	说明	类型	状态
az repos policy approver-count	管理批准者计数策略。	扩展	GA
az repos policy approver-count create	创建审批者计数策略。	分机	GA
az repos policy approver-count update	更新审批者计数策略。	扩展	GA
az repos policy build	管理生成策略。	扩展	GA
az repos policy build create	创建生成策略。	分机	GA
az repos policy build update	更新生成策略。	分机	GA
az repos policy case-enforcement	管理案例强制策略。	分机	GA
az repos policy case-enforcement create	创建案例强制策略。	扩展	GA
az repos policy case-enforcement update	更新案例强制策略。	分机	GA
az repos policy comment-required	管理注释所需的策略。	分机	GA
az repos policy comment-required create	创建注释解析所需的策略。	分机	GA
az repos policy comment-required update	更新注释解析所需的策略。	分机	GA
az repos policy create	使用配置文件创建策略。	分机	GA
az repos policy delete	删除策略。	分机	GA
az repos policy file-size	管理文件大小策略。	扩展	GA
az repos policy file-size create	创建文件大小策略。	分机	GA
az repos policy file-size update	更新文件大小策略。	扩展	GA
az repos policy list	列出项目中的所有策略。	分机	GA
az repos policy merge-strategy	管理合并策略。	分机	GA
az repos policy merge-strategy create	创建合并策略。	分机	GA
az repos policy merge-strategy update	更新合并策略。	扩展	GA
az repos policy required-reviewer	管理所需的审阅者策略。	扩展	GA
az repos policy required-reviewer create	创建所需的审阅者策略。	分机	GA
az repos policy required-reviewer update	更新所需的审阅者策略。	扩展	GA
az repos policy show	显示策略详细信息。	分机	GA
az repos policy update	使用配置文件更新策略。	扩展	GA
az repos policy work-item-linking	管理工作项链接策略。	扩展	GA
az repos policy work-item-linking create	创建工作项链接策略。	分机	GA
az repos policy work-item-linking update	更新工作项链接策略。	分机	GA

az repos policy create

使用配置文件创建策略。

建议使用策略的多个范围创建策略。 有关详细信息，请参阅https://aka.ms/azure-devops-cli-docs-policy-file。

az repos policy create --config
                       [--detect {false, true}]
                       [--org]
                       [--project]

必需参数

--config --policy-configuration

配置文件的本地文件路径。 键入目录路径时，请使用 \backslash。

可选参数

--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 repos policy delete

删除策略。

az repos policy delete --id
                       [--detect {false, true}]
                       [--org]
                       [--project]
                       [--yes]

必需参数

--id --policy-id

策略的 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 配置进行选取，则为必需。

--yes -y

不提示确认。

默认值: 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 repos policy list

列出项目中的所有策略。

az repos policy list [--branch]
                     [--detect {false, true}]
                     [--org]
                     [--project]
                     [--repository-id]

可选参数

--branch

按分支名称完全匹配筛选结果的分支名称。 使用分支筛选器需要 --repository-id 参数。 例如：--branch master。

--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 配置进行选取，则为必需。

--repository-id

要根据存储库 ID 的完全匹配筛选结果的存储库 ID。 例如 --repository-ID e556f204-53c9-4153-9cd9-ef41a11e3345。

全局参数

--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 repos policy show

显示策略详细信息。

az repos policy show --id
                     [--detect {false, true}]
                     [--org]
                     [--project]

必需参数

--id --policy-id

策略的 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 repos policy update

使用配置文件更新策略。

建议使用策略的多个范围创建策略。 有关详细信息，请参阅https://aka.ms/azure-devops-cli-docs-policy-file。

az repos policy update --config
                       --id
                       [--detect {false, true}]
                       [--org]
                       [--project]

必需参数

--config --policy-configuration

配置文件的本地文件路径。 键入目录路径时，请使用 \backslash。

--id --policy-id

策略的 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 获取完整的调试日志。