Compartilhar via


Adicionar usuários ou grupos a uma equipe ou projeto

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Este artigo mostra como adicionar usuários ou grupos a uma equipe ou projeto. Para organizações com grandes bases de usuários, recomendamos que você use o Microsoft Entra ID para adicionar e gerenciar novos usuários por meio de grupos de segurança. No entanto, para habilitar a flexibilidade para todas as organizações de tamanho, o Azure DevOps dá suporte aos procedimentos descritos neste artigo.

Este artigo mostra como adicionar usuários a uma equipe ou projeto. Para organizações com grandes bases de usuários, recomendamos que você use o Active Directory ou o Grupo do Windows para gerenciar usuários por meio de grupos de segurança. No entanto, para habilitar a flexibilidade para todas as organizações de tamanho, o Azure DevOps dá suporte aos procedimentos descritos neste artigo.

Pré-requisitos

Categoria Requisitos
Acesso ao projeto - Membro de um projeto.
Permissões – Para adicionar usuários ou remover usuários de uma equipe: Administrador de equipe ou membro de um dos grupos administrativos.
– Para adicionar usuários ou remover usuários de um projeto: Membro do grupo Administradores de projeto.
– Para adicionar usuários ou gerenciar usuários para uma organização: Membro do grupo Administradores da Coleção de Projetos . Os proprietários da organização são automaticamente membros desse grupo.
Políticas - Se sua organização estiver conectada à ID do Microsoft Entra: habilite os administradores da equipe e do projeto para convidar novas políticas de usuários para administradores de equipe ou membros do grupo Administradores do Projeto para adicionar novos usuários.
Categoria Requisitos
Acesso ao projeto - Membro de um projeto.
Permissões – Para adicionar usuários ou remover usuários de uma equipe: Administrador de equipe ou membro de um dos grupos administrativos.
– Para adicionar usuários ou remover usuários de um projeto: Membro do grupo Administradores de projeto.
– Para adicionar usuários ou gerenciar usuários para um servidor: membro do grupo Administradores do Azure DevOps.

Recomendado: se você for novo no Azure DevOps, familiarize-se com as informações nos seguintes artigos:

Opções com suporte para adicionar usuários

Dependendo do nível de administrador e da interface, você pode adicionar usuários novos ou existentes a equipes ou projetos das seguintes maneiras.

Os administradores de equipe e projeto podem adicionar usuários existentes à sua equipe ou projeto. Um usuário existente é qualquer usuário reconhecido por uma coleção de projetos por meio do Active Directory ou do Grupo do Windows criado para o servidor que hospeda o Servidor do Azure DevOps local.

Nível de administrador

Interface

Tarefas com suporte

Administradores da equipe

  • Adicione usuários novos ou existentes a uma equipe.
  • Envie um convite para novos usuários.
  • Adicione usuários ou grupos existentes a uma equipe.

Administradores da equipe

  • Adicione usuários ou grupos existentes a uma equipe.

Administradores do Projeto

  • Adicione usuários novos ou existentes.
  • Envie um convite a novos usuários.
  • Opcionalmente, adicione usuários a uma ou mais equipes.
  • Adicione usuários ou grupos existentes a um grupo de segurança. Ao adicionar a um grupo de equipe, você os adiciona efetivamente à equipe.
  • Opcionalmente, remova um usuário de um grupo.

Administradores da Coleção de Projetos

  • Adicione novos usuários a uma organização e envie um convite. Deve especificar o nível de acesso.
  • Opcionalmente, adicione usuários para selecionar projetos.
  • Use Regras do grupo para gerenciar ainda mais os grupos.
  • Adicione novos usuários a uma organização e envie um convite. Deve especificar o nível de acesso.

Administradores do Microsoft Entra.

Microsoft Entra ID

  • Adicione usuários ao Microsoft Entra, conectado ao Azure DevOps Services. Esses usuários são adicionados ao grupo Usuários Válidos da Coleção de Projetos. Para obter mais informações, confira Conectar sua organização ao Microsoft Entra ID.

Administradores do Active Directory

