az repos policy

注意

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

管理分支原則。

命令

名稱	Description	類型	狀態
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

專案的名稱或識別碼。 您可以使用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

原則的識別碼。

選擇性參數

--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 組態挑選，則為必要專案。

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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

專案的名稱或識別碼。 您可以使用 az devops configure -d project=NAME_OR_ID 來設定預設專案。 如果未設定為預設，或透過 git 組態挑選，則為必要專案。

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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

原則的識別碼。

選擇性參數

--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 組態挑選，則為必要專案。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

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

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

原則的識別碼。

選擇性參數

--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 組態挑選，則為必要專案。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。