Set-CsTeamsMessagingConfiguration
The TeamsMessagingConfiguration determines the messaging settings for users in your tenant.
Syntax
Default (Default)
Set-CsTeamsMessagingConfiguration
[-Identity] <String>
[-Confirm]
[-CustomEmojis <Boolean>]
[-EnableInOrganizationChatControl <Boolean>]
[-EnableVideoMessageCaptions <Boolean>]
[-FileTypeCheck <string>]
[-Force]
[-MessagingNotes <String>]
[-UrlReputationCheck <string>]
[-ContentBasedPhishingCheck <string>]
[-ReportIncorrectSecurityDetections<string>]
[-WhatIf]
[<CommonParameters>]
Description
TeamsMessagingConfiguration determines the messaging settings for the users in your tenant. This cmdlet lets you update the user messaging options you'd like to enable in your organization.
Examples
Example 1
PS C:\> Set-CsTeamsMessagingConfiguration -CustomEmojis $False
The command shown in example 1 disables custom emojis within Teams.
Parameters
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ContentBasedPhishingCheck
Note
This feature has not been released.
This setting enables content-based phishing detection for Teams messages in the tenant.
Possible Values:
- Enabled
- Disabled
Parameter properties
| Type: | String |
| Default value: | Enabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-CustomEmojis
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
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-EnableInOrganizationChatControl
This setting determines if chat regulation for internal communication in tenant is allowed. Possible Values: True, False
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-EnableVideoMessageCaptions
This setting determines if closed captions will be displayed, for Teams Video Clips, during playback. Possible values: True, False
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-FileTypeCheck
Note
This parameter is in Private Preview.
This setting enables weaponizable file detection in Teams messages in the tenant.
Possible Values:
- Enabled
- Disabled
Parameter properties
| Type: | String |
| Default value: | Enabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Force
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 administrative input if required.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Identity
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 calling the cmdlet. If you do choose to use the Identity parameter you must also include the Tenant parameter.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 1 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-MessagingNotes
This setting enables/disables MessagingNotes integration across the whole tenant. Possible Values: Disabled, Enabled
Parameter properties
| Type: | String |
| Default value: | Enabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ReportIncorrectSecurityDetections
Note
This parameter is in Private Preview.
This setting enables the end users to Report incorrect security detections in Teams messages in the tenant.
Possible Values:
- Enabled
- Disabled
Parameter properties
| Type: | String |
| Default value: | Enabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-UrlReputationCheck
Note
This parameter is in Private Preview.
This setting enables malicious URL detection in Teams messages in the tenant.
Possible Values:
- Enabled
- Disabled
Parameter properties
| Type: | String |
| Default value: | Enabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.