az devops migrations

Nota:

Esta referencia forma parte de la extensión azure-devops para la CLI de Azure (versión 2.30.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az devops migrations . Obtenga más información sobre las extensiones.

Este grupo de comandos está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Administrar migraciones en vivo empresariales.

El grupo de comandos de migración de ELM forma parte de la extensión azure-devops. Consulte https://aka.ms/adoELM para obtener más información.

Comandos

Nombre	Description	Tipo	Estado
az devops migrations abandon	Abandonar una migración.	Extension	Versión preliminar
az devops migrations create	Cree una migración para un repositorio.	Extension	Versión preliminar
az devops migrations cutover	Administrar la transición de la migración.	Extension	Versión preliminar
az devops migrations cutover approve	Apruebe la migración mediante la aceptación de elementos no procesados o la comprobación de canalizaciones rewired.	Extension	Versión preliminar
az devops migrations cutover cancel	Cancelar una transición programada.	Extension	Versión preliminar
az devops migrations cutover review	Revise los elementos de migración sin procesar antes de la migración.	Extension	Versión preliminar
az devops migrations cutover set	Programar la migración para una migración.	Extension	Versión preliminar
az devops migrations list	Enumera las migraciones de una organización.	Extension	Versión preliminar
az devops migrations pause	Pausar una migración activa.	Extension	Versión preliminar
az devops migrations pipelines	Administrar el rewiring de canalización para las migraciones. (Versión preliminar).	Extension	Versión preliminar
az devops migrations pipelines delete	Elimine los datos de rewiring de canalización para una migración. (Versión preliminar).	Extension	Versión preliminar
az devops migrations pipelines list	Enumere la configuración de la canalización y el estado por canalización.	Extension	Versión preliminar
az devops migrations pipelines retry	Reintentar las entradas de reintento de la canalización con errores. (Versión preliminar).	Extension	Versión preliminar
az devops migrations pipelines submit	Envíe canalizaciones para volver a girar. (Versión preliminar).	Extension	Versión preliminar
az devops migrations pipelines update	Configuración de rewiring de canalización de actualización masiva. (Versión preliminar).	Extension	Versión preliminar
az devops migrations resume	Reanude una migración detenida (en pausa, con errores).	Extension	Versión preliminar
az devops migrations status	Obtenga el estado de migración de un repositorio.	Extension	Versión preliminar

az devops migrations abandon

Vista previa

El grupo de comandos "devops migrations" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Abandonar una migración.

Mueve la migración a un estado abandonado o erróneo; el registro de migración no se purga. Los datos de rewiring de canalización se dejan intactos para que una migración posterior pueda reutilizarla.

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

Ejemplos

Abandone y mantenga el repositorio de solo lectura (valor predeterminado).

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

Abandone y establezca el repositorio en lectura y escritura.

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--detect

Detecta automáticamente la organización.

Propiedad	Valor
Valores aceptados:	false, true

--org --organization

Dirección URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--remove-read-only

Establezca también el repositorio de Azure Repos en estado de lectura y escritura enviando removeReadOnly=true.

Propiedad	Valor
Valor predeterminado:	False

--repository-id

Identificador del repositorio de Azure Repos (GUID).

--yes -y

No solicitar confirmación.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az devops migrations create

Vista previa

El grupo de comandos "devops migrations" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Cree una migración para un repositorio.

GitHub autenticación usa el flujo de dispositivo: la CLI imprime una dirección URL y un código único para completar el inicio de sesión de forma interactiva. No se requiere ningún token de GitHub ni conexión de servicio.

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]

Ejemplos

Cree una migración.

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>

Cree una migración de solo validación.

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--agent-pool

Nombre del grupo de agentes que se usará para el trabajo de migración.

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

Participar en la detección automática de canalizaciones en la transición. Desactivado de forma predeterminada. Cuando se habilita, el trabajo de sincronización de ELM recorre el repositorio de origen y crea definiciones de clonación para cada canalización que haga referencia a él. Requiere --pipeline-service-connection-id; sin la detección se ejecuta como una no-op e inscribe 0 canalizaciones. La canalización en sí siempre está disponible a través de az devops migrations pipelines submit/update.

Propiedad	Valor
Valor predeterminado:	False

--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--cutover-date

Fecha y hora de transición programada (ISO 8601).

--detect

Detecta automáticamente la organización.

Propiedad	Valor
Valores aceptados:	false, true

