Set-CsTeamsMessagingPolicy
The CsTeamsMessagingPolicy cmdlets enable administrators to control if a user is enabled to exchange messages. These also help determine the type of messages users can create and modify.
Syntax
Set-CsTeamsMessagingPolicy
[[-Identity] <XdsIdentity>]
[-AllowChatWithGroup <Boolean>]
[-AllowCommunicationComplianceEndUserReporting <Boolean>]
[-AllowCustomGroupChatAvatars <Boolean>]
[-AllowExtendedWorkInfoInSearch <String>]
[-AllowFluidCollaborate <Boolean>]
[-AllowFullChatPermissionUserToDeleteAnyMessage <Boolean>]
[-AllowGiphy <Boolean>]
[-AllowGiphyDisplay <Boolean>]
[-AllowGroupChatJoinLinks <Boolean>]
[-AllowImmersiveReader <Boolean>]
[-AllowMemes <Boolean>]
[-AllowOwnerDeleteMessage <Boolean>]
[-AllowPasteInternetImage <Boolean>]
[-AllowPriorityMessages <Boolean>]
[-AllowRemoveUser <Boolean>]
[-AllowSecurityEndUserReporting <Boolean>]
[-AllowSmartCompose] <Boolean>]
[-AllowSmartReply <Boolean>]
[-AllowStickers <Boolean>]
[-AllowUrlPreviews <Boolean>]
[-AllowUserChat <Boolean>]
[-AllowUserDeleteChat <Boolean>]
[-AllowUserDeleteMessage <Boolean>]
[-AllowUserEditMessage <Boolean>]
[-AllowUserTranslation <Boolean>]
[-AllowVideoMessages <Boolean>]
[-AudioMessageEnabledType <AudioMessageEnabledTypeEnum>]
[-ChannelsInChatListEnabledType <ChannelsInChatListEnabledTypeEnum>]
[-ChatPermissionRole <String>]
[-Confirm]
[-CreateCustomEmojis <Boolean>]
[-DeleteCustomEmojis <Boolean>]
[-Description <String>]
[-DesignerForBackgroundsAndImages <DesignerForBackgroundsAndImagesTypeEnum>]
[-Force]
[-GiphyRatingType <String>]
[-InOrganizationChatControl <String>]
[-ReadReceiptsEnabledType <String>]
[-Tenant <Guid>]
[-WhatIf]
[<CommonParameters>] Set-CsTeamsMessagingPolicy
[-Instance <PSObject>]
[-AllowChatWithGroup <Boolean>]
[-AllowCommunicationComplianceEndUserReporting <Boolean>]
[-AllowCustomGroupChatAvatars <Boolean>]
[-AllowExtendedWorkInfoInSearch <String>]
[-AllowFluidCollaborate <Boolean>]
[-AllowFullChatPermissionUserToDeleteAnyMessage <Boolean>]
[-AllowGiphy <Boolean>]
[-AllowGiphyDisplay <Boolean>]
[-AllowGroupChatJoinLinks <Boolean>]
[-AllowImmersiveReader <Boolean>]
[-AllowMemes <Boolean>]
[-AllowOwnerDeleteMessage <Boolean>]
[-AllowPasteInternetImage <Boolean>]
[-AllowPriorityMessages <Boolean>]
[-AllowRemoveUser <Boolean>]
[-AllowSecurityEndUserReporting <Boolean>]
[-AllowSmartCompose] <Boolean>]
[-AllowSmartReply <Boolean>]
[-AllowStickers <Boolean>]
[-AllowUrlPreviews <Boolean>]
[-AllowUserChat <Boolean>]
[-AllowUserDeleteChat <Boolean>]
[-AllowUserDeleteMessage <Boolean>]
[-AllowUserEditMessage <Boolean>]
[-AllowUserTranslation <Boolean>]
[-AllowVideoMessages <Boolean>]
[-AudioMessageEnabledType <AudioMessageEnabledTypeEnum>]
[-ChannelsInChatListEnabledType <ChannelsInChatListEnabledTypeEnum>]
[-Confirm]
[-CreateCustomEmojis <Boolean>]
[-DeleteCustomEmojis <Boolean>]
[-Description <String>]
[-DesignerForBackgroundsAndImages <DesignerForBackgroundsAndImagesTypeEnum>]
[-Force]
[-GiphyRatingType <String>]
[-InOrganizationChatControl <String>]
[-ReadReceiptsEnabledType <String>]
[-Tenant <Guid>]
[-WhatIf]
[<CommonParameters>] Description
The CsTeamsMessagingPolicy cmdlets enable administrators to control if a user is enabled to exchange messages. These also help determine the type of messages users can create and modify. This cmdlet updates a Teams messaging policy. Custom policies can then be assigned to users using the Grant-CsTeamsMessagingPolicy cmdlet.
Examples
Example 1
PS C:\> Set-CsTeamsMessagingPolicy -Identity StudentMessagingPolicy -AllowGiphy $false -AllowMemes $falseIn this example two different property values are configured: AllowGiphy is set to false and AllowMemes is set to False. All other policy properties will be left as previously assigned.
Example 2
PS C:\> Get-CsTeamsMessagingPolicy -Identity StudentMessagingPolicy | Set-CsTeamsMessagingPolicy -AllowGiphy $false -AllowMemes $falseIn this example two different property values are configured for all teams messaging policies in the organization: AllowGiphy is set to false and AllowMemes is set to False. All other policy properties will be left as previously assigned.
Parameters
-AllowChatWithGroup
This setting determines if users can chat with groups (Distribution, M365 and Security groups). Possible values: True, False
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowCommunicationComplianceEndUserReporting
This setting determines if users can report offensive messages to their admin for Communication Compliance. Possible Values: True, False
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowCustomGroupChatAvatars
These settings enables, disables updating or fetching custom group chat avatars for the users included in the messaging policy. Possible values: True, False
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowExtendedWorkInfoInSearch
This setting enables/disables showing company name and department name in search results for MTO users.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowFluidCollaborate
This field enables or disables Fluid Collaborate feature for users. Possible values: True, False
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowFullChatPermissionUserToDeleteAnyMessage
This setting determines if users with the 'Full permissions' role can delete any group or meeting chat message within their tenant. Possible values: True, False
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowGiphy
Determines whether a user is allowed to access and post Giphys. Set this to TRUE to allow. Set this FALSE to prohibit.
Note: Optional Connected Experiences must be also enabled for Giphys to be allowed.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowGiphyDisplay
Determines if Giphy images should be displayed that had been already sent or received in chat. Possible values: True, False
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowGroupChatJoinLinks
This setting determines if users in a group chat can create and share join links for other users within the organization to join that chat. Possible values: True, False
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowImmersiveReader
Determines whether a user is allowed to use Immersive Reader for reading conversation messages. Set this to TRUE to allow. Set this FALSE to prohibit.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowMemes
Determines whether a user is allowed to access and post memes. Set this to TRUE to allow. Set this FALSE to prohibit.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowOwnerDeleteMessage
Determines whether owners are allowed to delete all the messages in their team. Set this to TRUE to allow. Set this to FALSE to prohibit.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowPasteInternetImage
Determines if a user is allowed to paste internet-based images in compose. Possible values: True, False
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowPriorityMessages
Determines whether a user is allowed to send priority messages. Set this to TRUE to allow. Set this FALSE to prohibit.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowRemoveUser
Determines whether a user is allowed to remove a user from a conversation. Set this to TRUE to allow. Set this FALSE to prohibit.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowSecurityEndUserReporting
This setting determines if users can report any security concern posted in message to their admin. Possible values: True, False
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowSmartCompose
Turn on this setting to let a user get text predictions for chat messages.
| Type: | Boolean |
| Position: | Con nombre |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowSmartReply
Turn this setting on to enable suggested replies for chat messages. Set this to TRUE to allow. Set this to FALSE to prohibit.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowStickers
Determines whether a user is allowed to access and post stickers. Set this to TRUE to allow. Set this FALSE to prohibit.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowUrlPreviews
Use this setting to turn automatic URL previewing on or off in messages. Set this to TRUE to turn on. Set this to FALSE to turn off.
Note that Optional Connected Experiences must be also enabled for URL previews to be allowed.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowUserChat
Determines whether a user is allowed to chat. Set this to TRUE to allow a user to chat across private chat, group chat and in meetings. Set this to FALSE to prohibit all chat.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowUserDeleteChat
Turn this setting on to allow users to permanently delete their 1:1, group chat, and meeting chat as participants (this deletes the chat only for them, not other users in the chat). Set this to TRUE to allow. Set this to FALSE to prohibit.
| Type: | Boolean |
| Position: | Named |
| Default value: | TRUE |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowUserDeleteMessage
Determines whether a user is allowed to delete their own messages. Set this to TRUE to allow. Set this to FALSE to prohibit. If this value is set to FALSE, the team owner will not be able to delete their own messages.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowUserEditMessage
Determines whether a user is allowed to edit their own messages. Set this to TRUE to allow. Set this to FALSE to prohibit.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowUserTranslation
Determines whether a user is allowed to translate messages to their client languages. Set this to TRUE to allow. Set this to FALSE to prohibit.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowVideoMessages
This setting determines if users can create and send video messages. Possible values: True, False
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AudioMessageEnabledType
Determines whether a user is allowed to send audio messages. Possible values are: ChatsAndChannels, ChatsOnly, Disabled.
| Type: | AudioMessageEnabledTypeEnum |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ChannelsInChatListEnabledType
On mobile devices, enable to display favorite channels above recent chats.
Possible values are: DisabledUserOverride, EnabledUserOverride.
| Type: | ChannelsInChatListEnabledTypeEnum |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ChatPermissionRole
Determines the Supervised Chat role of the user. Set this to Full to allow the user to supervise chats. Supervisors have the ability to initiate chats with and invite any user within the environment. Set this to Limited to allow the user to initiate conversations with Full and Limited permissioned users, but not Restricted. Set this to Restricted to block chat creation with anyone other than Full permissioned users.
| Type: | String |
| Position: | Named |
| Default value: | Restricted |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CreateCustomEmojis
This setting enables the creation of custom emojis and reactions within an organization for the specified policy users.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeleteCustomEmojis
These settings enable and disable the editing and deletion of custom emojis and reactions for the users included in the messaging policy.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Provide a description of your policy to identify purpose of creating it.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DesignerForBackgroundsAndImages
This setting determines whether a user is allowed to create custom AI-powered backgrounds and images with MS Designer.
Possible values are: Enabled, Disabled.
| Type: | DesignerForBackgroundsAndImagesTypeEnum |
| Position: | Named |
| Default value: | Enabled |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-GiphyRatingType
Determines the Giphy content restrictions applicable to a user. Set this to STRICT, MODERATE or NORESTRICTION.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Identity
Identity for the teams messaging policy you're modifying. To modify the global policy, use this syntax: -Identity global. To modify a per-user policy, use syntax similar to this: -Identity TeamsMessagingPolicy.
If you do not specify an Identity the Set-CsTeamsMessagingPolicy cmdlet will automatically modify the global policy.
| Type: | XdsIdentity |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InOrganizationChatControl
This setting determines if chat regulation for internal communication in the tenant is allowed.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Instance
Allows you to pass a reference to an object to the cmdlet rather than set individual parameter values.
| Type: | PSObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReadReceiptsEnabledType
Use this setting to specify whether read receipts are user controlled, enabled for everyone, or disabled. Set this to UserPreference, Everyone or None.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tenant
Globally unique identifier (GUID) of the tenant account whose external user communication policy are being created. For example:
-Tenant "38aad667-af54-4397-aaa7-e94c79ec2308"
You can return your tenant ID by running this command:
Get-CsTenant | Select-Object DisplayName, TenantID
If you are using a remote session of Windows PowerShell and are connected only to Skype for Business Online you do not have to include the Tenant parameter. Instead, the tenant ID will automatically be filled in for you based on your connection information. The Tenant parameter is primarily for use in a hybrid deployment.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
System.Management.Automation.PSObject
Outputs
System.Object