az devops migrations cutover

  • プレビュー

Note

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

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

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

コマンド

Name 説明 型 状態
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 migrations cutover" はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

未処理の項目を受け入れるか、再配線されたパイプラインを確認して、カットオーバーを承認します。

カットオーバー レビューで未処理のアイテムが表示される場合は --accept-failure を提供し、カットオーバー レビュー レポートでPipelineVerificationAcknowledgment が必要な場合は --pipelines-verified: true を指定します。 2 つのうち少なくとも 1 つを指定する必要があります。両方とも 1 回の呼び出しで一緒に送信できます。

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

1 回の呼び出しで失敗の受け入れとパイプライン検証を組み合わせます。

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

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

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

--accept-failures

カットオーバーを続行する前に受け入れる未処理の移行リソースの数。

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

--pipelines-verified

再配線されたすべてのパイプラインが検証されたことを確認します。 "カットオーバー レビュー" が requiresPipelineVerificationAcknowledgment: true を返す場合に必須。 1 回の承認呼び出しで --accept-failures と組み合わせることができます。

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

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

--verbose

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

プロパティ 値
規定値: False

az devops migrations cutover cancel

プレビュー

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

スケジュールされたカットオーバーを取り消します。

az devops migrations cutover cancel [--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 cutover review

プレビュー

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

カットオーバーの前に、未処理の移行項目を確認します。

応答には requiresPipelineVerificationAcknowledgment が含まれます。 true の場合、移行を続行する前に、カットオーバー承認を --pipelines で再実行する必要があります。

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

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

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 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 cutover set

プレビュー

コマンド グループ "devops migrations cutover" はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: 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

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

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

--acquire-policy-token

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

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

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

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

カットオーバーの日付と時刻 (ISO 8601)。

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