Commands › Microsoft Teams
New-CsBatchTeamsDeployment
This cmdlet is used to run a batch deployment orchestration.
Quick start script
# New-CsBatchTeamsDeployment — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-MicrosoftTeams -CertificateThumbprint $thumb -ApplicationId $appId -TenantId $tenantId
# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-CsBatchTeamsDeployment
$before | Format-List
# 3. Make the change (dry run first)
New-CsBatchTeamsDeployment -TeamsFilePath <String> -UsersFilePath <String> -WhatIf
New-CsBatchTeamsDeployment -TeamsFilePath <String> -UsersFilePath <String>
# 4. Verify and diff
$after = Get-CsBatchTeamsDeployment
Compare-Object ($before | Out-String) ($after | Out-String)Syntax
New-CsBatchTeamsDeployment -TeamsFilePath <String> -UsersFilePath <String>
-UsersToNotify <string> [-WhatIf] [-Confirm] [<CommonParameters>]Parameters (3)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -TeamsFilePath | String | yes | The path to the CSV file that defines the teams you're creating. For information about the CSV file format, see [Deploy Teams at scale for frontline... |
| -UsersFilePath | String | yes | The path to the CSV file that maps the users you're adding to each team. For information about the CSV file format, see [Deploy Teams at scale for frontline... |
| -UsersToNotify | String | The email addresses of up to five recipients to notify about this deployment. The recipients will receive email notifications about deployment status. The email contains the orchestration ID for the batch you... |
Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.