az devops migrations
Nota
Esta referência faz parte da extensão azure-devops para o Azure CLI (versão 2.30.0 ou superior). A extensão vai instalar-se automaticamente na primeira vez que executares um comando de migração do AZ DevOps . Saiba mais sobre extensões.
Gerir migrações em tempo real para empresas.
Este grupo de comandos faz parte da extensão azure-devops. Para migrações ELM, --org deve ser o URL da sua organização Azure DevOps (por exemplo: https://dev.azure.com/myorg).
Comandos
| Name | Description | Tipo | Status |
|---|---|---|---|
| az devops migrations abandon |
Abandone e apague uma migração. |
Extension | disponibilidade geral |
| az devops migrations create |
Crie uma migração para um repositório. |
Extension | disponibilidade geral |
| az devops migrations cutover |
Gerir a migração e a transição. |
Extension | disponibilidade geral |
| az devops migrations cutover cancel |
Cancela um turnover agendado. |
Extension | disponibilidade geral |
| az devops migrations cutover set |
Ajuste de horários para uma migração. |
Extension | disponibilidade geral |
| az devops migrations list |
Liste as migrações numa organização. |
Extension | disponibilidade geral |
| az devops migrations pause |
Pausa uma migração ativa. |
Extension | disponibilidade geral |
| az devops migrations resume |
Retomar uma migração parada (pausada, falhada). |
Extension | disponibilidade geral |
| az devops migrations status |
Obtenha o estado de migração de um repositório. |
Extension | disponibilidade geral |
az devops migrations abandon
Abandone e apague 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 tornar-se necessários para que o comando seja executado com êxito.
Aquisição automática de um token Azure Policy para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
O ID de referência de alteração relacionado para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
Detete automaticamente a organização.
| Propriedade | Valor |
|---|---|
| Valores aceites: | false, true |
URL da organização Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.
ID do repositório Azure Repos (GUID).
Não solicite confirmação.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | 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 de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | 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
Cria 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 apenas de validaçã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 --validate-only --skip-validation ActivePullRequestCount,PullRequestDeltaSize
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.
Aquisição automática de um token Azure Policy para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
Nome do pool de agentes para usar em trabalho de migração.
O ID de referência de alteração relacionado para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
Data/hora de transição agendada (ISO 8601).
Detete automaticamente a organização.
| Propriedade | Valor |
|---|---|
| Valores aceites: | false, true |
URL da organização Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.
ID do repositório Azure Repos (GUID).
Políticas de validação a ignorar. Aceita uma lista separada por vírgulas de nomes de políticas (por exemplo, AgentPoolExists, MaxRepoSize) ou uma máscara de bits inteira não negativa.
ID de utilizador do proprietário do repositório alvo.
URL do repositório alvo (deve começar por http:// ou https://).
Criar em modo apenas de validação (apenas verificações pré-migração).
| Propriedade | Valor |
|---|---|
| Default value: | False |
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | 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 de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
az devops migrations list
Liste as migrações numa organização.
az devops migrations list [--detect {false, true}]
[--include-inactive]
[--org --organization]
[--project]
Exemplos
Lista as 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 tornar-se necessários para que o comando seja executado com êxito.
Detete automaticamente a organização.
| Propriedade | Valor |
|---|---|
| Valores aceites: | false, true |
Inclua migrações inativas (concluídas, abandonadas, falhadas) nos resultados.
| Propriedade | Valor |
|---|---|
| Default value: | False |
URL da organização Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.
Nome ou ID de projeto opcional para filtrar migrações.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | 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 de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
az devops migrations pause
Pausa 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 tornar-se necessários para que o comando seja executado com êxito.
Aquisição automática de um token Azure Policy para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
O ID de referência de alteração relacionado para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
Detete automaticamente a organização.
| Propriedade | Valor |
|---|---|
| Valores aceites: | false, true |
URL da organização Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.
ID do repositório Azure Repos (GUID).
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | 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 de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
az devops migrations resume
Retomar uma migração parada (pausada, falhada).
az devops migrations resume [--acquire-policy-token]
[--change-reference]
[--detect {false, true}]
[--migration]
[--org --organization]
[--repository-id]
[--validate-only]
Exemplos
Retomar o modo atual.
az devops migrations resume --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000
Retomar em modo apenas de 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 apenas de 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 tornar-se necessários para que o comando seja executado com êxito.
Aquisição automática de um token Azure Policy para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
O ID de referência de alteração relacionado para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
Detete automaticamente a organização.
| Propriedade | Valor |
|---|---|
| Valores aceites: | false, true |
Promover uma migração validada apenas com sucesso para uma migração completa (define validateOnly=false e statusRequested=active).
| Propriedade | Valor |
|---|---|
| Default value: | False |
URL da organização Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.
ID do repositório Azure Repos (GUID).
Retomar em modo apenas de validação.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | 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 de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
az devops migrations status
Obtenha o estado de migração de um repositório.
az devops migrations status [--acquire-policy-token]
[--change-reference]
[--detect {false, true}]
[--org --organization]
[--repository-id]
Exemplos
Obtenha o estado da migração pelo 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 tornar-se necessários para que o comando seja executado com êxito.
Aquisição automática de um token Azure Policy para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
O ID de referência de alteração relacionado para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
Detete automaticamente a organização.
| Propriedade | Valor |
|---|---|
| Valores aceites: | false, true |
URL da organização Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.
ID do repositório Azure Repos (GUID).
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | 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 de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |