Implantar equipes estáticas de linha de frente em escala com o PowerShell para trabalhadores de linha de frente

  • Artigo
  • Aplica-se a:
    Microsoft Teams, Microsoft 365 for frontline workers

Visão Geral

Sua organização usa um grande número de equipes para impulsionar a comunicação e a colaboração entre sua força de trabalho de linha de frente? Este artigo é para você se você precisar criar e gerenciar equipes em escala.

Você pode usar o PowerShell para implantar até 500 equipes e adicionar até 25 usuários por equipe por vez. Você também pode adicionar e remover usuários de equipes existentes em escala. Use essa solução para atender às necessidades de escala da sua organização e reduzir significativamente o tempo de implantação.

A implantação do Teams em escala permite:

  • Create equipes usando modelos predefinidos ou seus próprios modelos personalizados.
  • Adicione usuários às equipes como proprietários ou membros.
  • Gerencie equipes em escala adicionando ou removendo usuários de equipes existentes.
  • Mantenha-se notificado por email, incluindo conclusão, status e erros (se houver). Você pode optar por notificar até cinco pessoas sobre o status de cada lote de equipes implantadas. Os proprietários e membros da equipe são notificados automaticamente quando são adicionados a uma equipe.

Este artigo orienta como implantar o Teams em escala.

Visão geral das etapas de como implantar o Teams em escala.

Configurar e implantar suas equipes

Importante

Os proprietários da equipe devem ter uma licença do Teams. Antes de usar essas etapas para implantar suas equipes, verifique se todos os proprietários de equipes têm uma licença.

Siga estas etapas para implantar até 500 equipes por vez.

Etapa 1: Preparar seus arquivos CSV

Create dois arquivos CSV para cada lote de equipes que você implanta:

  • Um arquivo CSV que define as equipes que você está criando. Este arquivo deve ter uma linha de título e deve conter estas colunas necessárias, na ordem a seguir, começando com a primeira coluna:

    Nome da coluna Descrição
    Nome da Equipe O nome da equipe.
    ID da Equipe Existente Se você estiver adicionando ou removendo usuários de uma equipe existente, especifique a ID de equipe da equipe.
    Visibility Se a equipe é pública (qualquer pessoa em sua organização pode ingressar) ou privada (os usuários precisam de aprovação dos proprietários da equipe para ingressar). As opções são Pública e Privada.
    ID do Modelo de Equipe Se você estiver criando uma equipe a partir de um modelo predefinido ou personalizado, especifique a ID do modelo de equipe. Consulte Introdução aos modelos de equipe no centro de administração do Teams para obter uma lista de modelos e IDs de equipe predefinidos. Se você quiser usar o modelo de equipe padrão, deixe isso em branco.

  • Um arquivo CSV que mapeia os usuários que você está adicionando a cada equipe. Este arquivo deve ter uma linha de título e deve conter estas colunas necessárias, na ordem a seguir, começando com a primeira coluna:

    Nome da coluna Descrição
    Nome Completo do Usuário O nome de exibição do usuário.
    UPN ou ID do usuário O nome principal do usuário (UPN) ou a ID do usuário. Por exemplo, averyh@contoso.com.
    Nome da Equipe O nome da equipe.
    ActionType Se você está adicionando ou removendo o usuário da equipe. As opções são AddMember e RemoveMember.
    Proprietário ou Membro Se o usuário é um proprietário da equipe ou membro da equipe. As opções são Owner e Member.

Exemplos

Use os exemplos a seguir para ajudá-lo a criar seus arquivos CSV. Aqui, nomeamos os arquivos, Teams.csv e Users.csv.

Teams.csv

Nome da Equipe ID da Equipe Existente Visibilidade ID do Modelo de Equipe
Repositório Contoso 1 Público com.microsoft.teams.template.retailStore
Repositório Contoso 2 Público com.microsoft.teams.template.retailStore
Repositório Contoso 3 Público com.microsoft.teams.template.retailStore
Repositório Contoso 4 Público com.microsoft.teams.template.retailStore
Repositório Contoso 5 Público com.microsoft.teams.template.ManageAProject
Repositório Contoso 6 Público com.microsoft.teams.template.ManageAProject
Repositório Contoso 7 Público
Repositório Contoso 8 Privado com.microsoft.teams.template.OnboardEmployees
Repositório Contoso 9 Privado com.microsoft.teams.template.OnboardEmployees
Repositório Contoso 10 Privado com.microsoft.teams.template.OnboardEmployees

Users.csv

