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

Pré-visualizar

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.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--detect

Detete automaticamente a organização.

Propriedade Valor
Valores aceites: false, true
--org --organization

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

--remove-read-only

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

ID do repositório Repositórios do Azure (GUID).

--yes -y

Não solicite confirmação.

Propriedade Valor
Default value: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az devops migrations create

Pré-visualizar

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.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--agent-pool

Nome do pool de agentes para usar em trabalho de migração.

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--cutover-date

Data/hora de transição agendada (ISO 8601).

--detect

Detete automaticamente a organização.

Propriedade Valor
Valores aceites: false, true
--github-token

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.

--org --organization

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

--repository-id

ID do repositório Repositórios do Azure (GUID).

--service-endpoint-id

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.

--skip-validation

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.

--target-owner-user-id

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.

--target-repository

URL do repositório alvo (deve começar por http:// ou https://).

--validate-only

Criar em modo apenas de validação (apenas verificações pré-migração).

Propriedade Valor
Default value: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az devops migrations list

Pré-visualizar

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.

--detect

Detete automaticamente a organização.

Propriedade Valor
Valores aceites: false, true
--include-inactive

Inclua migrações inativas (concluídas, abandonadas, falhadas) nos resultados.

Propriedade Valor
Default value: False
--org --organization

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

--project

Nome ou ID de projeto opcional para filtrar migrações.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az devops migrations pause

Pré-visualizar

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.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--detect

Detete automaticamente a organização.

Propriedade Valor
Valores aceites: false, true
--org --organization

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

--repository-id

ID do repositório Repositórios do Azure (GUID).

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az devops migrations resume

Pré-visualizar

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.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--detect

Detete automaticamente a organização.

Propriedade Valor
Valores aceites: false, true
--migration

Promover uma migração validada apenas com sucesso para uma migração completa (define validateOnly=false e statusRequested=active).

Propriedade Valor
Default value: False
--org --organization

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

--repository-id

ID do repositório Repositórios do Azure (GUID).

--validate-only

Retomar em modo apenas de validação.

Propriedade Valor
Default value: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az devops migrations status

Pré-visualizar

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.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--detect

Detete automaticamente a organização.

Propriedade Valor
Valores aceites: false, true
--org --organization

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

--repository-id

ID do repositório Repositórios do Azure (GUID).

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False