az repos policy

Note

此參考是 Azure CLI 的 azure-devops 延伸模組的一部分（2.30.0 版或更高版本）。 擴充功能會在您第一次執行 az repos policy 命令時自動安裝。 深入了解擴充功能。

管理分支原則。

命令

名稱	Description	類型	狀態
az repos policy approver-count	管理核准者計數原則。	Extension	GA
az repos policy approver-count create	建立核准者計數原則。	Extension	GA
az repos policy approver-count update	更新核准者計數原則。	Extension	GA
az repos policy build	管理建置原則。	Extension	GA
az repos policy build create	建立建置原則。	Extension	GA
az repos policy build update	更新組建原則。	Extension	GA
az repos policy case-enforcement	管理案例強制執行原則。	Extension	GA
az repos policy case-enforcement create	建立案例強制執行原則。	Extension	GA
az repos policy case-enforcement update	更新案例強制執行原則。	Extension	GA
az repos policy comment-required	管理批注所需的原則。	Extension	GA
az repos policy comment-required create	建立批注解析所需的原則。	Extension	GA
az repos policy comment-required update	更新批注解決所需的原則。	Extension	GA
az repos policy create	使用組態檔建立原則。	Extension	GA
az repos policy delete	刪除原則。	Extension	GA
az repos policy file-size	管理檔案大小原則。	Extension	GA
az repos policy file-size create	建立檔案大小原則。	Extension	GA
az repos policy file-size update	更新檔案大小原則。	Extension	GA
az repos policy list	列出專案中的所有原則。	Extension	GA
az repos policy merge-strategy	管理合併策略原則。	Extension	GA
az repos policy merge-strategy create	建立合併策略原則。	Extension	GA
az repos policy merge-strategy update	更新合併策略原則。	Extension	GA
az repos policy required-reviewer	管理必要的檢閱者原則。	Extension	GA
az repos policy required-reviewer create	建立必要的檢閱者原則。	Extension	GA
az repos policy required-reviewer update	更新必要的檢閱者原則。	Extension	GA
az repos policy show	顯示原則詳細數據。	Extension	GA
az repos policy update	使用組態檔更新原則。	Extension	GA
az repos policy work-item-linking	管理工作專案連結原則。	Extension	GA
az repos policy work-item-linking create	建立工作專案連結原則。	Extension	GA
az repos policy work-item-linking update	更新工作專案連結原則。	Extension	GA

az repos policy create

使用組態檔建立原則。

建議使用原則的多個範圍建立原則。 如需相關資訊，請參閱 https://aka.ms/azure-devops-cli-docs-policy-file 。

az repos policy create --config --policy-configuration
                       [--detect {false, true}]
                       [--org --organization]
                       [--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

項目的名稱或識別碼。 您可以使用 az devops configure -d project=NAME_OR_ID 來設定預設專案。 如果未設定為預設，或未透過 git config 自動取得，則為必要。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az repos policy delete

刪除原則。

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

必要參數

--id --policy-id

原則的標識碼。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--detect

自動偵測組織。

屬性	值
接受的值:	false, true

--org --organization

Azure DevOps 組織 URL。 您可以使用 az devops configure -d organization=ORG_URL 來設定預設組織。 如果未設定為預設，或透過 git 組態挑選，則為必要專案。範例：https://dev.azure.com/MyOrganizationName/。

--project -p

項目的名稱或識別碼。 您可以使用 az devops configure -d project=NAME_OR_ID 來設定預設專案。 如果未設定為預設，或未透過 git config 自動取得，則為必要。

--yes -y

請勿提示確認。

屬性	值
預設值:	False

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az repos policy list

列出專案中的所有原則。

az repos policy list [--branch]
                     [--detect {false, true}]
                     [--org --organization]
                     [--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

項目的名稱或識別碼。 您可以使用 az devops configure -d project=NAME_OR_ID 來設定預設專案。 如果未設定為預設，或未透過 git config 自動取得，則為必要。

--repository-id

儲存機制的標識碼，以完全符合存放庫標識碼來篩選結果。 例如 --repository-ID e556f204-53c9-4153-9cd9-ef41a11e3345。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az repos policy show

顯示原則詳細數據。

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

必要參數

--id --policy-id

原則的標識碼。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--detect

自動偵測組織。

屬性	值
接受的值:	false, true

--org --organization

Azure DevOps 組織 URL。 您可以使用 az devops configure -d organization=ORG_URL 來設定預設組織。 如果未設定為預設，或透過 git 組態挑選，則為必要專案。範例：https://dev.azure.com/MyOrganizationName/。

--project -p

項目的名稱或識別碼。 您可以使用 az devops configure -d project=NAME_OR_ID 來設定預設專案。 如果未設定為預設，或未透過 git config 自動取得，則為必要。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az repos policy update

使用組態檔更新原則。

建議使用原則的多個範圍建立原則。 如需相關資訊，請參閱 https://aka.ms/azure-devops-cli-docs-policy-file 。

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

必要參數

--config --policy-configuration

組態檔的本機檔案路徑。 輸入目錄路徑時，請使用 \backslash。

--id --policy-id

原則的標識碼。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--detect

自動偵測組織。

屬性	值
接受的值:	false, true

--org --organization

Azure DevOps 組織 URL。 您可以使用 az devops configure -d organization=ORG_URL 來設定預設組織。 如果未設定為預設，或透過 git 組態挑選，則為必要專案。範例：https://dev.azure.com/MyOrganizationName/。

--project -p

項目的名稱或識別碼。 您可以使用 az devops configure -d project=NAME_OR_ID 來設定預設專案。 如果未設定為預設，或未透過 git config 自動取得，則為必要。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False