Commands › Microsoft Teams

Set-CsTeamsMessagingConfiguration

Microsoft Teams MicrosoftTeams Set-*

The TeamsMessagingConfiguration determines the messaging settings for users in your tenant.

Quick start script

# Set-CsTeamsMessagingConfiguration — 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-CsTeamsMessagingConfiguration
$before | Format-List

# 3. Make the change (dry run first)
Set-CsTeamsMessagingConfiguration -Identity <String> -WhatIf
Set-CsTeamsMessagingConfiguration -Identity <String>

# 4. Verify and diff
$after = Get-CsTeamsMessagingConfiguration
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax

Set-CsTeamsMessagingConfiguration [-Identity] <String>
 [-Confirm]
 [-CustomEmojis <Boolean>]
 [-EnableInOrganizationChatControl <Boolean>]
 [-EnableVideoMessageCaptions <Boolean>]
 [-FileTypeCheck <string>]
 [-Force]
 [-MessagingNotes <String>]
 [-UrlReputationCheck <string>]
 [-ContentBasedPhishingCheck <string>]
 [-ReportIncorrectSecurityDetections<string>]
 [-Communities <String>]
 [-WhatIf]
 [<CommonParameters>]

Parameters (13)

Parameter	Type	Required	What it controls
-Confirm	SwitchParameter		Prompts you for confirmation before running the cmdlet.
-ContentBasedPhishingCheck	String		This setting enables content-based phishing detection for Teams messages in the tenant.
-CustomEmojis	Boolean		This setting enables/disables the use of custom emojis and reactions across the whole tenant. Upon enablement, admins and/or users can define a user group that is allowed. Possible Values: True, False
-EnableInOrganizationChatControl	Boolean		This setting determines if chat regulation for internal communication in tenant is allowed. Possible Values: True, False
-EnableVideoMessageCaptions	Boolean		This setting determines if closed captions will be displayed, for Teams Video Clips, during playback. Possible values: True, False
-FileTypeCheck	String		This setting enables weaponizable file detection in Teams messages in the tenant.
-Force	SwitchParameter		The Force switch specifies whether to suppress warning and confirmation messages. It can be useful in scripting to suppress interactive prompts. If the Force switch isn't provided in the command, you're prompted for...
-Identity	String	yes	Specifies the collection of tenant messaging configuration settings to be returned. Because each tenant is limited to a single, global collection of messaging settings there is no need include this parameter when...
-MessagingNotes	String		This setting enables/disables MessagingNotes integration across the whole tenant. Possible Values: Disabled, Enabled
-ReportIncorrectSecurityDetections	String		This setting enables the end users to Report incorrect security detections in Teams messages in the tenant.
-UrlReputationCheck	String		This setting enables malicious URL detection in Teams messages in the tenant.
-Communities	String		This setting enables/disables Viva Engage Communities integration across the whole tenant.
-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.