az devops migrations

  • プレビュー

注

このリファレンスは、Azure CLI (バージョン 2.30.0 以降) の azure-devops 拡張機能の一部です。 拡張機能は、 az devops migrations コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細については、 を参照してください。

このコマンド グループはプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

エンタープライズライブマイグレーションを管理します。

ELM 移行コマンド グループは、azure-devops 拡張機能の一部です。 詳細については、https://aka.ms/adoELM を参照してください。

コマンド

Name 説明 型 状態
az devops migrations abandon

移行を中止します。

 Extension Preview
az devops migrations create

リポジトリの移行を作成します。

 Extension Preview
az devops migrations cutover

移行のカットオーバーを管理します。

 Extension Preview
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 list

組織内の移行を一覧表示します。

 Extension Preview
az devops migrations pause

アクティブな移行を一時停止します。

 Extension Preview
az devops migrations pipelines

移行のためのパイプラインの再配線を管理します。 (プレビュー)。

 Extension Preview
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 resume

停止 (一時停止、失敗) 移行を再開します。

 Extension Preview
az devops migrations status

リポジトリの移行状態を取得します。

 Extension Preview

az devops migrations abandon

プレビュー

コマンド グループ "devops migrations" はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

移行を中止します。

移行を破棄/失敗状態に移動します。移行レコードは消去されません。 パイプラインの再配線データはそのまま残されるため、後続の移行で再利用できます。

az devops migrations abandon [--acquire-policy-token]
                             [--change-reference]
                             [--detect {false, true}]
                             [--org --organization]
                             [--remove-read-only]
                             [--repository-id]
                             [--yes]

例

リポジトリを破棄して読み取り専用のままにします (既定)。

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

リポジトリを破棄し、読み取り/書き込みに戻します。

az devops migrations abandon --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --remove-read-only

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--detect

組織を自動的に検出します。

プロパティ 値
指定可能な値: false, true
--org --organization

Azure DevOps 組織の URL。 az devops configure -d organization=ORG_URL を使用して、既定の組織を構成できます。 既定として構成されていない場合、または git 構成を使用して取得された場合は必須です。例: https://dev.azure.com/MyOrganizationName/。

--remove-read-only

また、removeReadOnly=true を送信して、Azure Repos リポジトリを読み取り/書き込み状態に戻します。

プロパティ 値
規定値: False
--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

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ 値
規定値: False

az devops migrations create

プレビュー

コマンド グループ "devops migrations" はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

リポジトリの移行を作成します。

GitHub認証では、デバイス フローが使用されます。CLI は、対話形式でサインインを完了するための URL と 1 回限りのコードを出力します。 GitHubトークンまたはサービス接続は必要ありません。

az devops migrations create [--acquire-policy-token]
                            [--agent-pool]
                            [--auto-discover --enable-auto-discover-pipelines]
                            [--change-reference]
                            [--cutover-date]
                            [--detect {false, true}]
                            [--enable-boards-gh --enable-boards-github-connection]
                            [--org --organization]
                            [--pipeline-sc-id --pipeline-service-connection-id]
                            [--repository-id]
                            [--skip-validation]
                            [--target-owner-user-id]
                            [--target-repository]
                            [--validate-only]

例

移行を作成します。

az devops migrations create --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --target-repository https://github.com/OrgName/RepoName --agent-pool <your-agent-pool>

検証のみの移行を作成します。

az devops migrations create --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --target-repository https://github.com/OrgName/RepoName --agent-pool <your-agent-pool> --validate-only --skip-validation ActivePullRequestCount,PullRequestDeltaSize

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--agent-pool

移行作業に使用するエージェント プール名。

--auto-discover --enable-auto-discover-pipelines

カットオーバー時に自動パイプライン検出にオプトインします。 既定ではオフです。 有効にすると、ELM 同期ジョブはソース リポジトリをウォークし、それを参照するすべてのパイプラインのクローン定義を作成します。 --pipeline-service-connection-id が必要です。検出を行わない場合は、no-op として実行され、0 個のパイプラインが登録されます。 パイプラインの再配線自体は、az devops 移行パイプラインの送信/更新を介して常に使用できます。

プロパティ 値
規定値: False
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--cutover-date

スケジュールされたカットオーバー日時 (ISO 8601)。

--detect

組織を自動的に検出します。

プロパティ 値
指定可能な値: false, true
--enable-boards-gh --enable-boards-github-connection

カットオーバー時にAzure Boards GitHub接続をプロビジョニングすることを選択します。 既定ではオフです。 移行を実行する前に、Azure Boards GitHub アプリをターゲット GitHub Enterprise 組織にインストールする必要があります。

プロパティ 値
規定値: False
--org --organization

Azure DevOps 組織の URL。 az devops configure -d organization=ORG_URL を使用して、既定の組織を構成できます。 既定として構成されていない場合、または git 構成を使用して取得された場合は必須です。例: https://dev.azure.com/MyOrganizationName/。

--pipeline-sc-id --pipeline-service-connection-id