Active Directory ou Grupo do Windows

  • Adicione usuários ao Active Directory ou ao Grupo do Windows, conectados ao Azure DevOps. Esses usuários são adicionados como membros do grupo Usuários Válidos da Coleção de Projetos e têm acesso a todos os projetos em uma coleção de projetos. Para obter mais informações, consulte Configurar grupos para uso no Azure DevOps localmente.

Adicionar um usuário do widget Membros da Equipe

Como administrador de equipe, você pode adicionar membros novos ou existentes dos Membros da Equipe dashboard widget. Para obter mais informações, confira Adicionar widgets a um painel.

  1. Entre no projeto (https://dev.azure.com/<My_Organization>/<My_Project>).

  2. Selecione Painéis e escolha seu painel para abri-lo no Azure DevOps:

    Captura de tela da guia Painéis aberta para um projeto no Azure DevOps.

  3. Selecione Gerenciar membros da equipe no widget Membros da Equipe:

    Captura de tela do widget Membros da Equipe em um painel com a ação Gerenciar membros da equipe (o símbolo de adição) realçada.

  4. Insira o nome de exibição ou o endereço de email para o usuário adicionar ao painel do projeto:

    • Para um usuário existente, insira as informações até que a caixa de diálogo mostre uma entrada correspondente no sistema. Selecione a entrada correspondente e, em seguida, selecione Adicionar. Você pode adicionar vários usuários separando as entradas com um ponto-e-vírgula (;).

    • Para um novo usuário não reconhecido pelo sistema, insira o endereço de email completo, incluindo o domínio, como fabrikam-user@fabrikam.com. Ao adicionar um usuário não reconhecido, você verá uma notificação informando que um nível de acesso deve ser atribuído ao usuário. Para concluir a ação, selecione Adicionar:

      Captura de tela da caixa de diálogo Convidar membros para uma equipe, adicione uma nova conta de usuário.

      O sistema atribui o nível de acesso do Stakeholder para o novo usuário, quando todos os cinco níveis de acesso básicos (gratuitos) já estão atribuídos. Os colaboradores ativos de um projeto precisam ter o acesso Básico como um mínimo. Um Administrador de Coleção de Projetos pode alterar o nível de acesso e reenviar convites da páginaUsuários de > da Organização.

      Observação

      Usuários com acesso limitado, como Stakeholders, não podem acessar recursos selecionados mesmo se tiverem permissões concedidas a esses recursos. Para obter mais informações, consulte Permissões e acesso.

Quando o processo é concluído, uma notificação é exibida brevemente para indicar êxito ou falha. Você pode selecionar Detalhes para abrir a notificação e examinar os detalhes:

Usuário adicionado com êxito

Captura de tela da mensagem de êxito de notificação.

Falha ao adicionar um usuário especificado

Captura de tela da mensagem de falha de notificação.

Captura de tela da caixa de diálogo Notificação mostrando detalhes sobre a operação bem-sucedida.

Captura de tela da caixa de diálogo Notificação mostrando detalhes sobre por que a operação falhou.

Quando a operação for bem-sucedida, novos usuários receberão um convite por email para entrar no projeto. Os usuários existentes não recebem uma notificação formal.

Adicionar usuários ou grupos a uma equipe

Você pode adicionar usuários ou grupos de segurança existentes a uma equipe no menu Configurações de Equipe . Para adicionar um grupo de segurança personalizado, consulte Usar grupos de segurança para gerenciar usuários e grupos.

Na primeira vez que adicionar um usuário ou grupo ao Azure DevOps, você não poderá navegar diretamente até ele ou verificar o nome amigável. Depois que o Azure DevOps verificar a identidade, você poderá procurar o usuário ou grupo usando o nome amigável. Por exemplo, você pode navegar no nome amigável Projetos para localizar o grupo verificado (fabrikam-projects@fabrikam.comProjetos para Fabrikam).

Observação

Para habilitar a nova interface do usuário para gerenciar equipes, habilite a Nova Página do Teams da ferramenta Visualizar recursos . Para saber como, confira Gerenciar ou habilitar recursos.

  1. Selecione operfil da equipe do>> Show (ícone de pessoas) >Configurações da equipe:

    Captura de tela que mostra como acessar as Configurações da Equipe selecionando o ícone Mostrar perfil da equipe.

    Se você precisar alternar o contexto de equipe, use o seletor de equipe na trilha de trilha de trilha para a página atual:

    Captura de tela da trilha DevOps do Project Settings, Teams e Team para a página atual no Azure DevOps.

  2. Nas Configurações do Projeto para a Equipe, examine a associação da equipe na seção Membros .

    Você pode alterar a forma como a lista mostra os membros da equipe:

    • Membros Diretos: mostrar usuários e grupos que são membros da equipe. Os grupos não são expandidos para mostrar os usuários individuais dentro dos grupos.
    • Membros expandidos: mostrar usuários que são membros da equipe. Para grupos, expanda todos os grupos do Azure DevOps para mostrar os usuários individuais dentro dos grupos como membros da equipe. Os grupos do Microsoft Entra ID ou do Active Directory não se expandem.
  3. Para adicionar mais usuários ou grupos como membros da equipe, selecione Adicionar:

    Captura de tela da caixa de diálogo Perfil da Equipe com a opção Adicionar realçada.

  4. Insira o nome de exibição ou o endereço de email para o usuário ou grupo a ser adicionado à equipe. Selecione a entrada correspondente no sistema e, em seguida, selecione Salvar.

    • Você pode adicionar vários usuários separando as entradas com um ponto-e-vírgula (;).
    • Você pode adicionar um grupo de segurança de projeto, como outro grupo de equipe, grupo personalizado ou grupo do Microsoft Entra, se usado pela organização.

    Captura de tela da caixa de diálogo Convidar membros para a equipe, escolha a conta de usuário a ser adicionada à equipe.

    Depois de salvar suas seleções, a lista Membros é atualizada para incluir os novos membros. Se você não vir os novos membros da equipe na lista, selecione Atualizar para atualizar o modo de exibição.

  5. Cada equipe deve ter pelo menos um usuário atribuído como administrador. Você pode adicionar administradores nas Configurações do Projeto para a Equipe na seçãoAdministradores de >. Para obter instruções detalhadas, consulte Adicionar uma conta como administrador de equipe.

    Captura de tela da seção Administradores nas Configurações do Projeto para o Teams.

Selecione a guia Interface do Usuário Atual e siga as instruções para adicionar novos membros da equipe. O recurso de interface do usuário de visualização da Nova Página do Teams está disponível somente para o Azure DevOps Services.

Observação

A lista membros da equipe tem um indicador Total que mostra o tamanho da equipe. O valor máximo exibido pelo indicador é 500. Se sua equipe tiver mais de 500 membros, o indicador mostrará o tamanho como 500. Se sua equipe tiver menos de 500 membros, o indicador mostrará o tamanho real.

Captura de tela do indicador Total para os membros da equipe.

Remover usuários ou grupos de uma equipe

Remova um usuário ou grupo de uma equipe usando os procedimentos a seguir.

Se o usuário que você está planejando remover for um administrador de equipe, primeiro remova o usuário como administrador da equipe e remova o usuário da equipe. Para obter mais informações, consulte Remover um administrador de equipe.

Observação

Para habilitar a nova interface do usuário para gerenciar equipes, habilite a Nova Página do Teams da ferramenta Visualizar recursos . Para saber como, confira Gerenciar ou habilitar recursos.

  1. Vá para o Project Settings>Teams e selecione a Equipe que você deseja atualizar.

  2. Na seção Membros da equipe, examine os Membros Diretos da equipe. Localize o usuário para remover e selecione Mais ações>Remover:

    Captura de tela da página Perfil da equipe mostrando como selecionar a opção Remover para um membro da equipe.

  3. Na caixa de diálogo de confirmação, selecione Excluir:

    Captura de tela da confirmação da caixa de diálogo Excluir membro.

Selecione a guia Interface do Usuário Atual e siga as instruções para remover membros da equipe. O recurso de interface do usuário de visualização da Nova Página do Teams está disponível somente para o Azure DevOps Services.

Adicionar usuários ou grupos a um projeto

Como membro do grupo Administradores do Projeto , você pode adicionar usuários ou grupos a um projeto. Adicione o novo membro do projeto a um grupo de segurança na páginaPermissões de > do Projeto. Para adicionar um grupo de segurança personalizado, consulte Adicionar ou remover usuários ou grupos, gerenciar grupos de segurança.

Observação

Para habilitar a página de visualização da Página de Configurações de Permissões do Projeto , consulte Habilitar recursos de visualização.

  1. Entre no projeto (https://dev.azure.com/<My_Organization>/<My_Project>).

  2. Selecione Permissões de Configurações> do Projeto:

    Captura de tela da seção Configurações do Projeto, Permissões.

  3. Na seção Grupos de segurança, selecione o nível de grupo de segurança a ser usado para os novos membros do projeto. Você pode escolher qualquer grupo de segurança na lista, que inclui todos os grupos de equipe definidos. Aqui estão alguns exemplos:

    • Leitores: acesso somente leitura ao projeto.
    • Colaboradores: privilégios de colaborador completos para o projeto, o que é equivalente ao acesso do Stakeholder .
    • Administradores de projeto: privilégios de administrador para o projeto. Para obter mais informações, consulte Alterar permissões no nível do projeto.

    Este exemplo usa o grupo de segurança Colaboradores :

    Captura de tela da página Grupos de segurança mostrando o grupo Colaboradores selecionado.

    Depois de selecionar o grupo de segurança, a página de configuração será aberta.

  4. Na página de configuração do grupo de segurança, selecione a guia Membros .

    O grupo de equipe padrão e quaisquer outras equipes definidas para o projeto são automaticamente incluídos como membros do grupo Colaboradores . Nesta guia, você seleciona outros usuários e grupos para se tornarem membros. Se você adicionar novos usuários a uma equipe de projeto, eles se tornarão automaticamente membros do grupo de segurança Colaboradores e obterão as permissões relacionadas.

    Dica

    Pode ser mais fácil gerenciar permissões para usuários trabalhando com grupos em vez de definir permissões no nível do usuário. Quando você define permissões para um grupo, todos os membros do grupo herdam as permissões de grupo. Em seguida, você pode ajustar permissões para usuários específicos no grupo, conforme necessário.

  5. Na guia Membros , selecione Adicionar:

    Captura de tela da página de configuração do grupo de segurança Colaboradores mostrando a opção Adicionar realçada.

  6. Insira o nome de exibição ou o endereço de email do usuário ou grupo a ser adicionado ao grupo de segurança. Selecione a entrada correspondente no sistema e, em seguida, selecione Salvar. Você também pode adicionar várias contas separando as entradas com um ponto-e-vírgula (;).

    Captura de tela da caixa de diálogo Convidar membros para o grupo de segurança (Colaboradores), escolha a conta de usuário a ser adicionada ao grupo.

    Depois de salvar suas seleções, a lista membros do grupo de segurança é atualizada para incluir os novos membros. Se você não vir os novos membros na lista, selecione Atualizar para atualizar o modo de exibição.

  7. (Opcional) Depois de adicionar usuários como membros do grupo de segurança, você pode personalizar as permissões para outras funcionalidades no projeto. Por exemplo, você pode ajustar permissões em áreas de acompanhamento de trabalho específicas e iterações ou consultas compartilhadas.

Selecione a guia Interface do Usuário Atual e siga as instruções para adicionar usuários a projetos. O recurso de visualização da página de configurações de permissões do projeto está disponível somente para o Azure DevOps Services.

Convidar usuários da página Resumo

Como membro do grupo Administradores do Projeto , você pode adicionar membros a um projeto na página Resumo e, opcionalmente, adicioná-los a uma ou mais equipes. Para obter mais informações, consulte Exibir e atualizar a página de resumo do projeto.

Observação

Para o Azure DevOps local, todas as ações de email exigem um servidor SMTP configurado.

  1. Abra a páginaResumo do> e selecione Convidar:

    Captura de tela da página Resumo do projeto mostrando a ação Convidar realçada.

  2. Insira o nome de exibição ou o endereço de email para o usuário convidar:

    • Para um usuário existente, insira as informações até que a caixa de diálogo mostre uma entrada correspondente no sistema. Selecione a entrada correspondente. Você pode adicionar vários usuários separando as entradas com um ponto-e-vírgula (;).

      Captura de tela da caixa de diálogo Convidar membros para um projeto, mostrando uma conta de usuário reconhecida.

    • Para um novo usuário não reconhecido pelo sistema, insira o endereço de email completo, incluindo o domínio, como fabrikam-user@fabrikam.com. Quando o usuário é desconhecido, uma notificação alerta que um nível de acesso deve ser atribuído.

      Captura de tela da caixa de diálogo Convidar membros para um projeto, mostrando um usuário novo ou desconhecido.

    Observação

    Qualquer endereço de email válido é aceitável. Quando o usuário aceita o convite e entra no Azure DevOps, ele registra seu endereço de email como uma conta da Microsoft e escolhe uma senha.

    Para concluir a ação, selecione Adicionar. Ou continue para a próxima etapa para escolher equipes para os novos usuários.

  3. (Opcional) Você pode selecionar quais equipes convidar o novo usuário para ingressar.

    Captura de tela da caixa de diálogo Convidar membros para um projeto, usuário conhecido, selecionando as equipes a serem adicionadas.

    Quando o usuário é desconhecido, uma notificação alerta que um nível de acesso deve ser atribuído:

    Captura de tela da caixa de diálogo Convidar membros para um projeto, usuário desconhecido, selecionando equipes a serem adicionadas.

    O sistema atribui o nível de acesso do Stakeholder para o novo usuário, quando todos os cinco níveis de acesso básicos (gratuitos) já estão atribuídos. Os colaboradores ativos de um projeto precisam ter o acesso Básico como um mínimo. Um Administrador de Coleção de Projetos pode alterar o nível de acesso e reenviar convites da páginaUsuários de > da Organização.

    Observação

    Os usuários com acesso limitado, como Participantes, não podem acessar recursos selecionados, mesmo que tenham recebido permissões para esses recursos. Para obter mais informações, consulte Permissões e acesso.

    Para concluir o convite, selecione Adicionar.

  4. (Opcional) Uma mensagem é exibida brevemente na tela para indicar sucesso ou falha. Selecione Detalhes para abrir a notificação e revisar os detalhes.

    Captura de tela da mensagem de êxito da notificação.

    Captura de tela da mensagem de falha de notificação.

    Uma mensagem de êxito indica o status de adicionar o usuário ao sistema.

    Uma mensagem de falha indica por que a adição do usuário falhou.

    Captura de tela da caixa de diálogo Notificação de Sucesso. ":::

    Captura de tela da caixa de diálogo Notificação de falha.

Quando a operação for bem-sucedida, novos usuários receberão um convite por email para entrar no projeto. Os usuários existentes não recebem uma notificação formal.

Gerenciar usuários ou reenviar convites

Os Administradores de Coleção de Projetos podem atualizar atribuições de usuário e reenviar convites. Para obter mais informações, consulte Adicionar usuários de conta para o Azure DevOps.

Captura de tela das opções para gerenciar usuários no menu Mais ações.

Listar membros da equipe ou detalhes da equipe

No comando da CLI do Azure DevOps, você pode ver detalhes sobre uma equipe ou listar os membros individuais:

  • Examine a lista de todas as equipes em sua organização com o az devops team list comando, conforme descrito na referência de comando.

  • Verifique os membros de uma equipe específica com o az devops team list-member comando, conforme descrito na seção Listar membros da equipe .

  • Examine os detalhes de uma equipe com o az devops team show comando, conforme descrito na seção Mostrar detalhes da equipe .

Observação

Você pode usar o az devops user comando para adicionar usuários a uma organização. Não há nenhum comando comparável para adicionar usuários a uma equipe ou projeto. Para obter mais informações, consulte Adicionar usuários à sua organização

Listar os membros da equipe

Você pode listar os membros individuais de uma equipe em sua organização com o comando az devops team list-member . Para obter mais informações, consulte Introdução à CLI do Azure DevOps.

az devops team list-member --team
                           [--detect {false, true}]
                           [--org --organization]
                           [--project]
                           [--skip]
                           [--top]

Parâmetros

  • equipe: obrigatório. Nome ou ID da equipe a ser mostrada. Detecte automaticamente a organização.
  • detect: Opcional. True ou False, detecte automaticamente a organização.
  • org: a URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não for configurado por padrão ou selecionado usando o git config comando. Exemplo: --org https://dev.azure.com/<My_Organization>/.
  • project: nome ou ID do projeto. Você pode configurar o projeto padrão usando o az devops configure -d project=NAME_OR_ID comando. Obrigatório se não for configurado por padrão ou selecionado usando o git config comando.
  • skip: opcional. Número de membros a serem ignoradas.
  • top: opcional. Número máximo de membros a serem retornados.

Exemplo

O comando a seguir lista os cinco primeiros membros da equipe chamada Fabrikam Team e retorna os detalhes no formato de tabela.

az devops team list-member --team "Fabrikam Team" --top 5 --output table

ID                                    Name               Email
------------------------------------  -----------------  --------------------------
3b5f0c34-4aec-4bf4-8708-1d36f0dbc468  Christie Church    fabrikamfiber1@fabrikam.com
19d9411e-9a34-45bb-b985-d24d9d87c0c9  Johnnie McLeod     fabrikamfiber2@fabrikam.com
8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d  Chuck Reinhart     fabrikamfiber3@fabrikam.com
d291b0c4-a05c-4ea6-8df1-4b41d5f39eff  Jamal Hartnett     fabrikamfiber4@fabrikam.com
bd30c189-db0f-4dd6-9418-5d8b41dc1754  Raisa Pokrovskaya  fabrikamfiber5@fabrikam.com

Mostrar detalhes da equipe

Você pode exibir detalhes sobre uma equipe em sua organização com o comando az devops team show . Para começar, confira Introdução à CLI do Azure DevOps.

az devops team show --team
                    [--detect {false, true}]
                    [--org --organization]
                    [--project]

Parâmetros

  • equipe: obrigatório. Nome ou ID da equipe a ser mostrada.
  • detect: Opcional. True ou False, detecte automaticamente a organização.
  • org: a URL da organização do Azure DevOps. Você pode configurar a organização padrão usando o az devops configure -d organization=ORG_URL comando. Obrigatório se não for configurado por padrão ou selecionado usando o git config comando. Exemplo: --org https://dev.azure.com/<My_Organization>/.
  • project: nome ou ID do projeto. Você pode configurar o projeto padrão usando o az devops configure -d project=NAME_OR_ID comando. Obrigatório se não for configurado por padrão ou selecionado usando o git config comando.

Exemplo

O comando a seguir mostra informações sobre a equipe em sua organização chamada Fabrikam Team e retorna os detalhes no formato de tabela.

az devops team show --team "Fabrikam Team" --output table

ID                                    Name          Description
------------------------------------  ------------  -------------------------------------------------
a48cb46f-7366-4f4b-baf5-b3632398ed1e  Fabrikam Team  The default project team. Was Fabrikam Fiber Team

Adicionar usuários ou grupos a um nível de acesso

Para implantações locais, talvez seja necessário definir o nível de acesso para um usuário ou grupo, especialmente se os grupos não pertencerem ao nível de acesso padrão. Para obter mais informações, consulte Alterar níveis de acesso.

Adicionar usuários ou grupos a relatórios SQL Server

Se a sua implantação local estiver integrada ao SQL Server Reports, você deverá gerenciar a associação a esses produtos separadamente dos respectivos sites. Para obter mais informações, consulte Conceder permissões para exibir ou criar relatórios do SQL Server no Azure DevOps Server.