Renomear ou remover uma equipe

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

À medida que sua organização muda, talvez seja necessário renomear ou remover uma equipe.

Quando você renomeia uma equipe, o novo nome se propaga por todo o Azure DevOps. 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

Dica

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

Quando você remove ou exclui uma equipe, todas as suas definições de configuração são excluídas. Essas configurações incluem 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 pode recuperar as configurações da equipe.

Pré-requisitos

• Para renomear uma equipe, você deve ser um administrador de equipe ou um membro do grupo Administradores de Projeto
• Para remover ou excluir uma equipe, você deve ser 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.

Página Novas Equipes

1. No portal da Web, escolha Configurações do projeto e abra Equipes.

   

2. Escolha a equipe que você deseja renomear e, em seguida, escolha Configurações.

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

   

4. Selecione Salvar.

Página atual

1. No portal da Web, escolha Configurações do projeto e abra Equipes.

   

2. Escolha a equipe que você deseja renomear. Em Perfil da Equipe, insira o novo nome e, opcionalmente, atualize a descrição. Escolha Salvar quando terminar.

   

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 de equipe do Azure DevOps. Para começar, confira 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 para 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 grupo padrão usando az devops configure -d project=NAME_OR_ID. 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 Conta 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 é criada com base no nome do projeto.

Para alterar o padrão, abra Equipes de Configurações>do Projeto, escolha Mais opções ao lado da equipe desejada como novo padrão e 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 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 pode recuperar as configurações da equipe.

Observação

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

Página Novas Equipes

1. No portal da Web, escolha Configurações do projeto e abra o Teams , conforme mostrado na seção anterior.

2. Escolha a equipe que deseja excluir e role para baixo até a seção Excluir Equipe. Escolha Excluir equipe.

   

3. Escolha Excluir na caixa de confirmação para concluir a operação de exclusão.

   

Página atual

1. Para excluir uma equipe, escolha Equipes> de Configurações do > Projeto para a equipe que você deseja excluir e selecione a opção 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 pode recuperar as configurações da equipe.

2. Para concluir a operação de exclusão, você deve digitar o nome do WIT conforme mostrado.

   

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
• Sobre equipes e ferramentas Agile
• Azure DevOps Teams CLI
• Equipes (API REST)
• Itens de trabalho (API REST)