パイプラインの再配線のために作成時にアタッチされたProjectスコープGitHubサービス接続 ID (GUID)。 --enable-auto-discover-pipelines と組み合わせた場合の完全な自動検出に必要です。手動モードでは省略可能です (接続を事前にアタッチして、後続のパイプラインが呼び出しを送信するには --pipeline-ids のみが必要です)。

--repository-id

Azure Repos リポジトリ (GUID) の ID。

--skip-validation

スキップする検証ポリシー。 ポリシー名のコンマ区切りのリスト (AgentPoolExists、MaxFileSize など) または負以外の整数ビットマスクを受け入れます。 サポートされているポリシー名 (大文字と小文字は区別されません): None、ActivePullRequestCount、PullRequestDeltaSize、AgentPoolExists、MaxFileSize、MaxPullRequestSize、MaxPushPackSize、MaxReferenceNameLength、TargetRepositoryDoesNotExist、SourceRepositoryContainsLfsObjects、SourceRepositoryNotReadOnly、BoardsGitHubConnectionProvisioning、All。

--target-owner-user-id

ターゲット リポジトリ所有者のユーザー ID。 サーバー側トークンベースの所有者解決が有効になっている場合、非推奨と無視されます。

--target-repository

ターゲット リポジトリの URL ( http:// または https:// で始まる必要があります)。

--validate-only

検証専用モードで作成します (移行前チェックのみ)。

プロパティ 値
規定値: 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

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ 値
規定値: False

az devops migrations list

プレビュー

コマンド グループ "devops migrations" はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

組織内の移行を一覧表示します。

既定では、状態に関係なく、リポジトリごとの最新の移行が返されます。 --include-all を使用して、完全な移行履歴を返します。

az devops migrations list [--detect {false, true}]
                          [--include-all]
                          [--include-inactive]
                          [--org --organization]
                          [--project]

例

リポジトリごとの最新の移行を一覧表示します。

az devops migrations list --org https://dev.azure.com/myorg

すべてのリポジトリの完全な移行履歴を一覧表示します。

az devops migrations list --org https://dev.azure.com/myorg --include-all

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--detect

組織を自動的に検出します。

プロパティ 値
指定可能な値: false, true
--include-all

完全な移行履歴 (リポジトリごとのすべてのレコード) を返します。 既定では、状態に関係なく、リポジトリごとの最新の移行のみが返されます。

プロパティ 値
規定値: False
--include-inactive
非推奨

オプション '--include-inactive' は非推奨となり、今後のリリースで削除される予定です。 代わりに '--include-all' を使用してください。

Deprecated. 代わりに --include-all を使用してください。

プロパティ 値
規定値: False
--org --organization

Azure DevOps 組織の URL。 az devops configure -d organization=ORG_URL を使用して、既定の組織を構成できます。 既定として構成されていない場合、または git 構成を使用して取得された場合は必須です。例: https://dev.azure.com/MyOrganizationName/。

--project

移行をフィルター処理するための省略可能なプロジェクト名または 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

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ 値
規定値: False

az devops migrations pause

プレビュー

コマンド グループ "devops migrations" はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

アクティブな移行を一時停止します。

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

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--detect

組織を自動的に検出します。

プロパティ 値
指定可能な値: false, true
--org --organization

Azure DevOps 組織の URL。 az devops configure -d organization=ORG_URL を使用して、既定の組織を構成できます。 既定として構成されていない場合、または git 構成を使用して取得された場合は必須です。例: 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

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ 値
規定値: False

az devops migrations resume

プレビュー

コマンド グループ "devops migrations" はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

停止 (一時停止、失敗) 移行を再開します。

az devops migrations resume [--acquire-policy-token]
                            [--change-reference]
                            [--detect {false, true}]
                            [--migration]
                            [--org --organization]
                            [--repository-id]
                            [--validate-only]

例

現在のモードを使用して再開します。

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

検証専用モードで再開します。

az devops migrations resume --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --validate-only

移行を続行します (検証専用モードをクリアします)。

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

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--detect

組織を自動的に検出します。

プロパティ 値
指定可能な値: false, true
--migration

検証のみの成功した移行を完全な移行に昇格させます (validateOnly=false と statusRequested=active を設定します)。

プロパティ 値
規定値: False
--org --organization

Azure DevOps 組織の URL。 az devops configure -d organization=ORG_URL を使用して、既定の組織を構成できます。 既定として構成されていない場合、または git 構成を使用して取得された場合は必須です。例: https://dev.azure.com/MyOrganizationName/。

--repository-id

Azure Repos リポジトリ (GUID) の ID。

--validate-only

検証専用モードで再開します。

プロパティ 値
規定値: 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

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ 値
規定値: False

az devops migrations status

プレビュー

コマンド グループ "devops migrations" はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

リポジトリの移行状態を取得します。

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

例

リポジトリ ID で移行状態を取得します。

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

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--detect

組織を自動的に検出します。

プロパティ 値
指定可能な値: false, true
--org --organization

Azure DevOps 組織の URL。 az devops configure -d organization=ORG_URL を使用して、既定の組織を構成できます。 既定として構成されていない場合、または git 構成を使用して取得された場合は必須です。例: 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

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ 値
規定値: False