az devops migrations cutover

  • Preview

Note

This reference is part of the azure-devops extension for the Azure CLI (version 2.30.0 or higher). The extension will automatically install the first time you run an az devops migrations cutover command. Learn more about extensions.

Command group 'devops migrations' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Manage migration cutover.

Commands

Name Description Type Status
az devops migrations cutover approve

Approve cutover by accepting unprocessed items and/or verifying rewired pipelines.

 Extension Preview
az devops migrations cutover cancel

Cancel a scheduled cutover.

 Extension Preview
az devops migrations cutover review

Review unprocessed migration items before cutover.

 Extension Preview
az devops migrations cutover set

Schedule cutover for a migration.

 Extension Preview

az devops migrations cutover approve

Preview

Command group 'devops migrations cutover' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Approve cutover by accepting unprocessed items and/or verifying rewired pipelines.

Provide --accept-failures when cutover review surfaces unprocessed items, and/or --pipelines-verified when cutover review reports requiresPipelineVerificationAcknowledgment: true. At least one of the two must be supplied; both may be sent together in a single call.

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

Examples

Approve cutover after reviewing failures.

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

Acknowledge pipeline verification only (no unprocessed items).

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

Combine failure acceptance and pipeline verification in one call.

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

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--accept-failures

Number of unprocessed migration resources to accept before proceeding with cutover.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--detect

Automatically detect organization.

Property Value
Accepted values: false, true
--org --organization

Azure DevOps organization URL. You can configure the default organization using az devops configure -d organization=ORG_URL. Required if not configured as default or picked up via git config. Example: https://dev.azure.com/MyOrganizationName/.

--pipelines-verified

Acknowledge that all rewired pipelines have been verified. Required when "cutover review" returns requiresPipelineVerificationAcknowledgment: true. Can be combined with --accept-failures in a single approve call.

Property Value
Default value: False
--repository-id

ID of the Azure Repos repository (GUID).

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property Value
Default value: False

az devops migrations cutover cancel

Preview

Command group 'devops migrations cutover' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Cancel a scheduled cutover.

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

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--detect

Automatically detect organization.

Property Value
Accepted values: false, true
--org --organization

Azure DevOps organization URL. You can configure the default organization using az devops configure -d organization=ORG_URL. Required if not configured as default or picked up via git config. Example: https://dev.azure.com/MyOrganizationName/.

--repository-id

ID of the Azure Repos repository (GUID).

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property Value
Default value: False

az devops migrations cutover review

Preview

Command group 'devops migrations cutover' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Review unprocessed migration items before cutover.

The response includes requiresPipelineVerificationAcknowledgment. When true, cutover approve must be re-run with --pipelines-verified before the migration can proceed.

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

Examples

Review failures before approving cutover.

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

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--detect

Automatically detect organization.

Property Value
Accepted values: false, true
--org --organization

Azure DevOps organization URL. You can configure the default organization using az devops configure -d organization=ORG_URL. Required if not configured as default or picked up via git config. Example: https://dev.azure.com/MyOrganizationName/.

--repository-id

ID of the Azure Repos repository (GUID).

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property Value
Default value: False

az devops migrations cutover set

Preview

Command group 'devops migrations cutover' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Schedule cutover for a migration.

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

Examples

Schedule cutover.

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

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--date

The date and time for cutover (ISO 8601).

--detect

Automatically detect organization.

Property Value
Accepted values: false, true
--org --organization

Azure DevOps organization URL. You can configure the default organization using az devops configure -d organization=ORG_URL. Required if not configured as default or picked up via git config. Example: https://dev.azure.com/MyOrganizationName/.

--repository-id

ID of the Azure Repos repository (GUID).

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property Value
Default value: False