az devops migrations
Nota
Esta referência faz parte da extensão azure-devops para o CLI do Azure (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.
Este grupo de comandos está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus
Gerir migrações em tempo real para empresas.
Este grupo de comandos faz parte da extensão azure-devops e está em pré-visualização. A disponibilidade pode ser limitada (por exemplo, a utilizadores 1P/listados permitidos). 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 | Preview |
| az devops migrations create |
Crie uma migração para um repositório. |
Extension | Preview |
| az devops migrations cutover |
Gerir a migração e a transição. |
Extension | Preview |
| az devops migrations cutover approve |
Aprove o cutover aceitando uma contagem de itens não processados. |
Extension | Preview |
| az devops migrations cutover cancel |
Cancela um turnover agendado. |
Extension | Preview |
| az devops migrations cutover review |
Revise os itens de migração não processados antes do corte. |
Extension | Preview |
| az devops migrations cutover set |
Ajuste de horários para uma migração. |
Extension | Preview |
| az devops migrations list |
Liste as migrações numa organização. |
Extension | Preview |
| az devops migrations pause |
Pausa uma migração ativa. |
Extension | Preview |
| az devops migrations resume |
Retomar uma migração parada (pausada, falhada). |
Extension | Preview |
| az devops migrations status |
Obtenha o estado de migração de um repositório. |
Extension | Preview |
az devops migrations abandon
O grupo de comando 'migrações devops' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus
Abandone e apague uma migração.
az devops migrations abandon [--acquire-policy-token]
[--change-reference]
[--detect {false, true}]
[--org --organization]
[--remove-read-only]
[--repository-id]
[--yes]
Exemplos
Abandonar e manter o repositório apenas em leitura (por defeito).
az devops migrations abandon --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000
Abandonar e voltar a definir o repositório para leitura-escrita.
az devops migrations abandon --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --remove-read-only
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/.
Também volte a definir o repositório Repositórios do Azure para o estado de leitura-escrita enviando removeReadOnly=true.
| Propriedade | Valor |
|---|---|
| Default value: | False |
ID do repositório Repositórios do Azure (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
O grupo de comando 'migrações devops' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus
Crie uma migração para um repositório.
Se não for fornecido --github-token, a CLI verifica ELM_GITHUB_TOKEN e depois executa GitHub fluxo do dispositivo para adquirir um 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]
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 --agent-pool <your-agent-pool>
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 --agent-pool <your-agent-pool> --validate-only --skip-validation ActivePullRequestCount,PullRequestDeltaSize
Crie usando um token GitHub ou PAT pré-gerado.
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 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 |
Token do GitHub usado para autorização de migração. Ignorado quando --service-endpoint-id é especificado. Se for omitido, o CLI verifica primeiro ELM_GITHUB_TOKEN e depois executa GitHub fluxo do dispositivo.
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 Repositórios do Azure (GUID).
ID de endpoint de serviço (GUID) para a ligação GitHub Enterprise Server. Quando especificado, o servidor usa a ligação de serviço para autenticação GitHub e a CLI ignora o fluxo de dispositivos GitHub. Mutuamente exclusivo com --github-token.
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. Descontinuado e ignorado quando a resolução do proprietário baseada em tokens do lado do servidor está ativada.
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
O grupo de comando 'migrações devops' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus
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
O grupo de comando 'migrações devops' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus
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 Repositórios do Azure (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
O grupo de comando 'migrações devops' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus
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 Repositórios do Azure (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
O grupo de comando 'migrações devops' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus
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 Repositórios do Azure (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 |