Renomear ou remover uma equipe

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

À medida que sua organização evolui, talvez seja necessário renomear ou remover uma equipe para se alinhar melhor a novas funções, projetos ou estruturas organizacionais.

Quando você renomeia uma equipe, o novo nome se propaga automaticamente em todo o Azure DevOps, garantindo consistência e evitando confusão. Os seguintes artefatos de equipe são renomeados automaticamente:

• Grupo de segurança de equipe
• Quadros e listas de pendências da equipe
• Dashboard da equipe

A renomeação automática mantém os controles de acesso, o rastreamento de projetos e as configurações do painel sem atualizações manuais. A remoção de uma equipe exclui suas configurações e reatribui seus membros a outras equipes, garantindo a continuidade do fluxo de trabalho e a clareza organizacional.

Dica

Atualize todas as consultas que fazem referência ao nome do grupo de segurança da equipe antiga.

A exclusão de uma equipe remove todas as definições de configuração, incluindo painéis, listas de pendências e quadros. Os dados do item de trabalho permanecem inalterados. As configurações de equipe não podem ser recuperadas após a exclusão.

Pré-requisitos

Permissões:

• Para renomear uma equipe, seja um administrador de equipe ou um membro do grupo Administradores do Projeto.
• Para remover ou excluir uma equipe, seja membro do grupo Administradores do Projeto.

Renomear uma equipe

Observação

Para habilitar a interface do usuário para a Página Novas Equipes, consulte Gerenciar ou habilitar recursos.

Nova página do Teams

1. No seu projeto no portal da Web, selecione Equipes de configurações>do projeto.

   

2. Escolha a equipe que você deseja renomear e selecione Configurações.

3. Em Detalhes da equipe, insira um novo nome para a equipe. Opcionalmente, adicione uma nova descrição.

   

4. Salve suas alterações.

Página atual

1. No seu projeto no portal da Web, selecione Equipes de configurações>do projeto.

   

2. Escolha a equipe que deseja renomear. No Perfil da Equipe, insira o novo nome e, opcionalmente, atualize a descrição. Salve suas alterações.

   

Para configurar outros recursos de equipe, consulte Gerenciar equipes e configurar ferramentas de equipe.

CLI do Azure DevOps

Você pode renomear uma equipe ou sua descrição usando Azure DevOps atualização de equipe. Para obter mais informações, consulte Introdução à CLI do Azure DevOps.

az devops team update --team
                      [--description]
                      [--name]
                      [--org]
                      [--project]

Parâmetros

• equipe: opcional. Nome ou ID de uma equipe.
• description: opcional. Descrição a aplicar à equipe.
• name: opcional. Nome a ser aplicado para renomear a equipe.
• org: opcional. URL da organização. Você pode configurar a organização padrão usando az devops configure -d org=URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração Git.
• project: opcional. Nome ou ID do projeto. Exemplo: --project "Fabrikam Fiber". Você pode configurar o projeto padrão usando az devops configure -d project=NAME_OR_IDo . Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração Git.

Exemplo

Por exemplo, o comando a seguir renomeia a equipe de Gerenciamento de Contas para Gerenciamento da Organização. Para obter formatos de saída adicionais, consulte Formatos de saída para comandos da CLI do Azure.

