Renomear sua organização no Azure DevOps

Serviços do Azure DevOps

Você pode alterar o nome da sua organização (URL) a qualquer momento no Azure DevOps. Essa ação permite que você atualize a URL para refletir melhor a identidade visual ou a estrutura da sua organização. Alterar o nome da organização atualiza a URL usada para acessar os recursos do Azure DevOps, incluindo as URLs de seus projetos, repositórios e outros recursos na organização. Siga as etapas neste artigo para renomear sua organização e garantir uma transição tranquila para sua equipe.

Atenção

A operação de renomeação afeta as conexões e as pessoas da sua organização que estão trabalhando atualmente com sua organização. Antes de começar, atenda aos pré-requisitos. As URLs de projetos, repositórios e outros recursos dentro da organização mudam quando você habilita a nova URL da organização. Após a renomeação, conclua as atualizações necessárias aplicáveis.

Pré-requisitos

Categoria Requisitos
Permissões Proprietário da organização.
Níveis de Acesso No mínimo, acesso Básico.
Tarefas - Salve seu trabalho.
– Verifique se outros membros não estão usando o serviço.

Observação

Aguarde pelo menos uma hora após a operação de renomeação mais recente, antes de renomear uma organização novamente.

Renomear sua organização

  1. Entre em sua organização (https://dev.azure.com/{yourorganization}).

  2. Selecione Configurações da organização.

    Captura de tela mostrando um ícone de engrenagem e configurações de Organização enfatizadas.

  3. Selecione Visão geral, insira um novo nome para a organização e selecione Salvar. Mova o botão de alternância se quiser usar a nova URL.

    Captura de tela mostrando a guia Organização, entrada Nome e botão Salvar, todos enfatizados.

    Importante

    Siga estas diretrizes ao criar o nome da sua organização:

    • Use apenas letras do alfabeto inglês
    • Inicie o nome da sua organização com uma letra ou um número
    • Use letras, números ou hífens após o caractere inicial
    • Manter o nome da sua organização abaixo de 50 caracteres Unicode
    • Termine com uma letra ou um número

    Se você usar caracteres não permitidos, a seguinte mensagem de erro será exibida: VS850015: O nome especificado não poderá ser usado: {Nome da organização}.

  4. Confirme que deseja renomear sua organização e salvar suas alterações.

    Captura de tela mostrando a tela de confirmação para renomeação da organização.

Sua organização é renomeada.

Atualizar referências após a renomeação

Ao habilitar a nova URL da organização, notifique os usuários e atualize as referências que contêm o nome da organização anterior. Conclua as seguintes ações conforme aplicável:

  • Indicadores e links: Atualize os links salvos para projetos, repositórios, itens de trabalho, pipelines e outros recursos.

  • Conexões de cliente: Reconecte clientes, como o Visual Studio e o Azure DevOps Office Integration, à nova URL da organização.

  • Repositórios remotos do Git: Atualize a URL do remoto em cada repositório local. Para obter mais informações, consulte Atualizar os controles remotos do Git em seus computadores de desenvolvimento.

  • Workspaces do TFVC: Atualize a URL da organização armazenada em cache executando o comando a seguir para cada workspace afetado. Para obter mais informações, consulte o comando Workspaces.

    tf workspaces /collection:https://dev.azure.com/{neworganization}
    
  • Agentes hospedados localmente: Remova e reconfigure os agentes que você registrou com a URL da organização anterior. Para obter mais informações, consulte Remover e reconfigurar um agente Windows, agente Linux ou agente macOS.

  • Análises e Power BI: Atualize as URLs de feed OData e outras URLs de origem de dados que contêm o nome anterior da organização. Para o formato de URL do OData, consulte Conectar com Power BI Data Connector.

  • Ferramentas e integrações: Atualize URLs de organização codificadas em scripts, clientes da API REST, extensões, variáveis de pipeline, webhooks e outras integrações externas. Em seguida, teste cada integração com a nova URL.

  • Federação de identidade de carga de trabalho: Verifique as conexões de serviço do Azure Resource Manager que usam um assunto baseado em nome no formato sc://<organization-name>/<project-name>/<service-connection-name>. Se o assunto contiver o nome da organização anterior, atualize a credencial federada. Itens baseados em ID não exigem atualização. Para obter mais informações, consulte Verificar a URL do emissor para obter precisão.

Perguntas frequentes (FAQs)

P: Se eu alterar a URL da organização, posso voltar atrás?

R: A configuração da URL da organização é de alternância bidirecional. Você pode ativar a nova URL do nome de domínio. Você também pode desativar a nova URL, em seguida, você volta a usar o formato de URL antigo.