--enable-boards-gh --enable-boards-github-connection

Opte por aprovisionar la conexión Azure Boards GitHub en la migración total. Desactivado de forma predeterminada. Requiere que la aplicación Azure Boards GitHub se instale en la organización de GitHub Enterprise de destino antes de que se ejecute la migración.

Propiedad	Valor
Valor predeterminado:	False

--org --organization

Dirección URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

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

Project con ámbito GitHub identificador de conexión de servicio (GUID) asociado en tiempo de creación para el rewiring de canalización. Necesario para la detección automática completa cuando se combina con --enable-auto-discover-pipelines; opcional en el modo manual (adjunta previamente la conexión para que las canalizaciones posteriores envíen llamadas solo necesitan --pipeline-ids).

--repository-id

Identificador del repositorio de Azure Repos (GUID).

--skip-validation

Directivas de validación que se van a omitir. Acepta una lista separada por comas de nombres de directiva (por ejemplo, AgentPoolExists,MaxFileSize) o una máscara de bits de entero no negativa. Nombres de directiva admitidos (sin distinción entre mayúsculas y minúsculas): None, ActivePullRequestCount, PullRequestDeltaSize, AgentPoolExists, MaxFileSize, MaxPullRequestSize, MaxPushPackSize, MaxReferenceNameLength, TargetRepositoryDoesNotExist, SourceRepositoryContainsLfsObjects, SourceRepositoryNotReadOnly, BoardsGitHubConnectionProvisioning, All.

--target-owner-user-id

Identificador de usuario del propietario del repositorio de destino. En desuso y se omite cuando está habilitada la resolución de propietario basada en tokens del lado servidor.

--target-repository

Dirección URL del repositorio de destino (debe comenzar con http:// o https://).

--validate-only

Cree en modo de solo validación (solo comprobaciones previas a la migración).

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az devops migrations list

Vista previa

El grupo de comandos "devops migrations" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Enumera las migraciones de una organización.

De forma predeterminada, se devuelve la migración más reciente por repositorio, independientemente del estado. Use --include-all para devolver el historial de migración completo.

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

Ejemplos

Enumere la migración más reciente por repositorio.

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

Enumere el historial de migración completo de cada repositorio.

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--detect

Detecta automáticamente la organización.

Propiedad	Valor
Valores aceptados:	false, true

--include-all

Devuelve el historial de migración completo (todos los registros por repositorio). De forma predeterminada, solo se devuelve la migración más reciente por repositorio, independientemente de su estado.

Propiedad	Valor
Valor predeterminado:	False

--include-inactive

Obsoleto

La opción "--include-inactive" está en desuso y se quitará en una versión futura. Use "--include-all" en su lugar.

Deprecated. Use --include-all en su lugar.

Propiedad	Valor
Valor predeterminado:	False

--org --organization

Dirección URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--project

Nombre o identificador de proyecto opcional para filtrar las migraciones.

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az devops migrations pause

Vista previa

El grupo de comandos "devops migrations" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Pausar una migración activa.

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--detect

Detecta automáticamente la organización.

Propiedad	Valor
Valores aceptados:	false, true

--org --organization

Dirección URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--repository-id

Identificador del repositorio de Azure Repos (GUID).

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az devops migrations resume

Vista previa

El grupo de comandos "devops migrations" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Reanude una migración detenida (en pausa, con errores).

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

Ejemplos

Reanude el uso del modo actual.

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

Reanude en modo de solo validación.

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

Continuar la migración (borra el modo de solo validación).

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--detect

Detecta automáticamente la organización.

Propiedad	Valor
Valores aceptados:	false, true

--migration

Promueva una migración de solo validación correcta a una migración completa (establece validateOnly=false y statusRequested=active).

Propiedad	Valor
Valor predeterminado:	False

--org --organization

Dirección URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--repository-id

Identificador del repositorio de Azure Repos (GUID).

--validate-only

Reanude en modo de solo validación.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az devops migrations status

Vista previa

El grupo de comandos "devops migrations" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Obtenga el estado de migración de un repositorio.

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

Ejemplos

Obtenga el estado de la migración por identificador de repositorio.

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--detect

Detecta automáticamente la organización.

Propiedad	Valor
Valores aceptados:	false, true

--org --organization

Dirección URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--repository-id

Identificador del repositorio de Azure Repos (GUID).

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False