|
| 1 | +--- |
| 2 | +external help file: Microsoft.Teams.Policy.Administration.Cmdlets.Core.dll-Help.xml |
| 3 | +Module Name: MicrosoftTeams |
| 4 | +online version: https://learn.microsoft.com/powershell/module/teams/Set-CsTeamsMessagingConfiguration |
| 5 | +schema: 2.0.0 |
| 6 | +--- |
| 7 | + |
| 8 | +# Set-CsTeamsMessagingConfiguration |
| 9 | + |
| 10 | +## SYNOPSIS |
| 11 | + |
| 12 | +The TeamsMessagingConfiguration determines the messaging settings for users in your tenant. |
| 13 | + |
| 14 | +## SYNTAX |
| 15 | + |
| 16 | +```powershell |
| 17 | +Set-CsTeamsMessagingConfiguration [-EnableVideoMessageCaptions <Boolean>] |
| 18 | + [-EnableInOrganizationChatControl <Boolean>] [-CustomEmojis <Boolean>] [-Identity] <String> [-Force] [-WhatIf] |
| 19 | + [-Confirm] [<CommonParameters>] |
| 20 | +``` |
| 21 | + |
| 22 | +## DESCRIPTION |
| 23 | + |
| 24 | +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. |
| 25 | + |
| 26 | +## EXAMPLES |
| 27 | + |
| 28 | +### Example 1 |
| 29 | + |
| 30 | +```powershell |
| 31 | +PS C:\> Set-CsTeamsMessagingConfiguration -CustomEmojis $False |
| 32 | +``` |
| 33 | + |
| 34 | +The command shown in example 1 disables custom emojis within Teams. |
| 35 | + |
| 36 | +## PARAMETERS |
| 37 | + |
| 38 | +### -Confirm |
| 39 | + |
| 40 | +Prompts you for confirmation before running the cmdlet. |
| 41 | + |
| 42 | +```yaml |
| 43 | +Type: SwitchParameter |
| 44 | +Parameter Sets: (All) |
| 45 | +Aliases: cf |
| 46 | + |
| 47 | +Required: False |
| 48 | +Position: Named |
| 49 | +Default value: None |
| 50 | +Accept pipeline input: False |
| 51 | +Accept wildcard characters: False |
| 52 | +``` |
| 53 | +
|
| 54 | +### -CustomEmojis |
| 55 | +
|
| 56 | +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. |
| 57 | +Possible Values: True, False |
| 58 | +
|
| 59 | +```yaml |
| 60 | +Type: Boolean |
| 61 | +Parameter Sets: (All) |
| 62 | +Aliases: |
| 63 | + |
| 64 | +Required: False |
| 65 | +Position: Named |
| 66 | +Default value: None |
| 67 | +Accept pipeline input: False |
| 68 | +Accept wildcard characters: False |
| 69 | +``` |
| 70 | +
|
| 71 | +### -EnableInOrganizationChatControl |
| 72 | +
|
| 73 | +This setting determines if chat regulation for internal communication in tenant is allowed. |
| 74 | +Possible Values: True, False |
| 75 | +
|
| 76 | +```yaml |
| 77 | +Type: Boolean |
| 78 | +Parameter Sets: (All) |
| 79 | +Aliases: |
| 80 | + |
| 81 | +Required: False |
| 82 | +Position: Named |
| 83 | +Default value: None |
| 84 | +Accept pipeline input: False |
| 85 | +Accept wildcard characters: False |
| 86 | +``` |
| 87 | +
|
| 88 | +### -EnableVideoMessageCaptions |
| 89 | +
|
| 90 | + This setting determines if closed captions will be displayed, for Teams Video Clips, during playback. |
| 91 | + Possible values: True, False |
| 92 | +
|
| 93 | +```yaml |
| 94 | +Type: Boolean |
| 95 | +Parameter Sets: (All) |
| 96 | +Aliases: |
| 97 | + |
| 98 | +Required: False |
| 99 | +Position: Named |
| 100 | +Default value: None |
| 101 | +Accept pipeline input: False |
| 102 | +Accept wildcard characters: False |
| 103 | +``` |
| 104 | +
|
| 105 | +### -Force |
| 106 | +
|
| 107 | +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. |
| 108 | +
|
| 109 | +```yaml |
| 110 | +Type: SwitchParameter |
| 111 | +Parameter Sets: (All) |
| 112 | +Aliases: |
| 113 | + |
| 114 | +Required: False |
| 115 | +Position: Named |
| 116 | +Default value: None |
| 117 | +Accept pipeline input: False |
| 118 | +Accept wildcard characters: False |
| 119 | +``` |
| 120 | +
|
| 121 | +### -Identity |
| 122 | +
|
| 123 | +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. |
| 124 | +
|
| 125 | +```yaml |
| 126 | +Type: String |
| 127 | +Parameter Sets: (All) |
| 128 | +Aliases: |
| 129 | + |
| 130 | +Required: True |
| 131 | +Position: 1 |
| 132 | +Default value: None |
| 133 | +Accept pipeline input: False |
| 134 | +Accept wildcard characters: False |
| 135 | +``` |
| 136 | +
|
| 137 | +### -WhatIf |
| 138 | +
|
| 139 | +Shows what would happen if the cmdlet runs. |
| 140 | +The cmdlet is not run. |
| 141 | +
|
| 142 | +```yaml |
| 143 | +Type: SwitchParameter |
| 144 | +Parameter Sets: (All) |
| 145 | +Aliases: wi |
| 146 | + |
| 147 | +Required: False |
| 148 | +Position: Named |
| 149 | +Default value: None |
| 150 | +Accept pipeline input: False |
| 151 | +Accept wildcard characters: False |
| 152 | +``` |
| 153 | +
|
| 154 | +### CommonParameters |
| 155 | +
|
| 156 | +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). |
| 157 | +
|
| 158 | +## INPUTS |
| 159 | +
|
| 160 | +### None |
| 161 | +
|
| 162 | +## OUTPUTS |
| 163 | +
|
| 164 | +### System.Void |
| 165 | +
|
| 166 | +## NOTES |
| 167 | +
|
| 168 | +## RELATED LINKS |
| 169 | +
|
| 170 | +[Get-CsTeamsMeetingConfiguration](get-csteamsmeetingconfiguration.md) |
0 commit comments