Nome Completo do Usuário UPN ou ID do usuário Nome da Equipe ActionType Proprietário ou Membro
Avery Howard averyh@contoso.com Repositório Contoso 1 AddMember Owner
Casey Jensen caseyj@contoso.com Repositório Contoso 2 AddMember Owner
Jessie Irwin jessiei@contoso.com Repositório Contoso 3 AddMember Owner
Manjeet Bhatia manjeetb@contoso.com Repositório Contoso 4 AddMember Owner
Mikaela Lee mikaelal@contoso.com Repositório Contoso 5 AddMember Owner
Morgan Conners morganc@contoso.com Repositório Contoso 6 AddMember Member
Oscar Ward oscarw@contoso.com Repositório Contoso 7 AddMember Member
Rene Pelletier renep@contoso.com Repositório Contoso 8 AddMember Member
Sydney Mattos sydneym@contoso.com Repositório Contoso 9 AddMember Member
Violet Martinez violetm@contoso.com Repositório Contoso 10 AddMember Member

Etapa 2: configurar seu ambiente

Siga estas etapas para instalar e conectar-se à versão mais recente do módulo do Teams PowerShell.

  1. Instale o PowerShell versão 7 ou posterior. Para obter orientações passo a passo, consulte Instalando o PowerShell no Windows.

  2. Execute o PowerShell no modo administrador.

  3. Execute o seguinte para desinstalar qualquer módulo do PowerShell do Teams instalado anteriormente.

    Uninstall-module -Name MicrosoftTeams -Force -Allversions

    Se você receber uma mensagem de erro, já estará definido. Vá para a etapa seguinte.

  4. Baixe e instale a versão mais recente do módulo do Teams PowerShell. Você deve estar executando a versão 4.7.0 (versão prévia) ou uma versão posterior.

  5. Execute o seguinte para se conectar ao Teams.

    Connect-MicrosoftTeams

    Quando for solicitado, entre usando suas credenciais de administrador.

  6. Execute o seguinte para obter uma lista dos comandos no módulo do PowerShell do Teams.

    Get-Command -Module MicrosoftTeams

    Verifique se New-CsBatchTeamsDeployment e Get-CsBatchTeamsDeploymentStatus estão listados.

Etapa 3: Implantar suas equipes

Agora que você criou seus arquivos CSV e configurou seu ambiente, está pronto para implantar suas equipes.

Você usa o cmdlet New-CsBatchTeamsDeployment para enviar um lote de equipes para criar. Uma ID de orquestração é gerada para cada lote. Em seguida, você pode usar o cmdlet Get-CsBatchTeamsDeploymentStatus para acompanhar o progresso e status de cada lote.

  1. Execute o seguinte para implantar um lote de equipes. Neste comando, você especifica o caminho para seus arquivos CSV e os endereços de email de até cinco destinatários para notificar sobre essa implantação.

    New-CsBatchTeamsDeployment -TeamsFilePath "Your CSV file path" -UsersFilePath "Your CSV file path" -UsersToNotify "Email addresses"

    Os destinatários receberão notificações por email sobre o status da implantação. O email contém a ID de orquestração do lote que você enviou e quaisquer erros que possam ter ocorrido.

    Por exemplo:

    New-CsBatchTeamsDeployment -TeamsFilePath "C:\dscale\Teams.csv" -UsersFilePath "C:\dscale\Users.csv" -UsersToNotify "adminteams@contoso.com,adelev@contoso.com"

  2. Execute o seguinte para verificar o status do lote enviado.

    Get-CsBatchTeamsDeploymentStatus -OrchestrationId "OrchestrationId"

Obter análise sobre o uso de equipes de linha de frente

O relatório de uso do Teams no centro de administração do Teams fornece uma visão geral da atividade de uso no Teams. Você pode usar o relatório para exibir detalhes de uso para suas equipes de linha de frente, incluindo usuários ativos, canais ativos, reuniões organizadas totais, última data da atividade e outras informações.

  1. Na navegação à esquerda do centro de administração do Teams, escolha Análise & relatórios>Relatórios de uso.

  2. Na guia Exibir relatórios , em Relatório, selecione Uso do Teams.

  3. Em Intervalo de datas, selecione um intervalo de datas de 7 dias, 30 dias, 90 dias ou 180 dias. Em seguida, escolha Executar relatório.

  4. No canto superior direito, selecione Exportar para atabela Exportar para Excel >como CSV.

  5. Filtre a planilha com base nas IDs da equipe de linha de frente.

    Observação

    Suas IDs da equipe de linha de frente são listadas na saída do PowerShell quando você implanta suas equipes.