az devops migrations
Note
Essa referência faz parte da extensão azure-devops para o Azure CLI (versão 2.30.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando de migrações az devops . Saiba mais sobre extensões.
Gerenciar migrações ao vivo da empresa.
Esse grupo de comandos faz parte da extensão azure-devops. Para migrações de ELM, --org deve ser sua URL da organização do Azure DevOps (por exemplo: https://dev.azure.com/myorg).
Comandos
| Nome | Description | Tipo | Status |
|---|---|---|---|
| az devops migrations abandon |
Abandone e exclua uma migração. |
Extension | GA |
| az devops migrations create |
Crie uma migração para um repositório. |
Extension | GA |
| az devops migrations cutover |
Gerenciar a substituição de migração. |
Extension | GA |
| az devops migrations cutover cancel |
Cancelar uma substituição agendada. |
Extension | GA |
| az devops migrations cutover set |
Agendar a substituição para uma migração. |
Extension | GA |
| az devops migrations list |
Listar migrações em uma organização. |
Extension | GA |
| az devops migrations pause |
Pausar uma migração ativa. |
Extension | GA |
| az devops migrations resume |
Retome uma migração interrompida (pausada, com falha). |
Extension | GA |
| az devops migrations status |
Obtenha o status de migração para um repositório. |
Extension | GA |
az devops migrations abandon
Abandone e exclua uma migração.
az devops migrations abandon [--acquire-policy-token]
[--change-reference]
[--detect {false, true}]
[--org --organization]
[--repository-id]
[--yes]
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Adquirir um token Azure Policy automaticamente para essa operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
A ID de referência de alteração relacionada para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
Detecte automaticamente a organização.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | false, true |
URL da organização do Azure DevOps Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio do comando git config. Exemplo: https://dev.azure.com/MyOrganizationName/.
ID do GUID (repositório de Repositório do Azure).
Não solicite confirmação.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az devops migrations create
Crie uma migração para um repositório.
az devops migrations create [--acquire-policy-token]
[--agent-pool]
[--change-reference]
[--cutover-date]
[--detect {false, true}]
[--org --organization]
[--repository-id]
[--skip-validation]
[--target-owner-user-id]
[--target-repository]
[--validate-only]
Exemplos
Crie uma migração.
az devops migrations create --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --target-repository https://github.com/OrgName/RepoName --target-owner-user-id OwnerUserId --agent-pool MigrationPool
Crie uma migração somente validar.
az devops migrations create --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --target-repository https://github.com/OrgName/RepoName --target-owner-user-id OwnerUserId --agent-pool MigrationPool --validate-only --skip-validation ActivePullRequestCount,PullRequestDeltaSize
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Adquirir um token Azure Policy automaticamente para essa operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
Nome do pool de agentes a ser usado para o trabalho de migração.
A ID de referência de alteração relacionada para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
Data/hora de substituição agendada (ISO 8601).
Detecte automaticamente a organização.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | false, true |
URL da organização do Azure DevOps Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio do comando git config. Exemplo: https://dev.azure.com/MyOrganizationName/.
ID do GUID (repositório de Repositório do Azure).
Políticas de validação a serem ignoradas. Aceita uma lista separada por vírgulas de nomes de política (por exemplo, AgentPoolExists, MaxRepoSize) ou uma máscara de bits de inteiro não negativo.
ID de usuário do proprietário do repositório de destino.
URL do repositório de destino (deve começar com http:// ou https://).
Crie no modo somente validação (somente verificações de pré-migração).
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az devops migrations list
Listar migrações em uma organização.
az devops migrations list [--detect {false, true}]
[--include-inactive]
[--org --organization]
[--project]
Exemplos
Listar migrações.
az devops migrations list --org https://dev.azure.com/myorg
Liste todas as migrações, incluindo as inativas.
az devops migrations list --org https://dev.azure.com/myorg --include-inactive
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Detecte automaticamente a organização.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | false, true |
Inclua migrações inativas (concluídas, abandonadas, com falha) nos resultados.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
URL da organização do Azure DevOps Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio do comando git config. Exemplo: https://dev.azure.com/MyOrganizationName/.
Nome ou ID do projeto opcional para filtrar migrações.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az devops migrations pause
Pausar uma migração ativa.
az devops migrations pause [--acquire-policy-token]
[--change-reference]
[--detect {false, true}]
[--org --organization]
[--repository-id]
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Adquirir um token Azure Policy automaticamente para essa operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
A ID de referência de alteração relacionada para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
Detecte automaticamente a organização.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | false, true |
URL da organização do Azure DevOps Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio do comando git config. Exemplo: https://dev.azure.com/MyOrganizationName/.
ID do GUID (repositório de Repositório do Azure).
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az devops migrations resume
Retome uma migração interrompida (pausada, com falha).
az devops migrations resume [--acquire-policy-token]
[--change-reference]
[--detect {false, true}]
[--migration]
[--org --organization]
[--repository-id]
[--validate-only]
Exemplos
Retome usando o modo atual.
az devops migrations resume --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000
Retomar no modo somente validação.
az devops migrations resume --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --validate-only
Continuar a migração (limpa o modo somente validação).
az devops migrations resume --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --migration
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Adquirir um token Azure Policy automaticamente para essa operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
A ID de referência de alteração relacionada para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
Detecte automaticamente a organização.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | false, true |
Promova uma migração somente validação bem-sucedida para uma migração completa (define validateOnly=false e statusRequested=active).
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
URL da organização do Azure DevOps Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio do comando git config. Exemplo: https://dev.azure.com/MyOrganizationName/.
ID do GUID (repositório de Repositório do Azure).
Retomar no modo somente validação.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az devops migrations status
Obtenha o status de migração para um repositório.
az devops migrations status [--acquire-policy-token]
[--change-reference]
[--detect {false, true}]
[--org --organization]
[--repository-id]
Exemplos
Obtenha o status da migração por id do repositório.
az devops migrations status --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Adquirir um token Azure Policy automaticamente para essa operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
A ID de referência de alteração relacionada para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
Detecte automaticamente a organização.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | false, true |
URL da organização do Azure DevOps Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio do comando git config. Exemplo: https://dev.azure.com/MyOrganizationName/.
ID do GUID (repositório de Repositório do Azure).
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |