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 com novas funções, projetos ou estruturas organizacionais.

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

• Grupo de segurança da equipa
• Listas de pendências e quadros da equipa
• Painéis da equipe

A renomeação automática mantém os controles de acesso, o acompanhamento do projeto 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.

Gorjeta

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

A exclusão de uma equipe remove todas as definições de configuração, incluindo painéis, listas de pendências e painéis. 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 de Projeto .
• Para remover ou excluir uma equipe, seja membro do grupo Administradores de Projeto .

Renomear uma equipe

Nota

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

Página Novas Equipas

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

   

2. Escolha a equipa que pretende mudar o nome e, em seguida, selecione Definições.

3. Em Detalhes da Equipa, introduza um novo nome para a equipa. Opcionalmente, adicione uma nova descrição.

   

4. Salve suas alterações.

Página atual

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

   

2. Escolha a equipa que pretende mudar o nome. No Perfil da Equipa, introduza 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 a atualização da equipe do Azure DevOps. Para obter mais informações, consulte Introdução à CLI do Azure DevOps.

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

Parâmetros

• equipa: Opcional. Nome ou ID de uma equipa.
• descrição: Opcional. Descrição a aplicar à equipa.
• nome: 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=URLo . Necessário se não configurado como padrão ou captado via git config.
• projeto: 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_ID. Necessário se não configurado como padrão ou captado via git config.

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 equipa como predefinição

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

1. Abra as configurações do>Project 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.

Eliminar uma equipa

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 de equipe não podem ser recuperadas depois de excluídas.

Nota

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

Página Novas Equipas

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

2. Selecione a equipa que pretende eliminar e, em seguida, selecione Definiçõ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 Teams>... 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 da equipe, listas de pendências e quadros. Os dados definidos para itens de trabalho atribuídos à equipe são mantidos inalterados. Uma vez excluído, você não pode 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. O ID da equipe a ser excluída.
• projeto: 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 equipas
• 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