az devops team update --team "Account Management" --name "Organization Management" --description "Management team focused on creating and maintaining customer services for organizations"
{
  "description": "Management team focused on creating and maintaining customer services for organizations",
  "id": "7f099146-29a2-4798-9949-77c9f5f79653",
  "identity": {
    "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-227716950-993605186-2584159299-2630527068-1-4146437839-3810360391-2614259327-2922617790",
    "id": "7f099146-29a2-4798-9949-77c9f5f79653",
    "isActive": true,
    "isContainer": true,
    "masterId": "7f099146-29a2-4798-9949-77c9f5f79653",
    "memberOf": [],
    "members": [],
    "metaTypeId": 255,
    "properties": {
      "Account": {
        "$type": "System.String",
        "$value": "Account Management"
      },
      "Description": {
        "$type": "System.String",
        "$value": "Management team focused on creating and maintaining customer services"
      },
      "Domain": {
        "$type": "System.String",
        "$value": "vstfs:///Classification/TeamProject/56af920d-393b-4236-9a07-24439ccaa85c"
      },
      "LocalScopeId": {
        "$type": "System.String",
        "$value": "56af920d-393b-4236-9a07-24439ccaa85c"
      },
      "Microsoft.TeamFoundation.Team": {
        "$type": "System.String",
        "$value": "True"
      },
      "SchemaClassName": {
        "$type": "System.String",
        "$value": "Group"
      },
      "ScopeId": {
        "$type": "System.String",
        "$value": "e03662ad-bec4-4a33-bb0f-86e365ee2d88"
      },
      "ScopeName": {
        "$type": "System.String",
        "$value": "Fabrikam Fiber"
      },
      "ScopeType": {
        "$type": "System.String",
        "$value": "TeamProject"
      },
      "SecuringHostId": {
        "$type": "System.String",
        "$value": "380ed149-33d0-4d78-a7ed-89921802f389"
      },
      "SecurityGroup": {
        "$type": "System.String",
        "$value": "SecurityGroup"
      },
      "SpecialType": {
        "$type": "System.String",
        "$value": "Generic"
      },
      "VirtualPlugin": {
        "$type": "System.String",
        "$value": ""
      }
    },
    "providerDisplayName": "[Fabrikam Fiber]\\Account Management",
    "resourceVersion": 2,
    "subjectDescriptor": "vssgp.Uy0xLTktMTU1MTM3NDI0NS0yMjc3MTY5NTAtOTkzNjA1MTg2LTI1ODQxNTkyOTktMjYzMDUyNzA2OC0xLTQxNDY0Mzc4MzktMzgxMDM2MDM5MS0yNjE0MjU5MzI3LTI5MjI2MTc3OTA"
  },
  "identityUrl": "https://spsprodeus21.vssps.visualstudio.com/A380ed149-33d0-4d78-a7ed-89921802f389/_apis/Identities/7f099146-29a2-4798-9949-77c9f5f79653",
  "name": "Organization Management",
  "projectId": "56af920d-393b-4236-9a07-24439ccaa85c",
  "projectName": "Fabrikam Fiber",
  "url": "https://dev.azure.com/fabrikam/_apis/projects/56af920d-393b-4236-9a07-24439ccaa85c/teams/7f099146-29a2-4798-9949-77c9f5f79653"
}

Definir uma equipe como padrão

Quando um projeto é criado, uma equipe padrão também é criada com base no nome do projeto.

1. Abra as configurações>do projeto Teams.
2. Selecione Mais opções ao lado da equipe desejada como o novo padrão e, em seguida, selecione Definir equipe como padrão do projeto.

Excluir uma equipe

Você pode excluir qualquer equipe, exceto a equipe padrão. Pelo menos uma equipe deve ser definida para um projeto.

Importante

A exclusão de uma equipe remove todas as definições de configuração da equipe (painéis, listas de pendências, quadros). Os dados do item de trabalho permanecem inalterados. As configurações da equipe não podem ser recuperadas depois de excluídas.

Observação

Para habilitar a interface do usuário para a Página Novas Equipes, consulte Gerenciar ou habilitar recursos.

Nova página do Teams

1. No seu projeto no portal da Web, selecione Configurações>do projeto Equipes, conforme mostrado na seção anterior.

2. Selecione a equipe que você deseja excluir e, em seguida, selecione Configurações.

3. Role para baixo e selecione Excluir equipe.

   

4. Selecione Excluir na caixa de confirmação para concluir a operação de exclusão.

   

Página atual

1. No seu projeto no portal da Web, selecione Configurações do projeto>Equipes>... para a equipe que você deseja excluir e, em seguida, selecione Excluir.

   

   Importante

   A exclusão de uma equipe exclui todas as definições de configuração da equipe, incluindo painéis de equipe, listas de pendências e quadros. Os dados definidos para itens de trabalho atribuídos à equipe permanecem inalterados. Depois de excluído, você não poderá recuperar as configurações da equipe.

2. Para concluir a operação de exclusão, você deve inserir o nome do tipo de item de trabalho, conforme mostrado no exemplo a seguir.

   

CLI do Azure DevOps

Você pode excluir uma equipe usando az devops team delete.

az devops team delete --id
                      [--project]
                      [--yes]

Parâmetros

• id: obrigatório. A ID da equipe a ser excluída.
• project: opcional. Nome ou ID do projeto. Exemplo: --project "Fabrikam Fiber".
• sim: opcional. Especifique para não solicitar confirmação.

Exemplo

az devops team delete --id 5385556a-254d-4ad4-bd11-71955e3a7070 --project "Fabrikam Fiber"
Are you sure you want to delete this team? (y/n): y

Artigos relacionados

• Adicionar equipes
• Saiba mais sobre equipes e ferramentas ágeis
• Usar a CLI do Azure DevOps Teams
• Usar a API REST do Teams
• Usar a API REST de Itens de Trabalho