Commands › Microsoft Teams
New-CsTeamsUpdateManagementPolicy
Use this cmdlet to create Teams Update Management policy.
Quick start script
# New-CsTeamsUpdateManagementPolicy — 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-CsTeamsUpdateManagementPolicy
$before | Format-List
# 3. Make the change (dry run first)
New-CsTeamsUpdateManagementPolicy -Identity <String> -WhatIf
New-CsTeamsUpdateManagementPolicy -Identity <String>
# 4. Verify and diff
$after = Get-CsTeamsUpdateManagementPolicy
Compare-Object ($before | Out-String) ($after | Out-String)Syntax
New-CsTeamsUpdateManagementPolicy
[-DisabledInProductMessages <System.Management.Automation.PSListModifier`1[System.String]>]
[-Description <String>] [-AllowManagedUpdates <Boolean>] [-AllowPreview <Boolean>] [-UpdateDayOfWeek <Int64>]
[-UpdateTime <String>] [-UpdateTimeOfDay <DateTime>] [-AllowPublicPreview <String>]
[-AllowPrivatePreview <AllowPrivatePreview>] [-UseNewTeamsClient <String>]
[-BlockLegacyAuthorization <Boolean>] [-Identity] <String> [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]Parameters (15)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -AllowManagedUpdates | Boolean | Enables/Disables managed updates for the user. | |
| -AllowPreview | Boolean | Indicates whether all feature flags are switched on or off. Can be set only when AllowManagedUpdates is set to True. | |
| -AllowPrivatePreview | AllowPrivatePreview | This setting will allow admins to allow users in their tenant to opt in to Private Preview. If it is Disabled, then users will not be able to opt in and the ring switcher UI will be hidden in the Desktop Client. If... | |
| -AllowPublicPreview | String | This setting will allow admins to allow users in their tenant to opt in to Public Preview. If it is Disabled, then users will not be able to opt in and the ring switcher UI will be hidden in the Desktop Client. If it... | |
| -BlockLegacyAuthorization | Boolean | This setting will force Teams clients to enforce session revocation for core Messaging and Calling/Meeting scenarios. If turned ON, session revocation will be enforced for calls, chats and meetings for opted-in... | |
| -Confirm | SwitchParameter | Prompts you for confirmation before running the cmdlet. | |
| -Description | String | Enables administrators to provide explanatory text about the policy. For example, the Description might indicate the users the policy should be assigned to. | |
| -DisabledInProductMessages | String] | List of IDs of the categories of the in-product messages that will be disabled. You can choose one of the categories from this table: | |
| -Force | SwitchParameter | Suppress all non-fatal errors. | |
| -Identity | String | yes | A unique identifier. |
| -UpdateDayOfWeek | Int64 | Machine local day. 0-6(Sun-Sat) Can be set only when AllowManagedUpdates is set to True. | |
| -UpdateTime | String | Machine local time in HH:MM format. Can be set only when AllowManagedUpdates is set to True. | |
| -UpdateTimeOfDay | DateTime | Machine local time. Can be set only when AllowManagedUpdates is set to True | |
| -UseNewTeamsClient | String | This setting will enable admins to show or hide which users see the Teams preview toggle on the current Teams client. If it is AdminDisabled, then users will not be able to see the Teams preview toggle in the Desktop... | |
| -WhatIf | SwitchParameter | Shows what would happen if the cmdlet runs. The cmdlet is not run. |
Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.