Commands › Microsoft Teams

Grant-CsTeamsMessagingPolicy

Assigns a teams messaging policy at the per-user scope. Teams messaging policies determine the features and capabilities that can be used in messaging within the teams client.

Quick start script

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

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

Syntax — 3 parameter sets

Identity (Default)

Grant-CsTeamsMessagingPolicy [[-Identity] <String>] [-PassThru] [[-PolicyName] <String>]
 [-WhatIf] [-Confirm] [<CommonParameters>]

GrantToTenant

Grant-CsTeamsMessagingPolicy [-PassThru] [[-PolicyName] <String>]
 [-Global] [-WhatIf] [-Confirm] [<CommonParameters>]

GrantToGroup

Grant-CsTeamsMessagingPolicy [-PassThru] [[-PolicyName] <String>]
 -Group <String> [-Rank <Int32>] [-WhatIf] [-Confirm] [<CommonParameters>]

Parameters (10)

Parameter	Type	Required	What it controls
-Confirm	SwitchParameter		Prompts you for confirmation before running the cmdlet.
-DomainController	Fqdn		This parameter is reserved for internal Microsoft use.
-Global	SwitchParameter		When you use this cmdlet without specifying a user identity, the policy applies to all users in your tenant. To skip a warning when you do this operation, specify "-Global".
-Group	String	yes	Specifies the group used for the group policy assignment.
-Identity	UserIdParameter		Indicates the Identity of the user account the policy should be assigned to. User Identities can be specified using one of four formats: 1) the user's SIP address; 2) the user principal name (UPN); 3) the user's...
-PassThru	SwitchParameter		{{ Fill PassThru Description }}
-PolicyName	String		The name of the custom policy that is being assigned to the user. To remove a specific assignment and fall back to the default tenant policy, you can assign to $Null.
-Rank	Int32		The rank of the policy assignment, relative to other group policy assignments for the same policy type.
-Tenant	Guid		{{ Fill Tenant Description }}
-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.