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.
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
eRemoveMember
.Proprietario o membro Indica se l'utente è un proprietario del team o un membro del team. Le opzioni sono Owner
eMember
.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.
Installare PowerShell versione 7 o successiva. Per istruzioni dettagliate, vedere Installazione di PowerShell in Windows.
Esegui Powershell in modalità Amministratore.
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.
Scaricare e installare la versione più recente del modulo PowerShell di Teams. È necessario eseguire la versione 4.7.0 (anteprima) o una versione successiva.
Eseguire quanto segue per connettersi a Teams.
Connect-MicrosoftTeams
Quando viene richiesto, accedere usando le credenziali di amministratore.
Eseguire quanto segue per ottenere un elenco dei comandi nel modulo PowerShell di Teams.
Get-Command -Module MicrosoftTeams
Verificare che
New-CsBatchTeamsDeployment
eGet-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.
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"
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.
Nel riquadro di spostamento a sinistra dell'interfaccia di amministrazione di Teamsscegliere Analisi & report>Utilizzo report.
Nella scheda Visualizza report , in Report, selezionare Utilizzo di Teams.
In Intervallo di date selezionare un intervallo di date di 7 giorni, 30 giorni, 90 giorni o 180 giorni. Scegliere quindi Esegui report.
Nell'angolo in alto a destra selezionare Esporta in Excel>Esporta tabella come CSV.
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.