共用方式為

az repos policy required-reviewer

  • 參考

備註

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

管理必要的檢閱者原則。

命令

名稱 Description 類型 狀態
az repos policy required-reviewer create

建立必要的檢閱者原則。

 擴充套件 GA
az repos policy required-reviewer update

更新必要的檢閱者原則。

 擴充套件 GA

az repos policy required-reviewer create

建立必要的檢閱者原則。

az repos policy required-reviewer create --blocking {false, true}
                                         --branch
                                         --enabled {false, true}
                                         --message
                                         --repository-id
                                         --required-reviewer-ids
                                         [--branch-match-type {exact, prefix}]
                                         [--detect {false, true}]
                                         [--org]
                                         [--path-filter]
                                         [--project]

必要參數

--blocking

原則是否應該封鎖。

接受的值: false, true
--branch

應套用此原則的分支。 例如：master。

--enabled

是否啟用原則。

接受的值: false, true
--message

訊息。

--repository-id

要套用原則之存放庫的標識碼。

--required-reviewer-ids

以 『;』 分隔的必要檢閱者電子郵件位址。 例如：john@contoso.com;alice@contoso.com。

選擇性參數

--branch-match-type

決定如何使用分支自變數來套用原則。 如果值為 'exact'，原則將會套用至在 --branch 自變數上完全相符的分支上。 如果值為 'prefix'，原則會套用至符合 --branch 自變數所提供前置詞的所有分支資料夾。

接受的值: exact, prefix
預設值: exact
--detect

自動偵測組織。

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

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

--path-filter

套用原則的篩選路徑。 支援以 『;』 分隔的絕對路徑、通配符和多個路徑。 範例：/WebApp/Models/Data.cs、/WebApp/* 或 *.cs、/WebApp/Models/Data.cs;ClientApp/Models/Data.cs。

--project -p

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

全域參數
--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 required-reviewer update

更新必要的檢閱者原則。

az repos policy required-reviewer update --id
                                         [--blocking {false, true}]
                                         [--branch]
                                         [--branch-match-type {exact, prefix}]
                                         [--detect {false, true}]
                                         [--enabled {false, true}]
                                         [--message]
                                         [--org]
                                         [--path-filter]
                                         [--project]
                                         [--repository-id]
                                         [--required-reviewer-ids]

必要參數

--id --policy-id

原則的標識碼。

選擇性參數

--blocking

原則是否應該封鎖。

接受的值: false, true
--branch

應套用此原則的分支。 例如：master。

--branch-match-type

決定如何使用分支自變數來套用原則。 如果值為 'exact'，原則將會套用至在 --branch 自變數上完全相符的分支上。 如果值為 'prefix'，原則會套用至符合 --branch 自變數所提供前置詞的所有分支資料夾。

接受的值: exact, prefix
--detect

自動偵測組織。

接受的值: false, true
--enabled

是否啟用原則。

接受的值: false, true
--message

訊息。

--org --organization

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

--path-filter

套用原則的篩選路徑。 支援以 『;』 分隔的絕對路徑、通配符和多個路徑。 範例：/WebApp/Models/Data.cs、/WebApp/* 或 *.cs、/WebApp/Models/Data.cs;ClientApp/Models/Data.cs。

--project -p

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

--repository-id

要套用原則之存放庫的標識碼。

--required-reviewer-ids

以 『;』 分隔的必要檢閱者電子郵件位址。 例如：john@contoso.com;alice@contoso.com。

全域參數
--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。