az devops migrations pipelines

  • 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 pipelines 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 pipeline rewiring for migrations. (Preview).

Commands

Name Description Type Status
az devops migrations pipelines delete

Delete pipeline rewiring data for a migration. (Preview).

 Extension Preview
az devops migrations pipelines list

List pipeline rewiring configuration and per-pipeline status.

 Extension Preview
az devops migrations pipelines retry

Retry failed pipeline rewiring entries. (Preview).

 Extension Preview
az devops migrations pipelines submit

Submit pipelines for rewiring. (Preview).

 Extension Preview
az devops migrations pipelines update

Bulk update pipeline rewiring configuration. (Preview).

 Extension Preview

az devops migrations pipelines delete

Preview

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

Delete pipeline rewiring data for a migration. (Preview).

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

Examples

Delete rewiring config and cloned definitions.

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

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

Migration ID used for pipeline rewiring cleanup.

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

--yes -y

Do not prompt for confirmation.

Property Value
Default value: False
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 pipelines list

Preview

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

List pipeline rewiring configuration and per-pipeline status.

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

Examples

List pipeline rewiring status.

az devops migrations pipelines list --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.

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

Preview

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

Retry failed pipeline rewiring entries. (Preview).

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

Examples

Retry specific failed pipelines.

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

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

--pipeline-ids

Pipeline definition IDs to retry. Accepts space-separated or comma-separated values.

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

Preview

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

Submit pipelines for rewiring. (Preview).

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

Examples

Submit pipelines with service connection and repository mappings.

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

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

--pipeline-ids

Pipeline definition IDs. Accepts space-separated values (for example, 42 43 44) or comma-separated values (for example, 42,43,44).

--repository-id

ID of the Azure Repos repository (GUID).

--repository-mapping

Repository mapping in the format <sourceRepoId>=<targetOwner>/<targetRepo>. Can be provided multiple times.

--service-connection-id

Project-scoped GitHub service connection ID (GUID). Optional if a connection was already attached via migrations create --pipeline-service-connection-id or pipelines update --service-connection-id.

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

Preview

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

Bulk update pipeline rewiring configuration. (Preview).

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]

Examples

Add, remove, and update service connection.

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

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

Pipeline IDs to add. Accepts space-separated or comma-separated values.

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

--remove-ids

Pipeline IDs to remove. Accepts space-separated or comma-separated values.

--repository-id

ID of the Azure Repos repository (GUID).

--repository-mapping

Repository mapping in the format <sourceRepoId>=<targetOwner>/<targetRepo>. Can be provided multiple times.

--retry-ids

Failed pipeline IDs to retry. Accepts space-separated or comma-separated values.

--service-connection-id

Project-scoped GitHub service connection ID (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