az devops migrations cutover

  • 預覽

備註

此參考文獻是該Azure CLIazure-devops擴充套件（版本 2.30.0 或更高版本）的一部分。 這個擴充功能會在你第一次執行 az devops 遷移切換 指令時自動安裝。 深入了解擴充功能。

指揮組的「DevOps 遷移」目前處於預覽階段並正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

管理遷移切換。

命令

名稱 Description 類型 狀態
az devops migrations cutover approve

透過接受未處理的項目和/或驗證重新接線的管線來批准切換。

 Extension Preview
az devops migrations cutover cancel

取消預定的切換。

 Extension Preview
az devops migrations cutover review

在切換前檢視未處理的遷移項目。

 Extension Preview
az devops migrations cutover set

安排遷移的切換時間。

 Extension Preview

az devops migrations cutover approve

預覽

指揮組「DevOps 遷移切換」目前處於預覽階段並開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

透過接受未處理的項目和/或驗證重新接線的管線來批准切換。

當切換審查發現未處理項目時，請提供 --accept-failure，及/或 pipelines-verified 當切換審查報告要求 PipelineVerificationAcknowledgment： true。 至少必須提供其中一種;兩者可以在同一通電話中同時發送。

az devops migrations cutover approve [--accept-failures]
                                     [--acquire-policy-token]
                                     [--change-reference]
                                     [--detect {false, true}]
                                     [--org --organization]
                                     [--pipelines-verified]
                                     [--repository-id]

範例

在審查失敗後批准切換。

az devops migrations cutover approve --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --accept-failures 3

只確認管線驗證（不處理未處理項目）。

az devops migrations cutover approve --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --pipelines-verified

將失敗接受與管線驗證合併於一通通話中。

az devops migrations cutover approve --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --accept-failures 3 --pipelines-verified

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--accept-failures

在切換前需要接受多少未處理的遷移資源。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy Arguments
--detect

自動偵測企業組織。

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

Azure DevOps 組織網址。 您可以使用 az devops configure -d organization=ORG_URL 來設定預設組織。 如果未設定為預設值，或未透過 git config 抓取，則為必要項目。範例：https://dev.azure.com/MyOrganizationName/。

--pipelines-verified

確認所有重新接線的管線都已驗證。 當「cutover review」returns需要PipelineVerificationAcknowledgment時，必須如此：正確。 可與 --accept-failure 合併於單一批准通話中。

屬性 值
預設值: False
--repository-id

Azure Repos 倉庫 （GUID） 的 ID。

全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az devops migrations cutover cancel

預覽

指揮組「DevOps 遷移切換」目前處於預覽階段並開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

取消預定的切換。

az devops migrations cutover cancel [--acquire-policy-token]
                                    [--change-reference]
                                    [--detect {false, true}]
                                    [--org --organization]
                                    [--repository-id]

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy Arguments
--detect

自動偵測企業組織。

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

Azure DevOps 組織網址。 您可以使用 az devops configure -d organization=ORG_URL 來設定預設組織。 如果未設定為預設值，或未透過 git config 抓取，則為必要項目。範例：https://dev.azure.com/MyOrganizationName/。

--repository-id

Azure Repos 倉庫 （GUID） 的 ID。

全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az devops migrations cutover review

預覽

指揮組「DevOps 遷移切換」目前處於預覽階段並開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

在切換前檢視未處理的遷移項目。

回覆內容包括 RequiresPipelineVerificationAcneledgment。 若屬實，切換批准必須以 --pipelines-verified 重新執行，遷移才能繼續。

az devops migrations cutover review [--acquire-policy-token]
                                    [--change-reference]
                                    [--detect {false, true}]
                                    [--org --organization]
                                    [--repository-id]

範例

在批准切換前先審查失敗案例。

az devops migrations cutover review --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy Arguments
--detect

自動偵測企業組織。

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

Azure DevOps 組織網址。 您可以使用 az devops configure -d organization=ORG_URL 來設定預設組織。 如果未設定為預設值，或未透過 git config 抓取，則為必要項目。範例：https://dev.azure.com/MyOrganizationName/。

--repository-id

Azure Repos 倉庫 （GUID） 的 ID。

全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az devops migrations cutover set

預覽

指揮組「DevOps 遷移切換」目前處於預覽階段並開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

安排遷移的切換時間。

az devops migrations cutover set [--acquire-policy-token]
                                 [--change-reference]
                                 [--date]
                                 [--detect {false, true}]
                                 [--org --organization]
                                 [--repository-id]

範例

行程切換。

az devops migrations cutover set --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --date 2030-12-31T11:59:00Z

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy Arguments
--date

切換的日期與時間（ISO 8601）。

--detect

自動偵測企業組織。

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

Azure DevOps 組織網址。 您可以使用 az devops configure -d organization=ORG_URL 來設定預設組織。 如果未設定為預設值，或未透過 git config 抓取，則為必要項目。範例：https://dev.azure.com/MyOrganizationName/。

--repository-id

Azure Repos 倉庫 （GUID） 的 ID。

全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False