Condividi tramite


Distribuire team statici in prima linea su larga scala con PowerShell per i lavoratori in prima linea

Panoramica

L'organizzazione usa un numero elevato di team per promuovere la comunicazione e la collaborazione tra la forza lavoro in prima linea? Questo articolo è destinato all'utente se è necessario creare e gestire team su larga scala.

È possibile usare PowerShell per distribuire fino a 500 team e aggiungere fino a 25 utenti per ogni team alla volta. È anche possibile aggiungere e rimuovere utenti da team esistenti su larga scala. Usare questa soluzione per soddisfare le esigenze di scalabilità dell'organizzazione e ridurre significativamente i tempi di distribuzione.

La distribuzione di Teams su larga scala consente di:

  • Creare team usando modelli predefiniti o modelli personalizzati.
  • aggiungere utenti ai team come proprietari o membri.
  • gestire i team su larga scala aggiungendo o rimuovendo gli utenti dai team esistenti.
  • Ricevere notifiche tramite posta elettronica, inclusi completamento, stato ed eventuali errori. È possibile scegliere di inviare una notifica allo stato di ogni batch di team distribuito a un massimo di cinque persone. I proprietari e i membri del team ricevono automaticamente una notifica quando vengono aggiunti a un team.

Questo articolo illustra come distribuire Teams su larga scala.

Panoramica dei passaggi per la distribuzione di Teams su larga scala.

Configurare e distribuire i team

Importante

I proprietari del team devono avere una licenza di Teams. Prima di usare questi passaggi per distribuire i team, assicurarsi che tutti i proprietari dei team dispongano di una licenza.

Seguire questa procedura per distribuire fino a 500 team alla volta.

Passaggio 1: Preparare i file CSV

Creare due file CSV per ogni batch di team distribuiti:

  • File CSV che definisce i team che si stanno creando. Questo file deve avere una riga del titolo e deve contenere le colonne necessarie nell'ordine seguente, a partire dalla prima colonna:

    Nome colonna Descrizione
    Nome team Nome del team.
    ID team esistente Se si aggiungono o si rimuovono utenti da un team esistente, specificare l'ID del team.
    Visibilità Se il team è pubblico (chiunque nell'organizzazione può partecipare) o privato (gli utenti hanno bisogno dell'approvazione dei proprietari del team per partecipare). Le opzioni sono Pubblica e Privata.
    ID modello di team Se si crea un team da un modello predefinito o personalizzato, specificare l'ID modello del team. Vedere Introduzione ai modelli di team nell'interfaccia di amministrazione di Teams per un elenco di modelli di team predefiniti e ID. Se si vuole usare il modello di team predefinito standard, lasciare vuoto questo valore.
  • File CSV che esegue il mapping degli utenti aggiunti a ogni team. Questo file deve avere una riga del titolo e deve contenere le colonne necessarie nell'ordine seguente, a partire dalla prima colonna:

    Nome colonna Descrizione
    Nome completo utente Il nome visualizzato per l'utente corrente.
    UPN o ID utente Nome dell'entità utente (UPN) o ID dell'utente. Ad esempio, averyh@contoso.com.
    Nome team Nome del team.
    ActionType Sia che si stia aggiungendo o rimuovendo l'utente dal team. Le opzioni sono AddMember e RemoveMember.
    Proprietario o membro Indica se l'utente è un proprietario del team o un membro del team. Le opzioni sono Owner e Member.

    Nota

    In questo file CSV è anche possibile assegnare più utenti come proprietari del team per qualsiasi team, inclusi i team dinamici in prima linea creati nell'interfaccia di amministrazione di Teams tramite l'esperienza di distribuzione di team dinamici in prima linea.

Esempi

Usare gli esempi seguenti per creare i file CSV. Qui sono stati denominati i file, Teams.csv e Users.csv.

Teams.csv

Nome team ID team esistente Visibilità ID modello di team
Contoso Store 1 Pubblico com.microsoft.teams.template.retailStore
Contoso Store 2 Pubblico com.microsoft.teams.template.retailStore
Contoso Store 3 Pubblico com.microsoft.teams.template.retailStore
Contoso Store 4 Pubblico com.microsoft.teams.template.retailStore
Contoso Store 5 Pubblico com.microsoft.teams.template.ManageAProject
Contoso Store 6 Pubblico com.microsoft.teams.template.ManageAProject
Contoso Store 7 Pubblico
Contoso Store 8 Private com.microsoft.teams.template.OnboardEmployees
Contoso Store 9 Private com.microsoft.teams.template.OnboardEmployees
Contoso Store 10 Private com.microsoft.teams.template.OnboardEmployees

