az devops migrations pipelines

預覽

Note

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

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

管理遷移時的管線重配。（預覽）。

命令

名稱	Description	類型	狀態
az devops migrations pipelines delete	刪除管線重新接線的資料以進行遷移。（預覽）。	Extension	Preview
az devops migrations pipelines list	列出管線重新接線的配置及各管線狀態。	Extension	Preview
az devops migrations pipelines retry	重試，管線重新布線失敗。（預覽）。	Extension	Preview
az devops migrations pipelines submit	提交管線重新接線。（預覽）。	Extension	Preview
az devops migrations pipelines update	批量更新管線重新配線設定。（預覽）。	Extension	Preview

az devops migrations pipelines delete

預覽

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

刪除管線重新接線的資料以進行遷移。（預覽）。

az devops migrations pipelines delete [--acquire-policy-token]
                                      [--change-reference]
                                      [--detect {false, true}]
                                      [--migration-id]
                                      [--org --organization]
                                      [--repository-id]
                                      [--yes]

範例

刪除重新接線的設定和克隆的定義。

az devops migrations pipelines delete --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --migration-id 7 --yes

選擇性參數

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

--acquire-policy-token

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

屬性	值
參數群組:	Global Policy Arguments

--change-reference

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

屬性	值
參數群組:	Global Policy Arguments

--detect

自動偵測企業組織。

屬性	值
接受的值:	false, true

--migration-id

遷移 ID 用於管線重新配線清理。

--org --organization

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

--repository-id

Azure Repos 倉庫（GUID）的 ID。

--yes -y

不提示確認。

屬性	值
預設值:	False

全域參數

--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 pipelines list

預覽

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

列出管線重新接線的配置及各管線狀態。

az devops migrations pipelines list [--detect {false, true}]
                                    [--org --organization]
                                    [--repository-id]

範例

列出管線重新配線狀態。

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

選擇性參數

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

--detect

自動偵測企業組織。

屬性	值
接受的值:	false, true

--org --organization

--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 pipelines retry

預覽

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

重試，管線重新布線失敗。（預覽）。

az devops migrations pipelines retry [--acquire-policy-token]
                                     [--change-reference]
                                     [--detect {false, true}]
                                     [--org --organization]
                                     [--pipeline-ids]
                                     [--repository-id]

範例

重試特定的失敗管線。

az devops migrations pipelines retry --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --pipeline-ids 42 43

選擇性參數

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

--acquire-policy-token

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

屬性	值
參數群組:	Global Policy Arguments

--change-reference

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

屬性	值
參數群組:	Global Policy Arguments

--detect

自動偵測企業組織。

屬性	值
接受的值:	false, true

--org --organization

--pipeline-ids

要重新嘗試的管線定義 ID。接受空格分隔或逗號分隔的值。

--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 pipelines submit

預覽

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

提交管線重新接線。（預覽）。

az devops migrations pipelines submit [--acquire-policy-token]
                                      [--change-reference]
                                      [--detect {false, true}]
                                      [--org --organization]
                                      [--pipeline-ids]
                                      [--repository-id]
                                      [--repository-mapping]
                                      [--service-connection-id]

範例

提交包含服務連線與儲存庫映射的管線。

az devops migrations pipelines submit --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --pipeline-ids 42 43 44 --service-connection-id 11111111-1111-1111-1111-111111111111 --repository-mapping aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa=myorg/shared-templates

選擇性參數

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

--acquire-policy-token

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

屬性	值
參數群組:	Global Policy Arguments

--change-reference

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

屬性	值
參數群組:	Global Policy Arguments

--detect

自動偵測企業組織。

屬性	值
接受的值:	false, true

--org --organization

--pipeline-ids

管線定義ID。接受空格分隔值（例如 42 43 44）或逗號分隔值（例如 42,43,44）。

--repository-id

Azure Repos 倉庫（GUID）的 ID。

--repository-mapping

格式為 <sourceRepoId>=<targetOwner>/<targetRepo>的儲存庫映射。可以多次提供。

--service-connection-id

Project 範圍的 GitHub 服務連線 ID （GUID）。若連線已透過遷移連接，則可選擇建立 --pipeline-service-connection-id 或 pipelines update --service-connection-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 pipelines update

預覽

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

批量更新管線重新配線設定。（預覽）。

az devops migrations pipelines update [--acquire-policy-token]
                                      [--add-ids]
                                      [--change-reference]
                                      [--detect {false, true}]
                                      [--org --organization]
                                      [--remove-ids]
                                      [--repository-id]
                                      [--repository-mapping]
                                      [--retry-ids]
                                      [--service-connection-id]

範例

新增、移除及更新服務連線。

az devops migrations pipelines update --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --add-ids 50 51 --remove-ids 42 --service-connection-id 22222222-2222-2222-2222-222222222222

選擇性參數

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

--acquire-policy-token

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

屬性	值
參數群組:	Global Policy Arguments

--add-ids

新增管線 ID。接受空格分隔或逗號分隔的值。

--change-reference

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

屬性	值
參數群組:	Global Policy Arguments

--detect

自動偵測企業組織。

屬性	值
接受的值:	false, true

--org --organization

--remove-ids

需移除管線 ID。接受空格分隔或逗號分隔的值。

--repository-id

Azure Repos 倉庫（GUID）的 ID。

--repository-mapping

格式為 <sourceRepoId>=<targetOwner>/<targetRepo>的儲存庫映射。可以多次提供。

--retry-ids

無法重試管線 ID。接受空格分隔或逗號分隔的值。

--service-connection-id

Project 範圍的 GitHub 服務連線 ID （GUID）。

全域參數

--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

意見反應

此頁面對您有幫助嗎？