共用方式為

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

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

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