az devops migrations

  • Vista previa

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.

Este grupo de comandos forma parte de la extensión azure-devops y está en versión preliminar. La disponibilidad puede estar limitada (por ejemplo, a usuarios con lista de permitidos o 1P). Para las migraciones de ELM, --org debe ser la dirección URL de la organización de Azure DevOps (por ejemplo: https://dev.azure.com/myorg).

Comandos

Nombre Description Tipo Estado
az devops migrations abandon

Abandone y elimine 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

Aprobar la migración mediante la aceptación de un recuento de elementos no procesados.

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

Abandone y elimine una migración.

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.

Si no se proporciona --github-token, la CLI comprueba ELM_GITHUB_TOKEN y, a continuación, ejecuta GitHub flujo de dispositivo para adquirir un token.

az devops migrations create [--acquire-policy-token]
                            [--agent-pool]
                            [--change-reference]
                            [--cutover-date]
                            [--detect {false, true}]
                            [--github-token]
                            [--org --organization]
                            [--repository-id]
                            [--service-endpoint-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

Cree mediante un token de GitHub o PAT generado previamente.

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

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.

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

GitHub token usado para la autorización de migración. Se omite cuando se especifica --service-endpoint-id. Si se omite, la CLI comprueba primero ELM_GITHUB_TOKEN y, a continuación, ejecuta GitHub flujo de dispositivo.

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

--service-endpoint-id

Identificador de punto de conexión de servicio (GUID) para la conexión de GitHub Enterprise Server. Cuando se especifica, el servidor usa la conexión de servicio para la autenticación de GitHub y la CLI omite GitHub flujo de dispositivo. Mutuamente excluyente con --github-token.

--skip-validation

Directivas de validación que se van a omitir. Acepta una lista separada por comas de nombres de directiva (por ejemplo, AgentPoolExists,MaxRepoSize) o una máscara de bits de entero no negativa.

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

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

Ejemplos

Enumerar las migraciones.

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

Enumere todas las migraciones, incluidas las inactivas.

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

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

Incluya migraciones inactivas (completadas, abandonadas y con errores) en los resultados.

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