共用方式為


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 來取得完整偵錯記錄。