Users.csv

Nome completo utente UPN o ID utente Nome team ActionType Proprietario o membro
Avery Howard averyh@contoso.com Contoso Store 1 AddMember Owner
Casey Jensen caseyj@contoso.com Contoso Store 2 AddMember Owner
Jessie Irwin jessiei@contoso.com Contoso Store 3 AddMember Owner
Manjeet Bhatia manjeetb@contoso.com Contoso Store 4 AddMember Owner
Mikaela Lee mikaelal@contoso.com Contoso Store 5 AddMember Owner
Morgan Conners morganc@contoso.com Contoso Store 6 AddMember Member
Oscar Ward oscarw@contoso.com Contoso Store 7 AddMember Member
Rene Pelletier renep@contoso.com Contoso Store 8 AddMember Member
Sydney Mattos sydneym@contoso.com Contoso Store 9 AddMember Member
Violet Martinez violetm@contoso.com Contoso Store 10 AddMember Member

Passaggio 2: Configurare l'ambiente

Seguire questa procedura per installare e connettersi alla versione più recente del modulo PowerShell di Teams.

  1. Installare PowerShell versione 7 o successiva. Per istruzioni dettagliate, vedere Installazione di PowerShell in Windows.

  2. Esegui Powershell in modalità Amministratore.

  3. Eseguire quanto segue per disinstallare qualsiasi modulo di PowerShell di Teams installato in precedenza.

    Uninstall-module -Name MicrosoftTeams -Force -Allversions
    

    Se viene visualizzato un messaggio di errore, è già stato impostato. Procedere con il passaggio successivo.

  4. Scaricare e installare la versione più recente del modulo PowerShell di Teams. È necessario eseguire la versione 4.7.0 (anteprima) o una versione successiva.

  5. Eseguire quanto segue per connettersi a Teams.

    Connect-MicrosoftTeams
    

    Quando viene richiesto, accedere usando le credenziali di amministratore.

  6. Eseguire quanto segue per ottenere un elenco dei comandi nel modulo PowerShell di Teams.

    Get-Command -Module MicrosoftTeams
    

    Verificare che New-CsBatchTeamsDeployment e Get-CsBatchTeamsDeploymentStatus siano elencati.

Passaggio 3: Distribuire i team

Dopo aver creato i file CSV e aver configurato l'ambiente, è possibile distribuire i team.

Usare il cmdlet New-CsBatchTeamsDeployment per inviare un batch di team da creare. Viene generato un ID di orchestrazione per ogni batch. È quindi possibile usare il cmdlet Get-CsBatchTeamsDeploymentStatus per tenere traccia dello stato e dello stato di ogni batch.

  1. Eseguire quanto segue per distribuire un batch di team. In questo comando si specifica il percorso dei file CSV e gli indirizzi di posta elettronica di un massimo di cinque destinatari per la notifica di questa distribuzione.

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

    I destinatari riceveranno notifiche tramite posta elettronica sullo stato della distribuzione. Il messaggio di posta elettronica contiene l'ID di orchestrazione per il batch inviato e gli eventuali errori che potrebbero essersi verificati.

    Ad esempio:

    New-CsBatchTeamsDeployment -TeamsFilePath "C:\dscale\Teams.csv" -UsersFilePath "C:\dscale\Users.csv" -UsersToNotify "adminteams@contoso.com,adelev@contoso.com"
    
  2. Eseguire quanto segue per controllare lo stato del batch inviato.

    Get-CsBatchTeamsDeploymentStatus -OrchestrationId "OrchestrationId"
    

Ottenere analisi sull'utilizzo dei team in prima linea

Il report sull'utilizzo di Teams nell'interfaccia di amministrazione di Teams offre una panoramica dell'attività di utilizzo in Teams. È possibile usare il report per visualizzare i dettagli di utilizzo per i team in prima linea, inclusi gli utenti attivi, i canali attivi, le riunioni organizzate totali, la data dell'ultima attività e altre informazioni.

  1. Nel riquadro di spostamento a sinistra dell'interfaccia di amministrazione di Teamsscegliere Analisi & report>Utilizzo report.

  2. Nella scheda Visualizza report , in Report, selezionare Utilizzo di Teams.

  3. In Intervallo di date selezionare un intervallo di date di 7 giorni, 30 giorni, 90 giorni o 180 giorni. Scegliere quindi Esegui report.

  4. Nell'angolo in alto a destra selezionare Esporta in Excel>Esporta tabella come CSV.

  5. Filtrare il foglio di calcolo in base agli ID del team in prima linea.

    Nota

    Gli ID del team in prima linea sono elencati nell'output di PowerShell quando si distribuiscono i team.