Renomear ou remover uma equipe

Serviços de DevOps do Azure | 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 da equipa
• Listas de pendências e quadros da equipa
• Painéis da equipe

Gorjeta

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 são mantidos inalterados. Uma vez excluído, você não pode recuperar as configurações da equipe.

Pré-requisitos

Permissões:

• Grupo Administrador de Equipe ou Administradores de Projeto: para renomear uma equipe, você deve ser um administrador de equipe ou um membro do grupo Administradores de Projeto.
• Grupo Administradores de Projeto: para remover ou excluir uma equipe, você deve ser 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
• Sobre equipes e ferramentas ágeis
• Azure DevOps Teams CLI
• Equipes (API REST)
• Itens de trabalho (API REST)