共用方式為

az repos policy merge-strategy

  • 參考

備註

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

管理合併策略原則。

命令

名稱 Description 類型 狀態
az repos policy merge-strategy create

建立合併策略原則。

 擴充套件 GA
az repos policy merge-strategy update

更新合併策略原則。

 擴充套件 GA

az repos policy merge-strategy create

建立合併策略原則。

az repos policy merge-strategy create --blocking {false, true}
                                      --branch
                                      --enabled {false, true}
                                      --repository-id
                                      [--allow-no-fast-forward {false, true}]
                                      [--allow-rebase {false, true}]
                                      [--allow-rebase-merge {false, true}]
                                      [--allow-squash {false, true}]
                                      [--branch-match-type {exact, prefix}]
                                      [--detect {false, true}]
                                      [--org]
                                      [--project]

必要參數

--blocking

原則是否應該封鎖。

接受的值: false, true
--branch

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

--enabled

是否啟用原則。

接受的值: false, true
--repository-id

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

選擇性參數

--allow-no-fast-forward

基本合併 （無快速向前） - 保留非線性歷史，就像在開發期間發生一樣。

接受的值: false, true
--allow-rebase

重新基底和快速轉寄 - 藉由重新執行來源分支認可至目標而建立線性歷程記錄，而不需要合併認可。

接受的值: false, true
--allow-rebase-merge

使用合併認可重新基底 - 將來源分支認可重新執行至目標，然後建立合併認可，以建立半線性歷程記錄。

接受的值: false, true
--allow-squash

Squash 合併 - 藉由將來源分支認可壓縮成目標分支上的單一新認可，以建立線性歷程記錄。

接受的值: false, true
--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/。

--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 merge-strategy update

更新合併策略原則。

az repos policy merge-strategy update --id
                                      [--allow-no-fast-forward {false, true}]
                                      [--allow-rebase {false, true}]
                                      [--allow-rebase-merge {false, true}]
                                      [--allow-squash {false, true}]
                                      [--blocking {false, true}]
                                      [--branch]
                                      [--branch-match-type {exact, prefix}]
                                      [--detect {false, true}]
                                      [--enabled {false, true}]
                                      [--org]
                                      [--project]
                                      [--repository-id]

必要參數

--id --policy-id

原則的標識碼。

選擇性參數

--allow-no-fast-forward

基本合併 （無快速向前） - 保留非線性歷史，就像在開發期間發生一樣。

接受的值: false, true
--allow-rebase

重新基底和快速轉寄 - 藉由重新執行來源分支認可至目標而建立線性歷程記錄，而不需要合併認可。

接受的值: false, true
--allow-rebase-merge

使用合併認可重新基底 - 將來源分支認可重新執行至目標，然後建立合併認可，以建立半線性歷程記錄。

接受的值: false, true
--allow-squash

Squash 合併 - 藉由將來源分支認可壓縮成目標分支上的單一新認可，以建立線性歷程記錄。

接受的值: false, true
--blocking

原則是否應該封鎖。

接受的值: false, true
--branch

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

--branch-match-type

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

接受的值: exact, prefix
--detect

自動偵測組織。

接受的值: false, true
--enabled

是否啟用原則。

接受的值: 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

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

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