Commands › Microsoft Teams

Grant-CsTeamsUpdateManagementPolicy

Use this cmdlet to grant a specific Teams Update Management policy to a user.

Quick start script

# Grant-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
Grant-CsTeamsUpdateManagementPolicy -Group <String> | Format-List

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

Syntax — 3 parameter sets

Identity (Default)

Grant-CsTeamsUpdateManagementPolicy [[-Identity] <String>] [-PassThru] [[-PolicyName] <String>]
 [-MsftInternalProcessingMode <String>] [-ProgressAction <ActionPreference>]
 [<CommonParameters>]

GrantToTenant

Grant-CsTeamsUpdateManagementPolicy [-PassThru] [[-PolicyName] <String>] [-MsftInternalProcessingMode <String>]
 [-Global] [-ProgressAction <ActionPreference>] [<CommonParameters>]

GrantToGroup

Grant-CsTeamsUpdateManagementPolicy [-PassThru] [[-PolicyName] <String>] [-MsftInternalProcessingMode <String>]
 [-Group] <String> [-Rank <Int32>] [-ProgressAction <ActionPreference>]
 [<CommonParameters>]

Parameters (6)

Parameter	Type	Required	What it controls
-Global	SwitchParameter		Use this parameter to make the specified policy in -PolicyName the new effective global policy.
-Group	String	yes	Specifies the group used for the group policy assignment.
-Identity	String		Indicates the identity of the user account the policy should be assigned to.
-PassThru	SwitchParameter		Including this parameter (which does not take a value) displays the user information when the cmdlet completes. Normally there is no output when this cmdlet is run.
-PolicyName	String		The identity of the policy to be granted.
-Rank	Int32		The rank of the policy assignment, relative to other group policy assignments for the same policy type.

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