az devops migrations

  • Versão Prévia

Note

Essa referência faz parte da extensão azure-devops para o CLI do Azure (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.

Esse grupo de comandos está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Gerenciar migrações ao vivo da empresa.

Esse grupo de comandos faz parte da extensão azure-devops e está em versão prévia. A disponibilidade pode ser limitada (por exemplo, a usuários com lista de permissões/1P). 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 Preview
az devops migrations create

Crie uma migração para um repositório.

 Extension Preview
az devops migrations cutover

Gerenciar a substituição de migração.

 Extension Preview
az devops migrations cutover approve

Aprove a substituição aceitando uma contagem de itens não processados.

 Extension Preview
az devops migrations cutover cancel

Cancelar uma substituição agendada.

 Extension Preview
az devops migrations cutover review

Examine os itens de migração não processados antes da substituição.

 Extension Preview
az devops migrations cutover set

Agendar a substituição para uma migração.

 Extension Preview
az devops migrations list

Listar migrações em uma organização.

 Extension Preview
az devops migrations pause

Pausar uma migração ativa.

 Extension Preview
az devops migrations resume

Retome uma migração interrompida (pausada, com falha).

 Extension Preview
az devops migrations status

Obtenha o status de migração para um repositório.

 Extension Preview

az devops migrations abandon

Versão Prévia

O grupo de comandos 'devops migrations' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Abandone e exclua uma migração.

az devops migrations abandon [--acquire-policy-token]
                             [--change-reference]
                             [--detect {false, true}]
                             [--org --organization]
                             [--remove-read-only]
                             [--repository-id]
                             [--yes]

Exemplos

Abandone e mantenha o repositório somente leitura (padrão).

az devops migrations abandon --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000

Abandone e defina o repositório de volta para leitura-gravação.

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 se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

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

A ID de referência de alteração relacionada para esta operação de recurso.

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

Detecte automaticamente a organização.

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

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

--remove-read-only

Defina também o repositório Azure Repos de volta para o estado de leitura/gravação enviando removeReadOnly=true.

Propriedade Valor
Valor padrão: False
--repository-id

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

--yes -y

Não solicite confirmação.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Versão Prévia

O grupo de comandos 'devops migrations' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Crie uma migração para um repositório.

Se --github token não for fornecido, a CLI verificará ELM_GITHUB_TOKEN e, em seguida, executará GitHub fluxo de 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

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 --agent-pool <your-agent-pool>

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 --agent-pool <your-agent-pool> --validate-only --skip-validation ActivePullRequestCount,PullRequestDeltaSize

Crie usando um token de GitHub pré-gerado ou PAT.

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 se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

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

Nome do pool de agentes a ser usado para o trabalho de migração.

--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

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

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

--detect

Detecte automaticamente a organização.

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

GitHub token usado para autorização de migração. Ignorado quando --service-endpoint-id é especificado. Se omitida, a CLI primeiro verifica ELM_GITHUB_TOKEN e, em seguida, executa GitHub fluxo do dispositivo.

--org --organization

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

--repository-id

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

--service-endpoint-id

GUID (ID do ponto de extremidade de serviço) para a conexão GitHub Enterprise Server. Quando especificado, o servidor usa a conexão de serviço para autenticação GitHub e a CLI ignora GitHub fluxo do dispositivo. Mutuamente exclusivo com --github-token.

--skip-validation

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.

--target-owner-user-id

ID de usuário do proprietário do repositório de destino. Preterido e ignorado quando a resolução de proprietário baseada em token do lado do servidor está habilitada.

--target-repository

URL do repositório de destino (deve começar com http:// ou https://).

--validate-only

Crie no modo somente validação (somente verificações de pré-migração).

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Versão Prévia

O grupo de comandos 'devops migrations' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

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.

--detect

Detecte automaticamente a organização.

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

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

Propriedade Valor
Valor padrão: False
--org --organization

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

--project

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

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Versão Prévia

O grupo de comandos 'devops migrations' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

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.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

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

A ID de referência de alteração relacionada para esta operação de recurso.

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

Detecte automaticamente a organização.

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

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

--repository-id

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

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Versão Prévia

O grupo de comandos 'devops migrations' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

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.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

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

A ID de referência de alteração relacionada para esta operação de recurso.

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

Detecte automaticamente a organização.

Propriedade Valor
Valores aceitos: false, true
--migration

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

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

--repository-id

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

--validate-only

Retomar no modo somente validação.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Versão Prévia

O grupo de comandos 'devops migrations' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

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.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

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

A ID de referência de alteração relacionada para esta operação de recurso.

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

Detecte automaticamente a organização.

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

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

--repository-id

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

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False