Commands › Microsoft Teams

Get-CsTeamsUpdateManagementPolicy

Microsoft Teams MicrosoftTeams Get-*

Use this cmdlet to retrieve the current Teams Update Management policies in the organization.

App-only limitation executed read-only 12 Nov 2026 · module v8.0.0 — {"code":"Forbidden","message":"Access Denied.","action":"Provide different credential or request access."}

Quick start script

# Get-CsTeamsUpdateManagementPolicy — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-MicrosoftTeams -CertificateThumbprint $thumb -ApplicationId $appId -TenantId $tenantId

# 2. Run and inspect
Get-CsTeamsUpdateManagementPolicy | Format-List

# 3. Export for evidence / drift tracking
Get-CsTeamsUpdateManagementPolicy | Export-Clixml .\CsTeamsUpdateManagementPolicy-$(Get-Date -Format yyyyMMdd).xml

Syntax — 2 parameter sets

Identity (Default)

Get-CsTeamsUpdateManagementPolicy [[-Identity] <String>] [-ProgressAction <ActionPreference>]
 [<CommonParameters>]

Filter

Get-CsTeamsUpdateManagementPolicy [-Filter <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]

Parameters (2)

Parameter	Type	Required	What it controls
-Filter	String		This parameter accepts a wildcard string and returns all policies with identities matching that string. For example, a Filter value of tag:* will return all policies defined at the per-user level.
-Identity	String		The unique identifier of the policy.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.