Skip to content

Commit 57496db

Browse files
chrisdachrisda
authored
Merge pull request MicrosoftDocs#11749 from marco-ms/patch-2
[Doc][Messaging Policy] DesignerForBackgroundsAndImages cmd
2 parents b8b70db + 13b7404 commit 57496db

File tree

1 file changed

+137
-76
lines changed

1 file changed

+137
-76
lines changed

‎teams/teams-ps/teams/Set-CsTeamsMessagingPolicy.md

Lines changed: 137 additions & 76 deletions
Original file line numberDiff line numberDiff line change
@@ -19,28 +19,73 @@ The CsTeamsMessagingPolicy cmdlets enable administrators to control if a user is
1919

2020
### Identity (Default)
2121
```
22-
Set-CsTeamsMessagingPolicy [-Tenant <Guid>] [-Description <String>] [-AllowUrlPreviews <Boolean>]
23-
[-AllowOwnerDeleteMessage <Boolean>] [-AllowUserEditMessage <Boolean>] [-AllowUserDeleteMessage <Boolean>]
24-
[-AllowUserChat <Boolean>] [-AllowUserDeleteChat <Boolean>] [-AllowGiphy <Boolean>] [-GiphyRatingType <String>] [-AllowMemes <Boolean>]
25-
[-AllowStickers <Boolean>] [-AllowUserTranslation <Boolean>] [-AllowImmersiveReader <Boolean>]
26-
[-AllowRemoveUser <Boolean>] [-AllowPriorityMessages <Boolean>] [-AllowSmartReply <Boolean>] [-Allow [-ReadReceiptsEnabledType <String>]
27-
[-AudioMessageEnabledType <AudioMessageEnabledTypeEnum>] [-ChannelsInChatListEnabledType <ChannelsInChatListEnabledTypeEnum>]
28-
[[-Identity] <XdsIdentity>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>] [-ChatPermissionRole <String>] [-AllowSmartCompose] <Boolean>]
29-
[-CreateCustomEmojis <Boolean>] [-DeleteCustomEmojis <Boolean>]
22+
Set-CsTeamsMessagingPolicy [[-Identity] <XdsIdentity>]
23+
[-Allow [-ReadReceiptsEnabledType <String>]
24+
[-AllowGiphy <Boolean>]
25+
[-AllowImmersiveReader <Boolean>]
26+
[-AllowMemes <Boolean>]
27+
[-AllowOwnerDeleteMessage <Boolean>]
28+
[-AllowPriorityMessages <Boolean>]
29+
[-AllowRemoveUser <Boolean>]
30+
[-AllowSmartCompose] <Boolean>]
31+
[-AllowSmartReply <Boolean>]
32+
[-AllowStickers <Boolean>]
33+
[-AllowUrlPreviews <Boolean>]
34+
[-AllowUserChat <Boolean>]
35+
[-AllowUserDeleteChat <Boolean>]
36+
[-AllowUserDeleteMessage <Boolean>]
37+
[-AllowUserEditMessage <Boolean>]
38+
[-AllowUserTranslation <Boolean>]
39+
[-AudioMessageEnabledType <AudioMessageEnabledTypeEnum>]
40+
[-ChannelsInChatListEnabledType <ChannelsInChatListEnabledTypeEnum>]
41+
[-ChatPermissionRole <String>]
42+
[-Confirm]
43+
[-CreateCustomEmojis <Boolean>]
44+
[-DeleteCustomEmojis <Boolean>]
45+
[-Description <String>]
46+
[-DesignerForBackgroundsAndImages <DesignerForBackgroundsAndImagesTypeEnum>]
47+
[-Force]
48+
[-GiphyRatingType <String>]
49+
[-Tenant <Guid>]
50+
[-WhatIf]
51+
[<CommonParameters>]
3052
```
3153

3254
### Instance
3355
```
34-
Set-CsTeamsMessagingPolicy [-Tenant <Guid>] [-Description <String>] [-AllowUrlPreviews <Boolean>]
35-
[-AllowOwnerDeleteMessage <Boolean>] [-AllowUserEditMessage <Boolean>] [-AllowUserDeleteMessage <Boolean>]
36-
[-AllowUserChat <Boolean>] [-AllowUserDeleteChat <Boolean>] [-AllowGiphy <Boolean>] [-GiphyRatingType <String>] [-AllowMemes <Boolean>]
37-
[-AllowStickers <Boolean>] [-AllowUserTranslation <Boolean>] [-AllowImmersiveReader <Boolean>]
38-
[-AllowRemoveUser <Boolean>] [-AllowPriorityMessages <Boolean>] [-AllowSmartReply <Boolean>] [-ReadReceiptsEnabledType <String>]
39-
[-AudioMessageEnabledType <AudioMessageEnabledTypeEnum>] [-ChannelsInChatListEnabledType <ChannelsInChatListEnabledTypeEnum>] [-AllowSmartCompose] <Boolean>] [-CreateCustomEmojis <Boolean>] [-DeleteCustomEmojis <Boolean>] [-Instance <PSObject>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
56+
Set-CsTeamsMessagingPolicy [-Instance <PSObject>]
57+
[-AllowGiphy <Boolean>]
58+
[-AllowImmersiveReader <Boolean>]
59+
[-AllowMemes <Boolean>]
60+
[-AllowOwnerDeleteMessage <Boolean>]
61+
[-AllowPriorityMessages <Boolean>]
62+
[-AllowRemoveUser <Boolean>]
63+
[-AllowSmartCompose] <Boolean>]
64+
[-AllowSmartReply <Boolean>]
65+
[-AllowStickers <Boolean>]
66+
[-AllowUrlPreviews <Boolean>]
67+
[-AllowUserChat <Boolean>]
68+
[-AllowUserDeleteChat <Boolean>]
69+
[-AllowUserDeleteMessage <Boolean>]
70+
[-AllowUserEditMessage <Boolean>]
71+
[-AllowUserTranslation <Boolean>]
72+
[-AudioMessageEnabledType <AudioMessageEnabledTypeEnum>]
73+
[-ChannelsInChatListEnabledType <ChannelsInChatListEnabledTypeEnum>]
74+
[-Confirm]
75+
[-CreateCustomEmojis <Boolean>]
76+
[-DeleteCustomEmojis <Boolean>]
77+
[-Description <String>]
78+
[-DesignerForBackgroundsAndImages <DesignerForBackgroundsAndImagesTypeEnum>]
79+
[-Force]
80+
[-GiphyRatingType <String>]
81+
[-ReadReceiptsEnabledType <String>]
82+
[-Tenant <Guid>]
83+
[-WhatIf]
84+
[<CommonParameters>]
4085
```
4186

4287
## DESCRIPTION
43-
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.
88+
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.
4489

4590
## EXAMPLES
4691

@@ -62,26 +107,29 @@ PS C:\> Get-CsTeamsMessagingPolicy -Identity StudentMessagingPolicy | Set-CsTeam
62107
In 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.
63108
All other policy properties will be left as previously assigned.
64109

65-
66110
## PARAMETERS
67111

68-
### -CreateCustomEmojis
69-
This setting enables the creation of custom emojis and reactions within an organization for the specified policy users.
112+
### -Identity
113+
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`.
114+
115+
If you do not specify an Identity the Set-CsTeamsMessagingPolicy cmdlet will automatically modify the global policy.
70116

71117
```yaml
72-
Type: Boolean
118+
Type: Object
73119
Parameter Sets: (All)
74120
Aliases:
75121

76122
Required: False
77-
Position: Named
123+
Position: 1
78124
Default value: None
79125
Accept pipeline input: False
80126
Accept wildcard characters: False
81127
```
82128
83-
### -DeleteCustomEmojis
84-
These settings enable and disable the editing and deletion of custom emojis and reactions for the users included in the messaging policy.
129+
### -AllowGiphy
130+
Determines whether a user is allowed to access and post Giphys. Set this to TRUE to allow. Set this FALSE to prohibit.
131+
132+
**Note**: [Optional Connected Experiences](https://learn.microsoft.com/deployoffice/privacy/manage-privacy-controls#policy-setting-for-optional-connected-experiences) must be also enabled for Giphys to be allowed.
85133
86134
```yaml
87135
Type: Boolean
@@ -95,9 +143,8 @@ Accept pipeline input: False
95143
Accept wildcard characters: False
96144
```
97145
98-
### -AllowGiphy
99-
Determines whether a user is allowed to access and post Giphys. Set this to TRUE to allow. Set this FALSE to prohibit.
100-
Note: [Optional Connected Experiences](https://learn.microsoft.com/deployoffice/privacy/manage-privacy-controls#policy-setting-for-optional-connected-experiences) must be also enabled for Giphys to be allowed.
146+
### -AllowImmersiveReader
147+
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.
101148
102149
```yaml
103150
Type: Boolean
@@ -111,8 +158,8 @@ Accept pipeline input: False
111158
Accept wildcard characters: False
112159
```
113160
114-
### -AllowImmersiveReader
115-
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.
161+
### -AllowMemes
162+
Determines whether a user is allowed to access and post memes. Set this to TRUE to allow. Set this FALSE to prohibit.
116163
117164
```yaml
118165
Type: Boolean
@@ -126,8 +173,8 @@ Accept pipeline input: False
126173
Accept wildcard characters: False
127174
```
128175
129-
### -AllowMemes
130-
Determines whether a user is allowed to access and post memes. Set this to TRUE to allow. Set this FALSE to prohibit.
176+
### -AllowOwnerDeleteMessage
177+
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.
131178
132179
```yaml
133180
Type: Boolean
@@ -141,8 +188,8 @@ Accept pipeline input: False
141188
Accept wildcard characters: False
142189
```
143190
144-
### -AllowOwnerDeleteMessage
145-
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.
191+
### -AllowPriorityMessages
192+
Determines whether a user is allowed to send priorities messages. Set this to TRUE to allow. Set this FALSE to prohibit.
146193
147194
```yaml
148195
Type: Boolean
@@ -156,16 +203,16 @@ Accept pipeline input: False
156203
Accept wildcard characters: False
157204
```
158205
159-
### -AllowPriorityMessages
160-
Determines whether a user is allowed to send priorities messages. Set this to TRUE to allow. Set this FALSE to prohibit.
206+
### -AllowSmartCompose
207+
Turn on this setting to let a user get text predictions for chat messages.
161208
162209
```yaml
163210
Type: Boolean
164211
Parameter Sets: (All)
165212
Aliases:
166213

167214
Required: False
168-
Position: Named
215+
Position: Con nombre
169216
Default value: None
170217
Accept pipeline input: False
171218
Accept wildcard characters: False
@@ -340,6 +387,17 @@ Accept pipeline input: False
340387
Accept wildcard characters: False
341388
```
342389
390+
### -ChatPermissionRole
391+
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.
392+
393+
```yaml
394+
Type: String
395+
Position: Named
396+
Default value: Restricted
397+
Accept pipeline input: False
398+
Accept wildcard characters: False
399+
```
400+
343401
### -Confirm
344402
Prompts you for confirmation before running the cmdlet.
345403
@@ -355,11 +413,11 @@ Accept pipeline input: False
355413
Accept wildcard characters: False
356414
```
357415
358-
### -Description
359-
Provide a description of your policy to identify purpose of creating it.
416+
### -CreateCustomEmojis
417+
This setting enables the creation of custom emojis and reactions within an organization for the specified policy users.
360418
361419
```yaml
362-
Type: String
420+
Type: Boolean
363421
Parameter Sets: (All)
364422
Aliases:
365423

@@ -370,11 +428,11 @@ Accept pipeline input: False
370428
Accept wildcard characters: False
371429
```
372430
373-
### -Force
374-
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.
431+
### -DeleteCustomEmojis
432+
These settings enable and disable the editing and deletion of custom emojis and reactions for the users included in the messaging policy.
375433
376434
```yaml
377-
Type: SwitchParameter
435+
Type: Boolean
378436
Parameter Sets: (All)
379437
Aliases:
380438

@@ -385,8 +443,8 @@ Accept pipeline input: False
385443
Accept wildcard characters: False
386444
```
387445
388-
### -GiphyRatingType
389-
Determines the Giphy content restrictions applicable to a user. Set this to STRICT, MODERATE or NORESTRICTION.
446+
### -Description
447+
Provide a description of your policy to identify purpose of creating it.
390448
391449
```yaml
392450
Type: String
@@ -400,18 +458,48 @@ Accept pipeline input: False
400458
Accept wildcard characters: False
401459
```
402460
403-
### -Identity
404-
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.
461+
### -DesignerForBackgroundsAndImages
462+
This setting determines whether a user is allowed to create custom AI-powered backgrounds and images with MS Designer.
405463
406-
If you do not specify an Identity the Set-CsTeamsMessagingPolicy cmdlet will automatically modify the global policy.
464+
Possible values are: Enabled, Disabled.
407465
408466
```yaml
409-
Type: Object
467+
Type: DesignerForBackgroundsAndImagesTypeEnum
410468
Parameter Sets: (All)
411469
Aliases:
412470

413471
Required: False
414-
Position: 1
472+
Position: Named
473+
Default value: Enabled
474+
Accept pipeline input: False
475+
Accept wildcard characters: False
476+
```
477+
478+
### -Force
479+
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.
480+
481+
```yaml
482+
Type: SwitchParameter
483+
Parameter Sets: (All)
484+
Aliases:
485+
486+
Required: False
487+
Position: Named
488+
Default value: None
489+
Accept pipeline input: False
490+
Accept wildcard characters: False
491+
```
492+
493+
### -GiphyRatingType
494+
Determines the Giphy content restrictions applicable to a user. Set this to STRICT, MODERATE or NORESTRICTION.
495+
496+
```yaml
497+
Type: String
498+
Parameter Sets: (All)
499+
Aliases:
500+
501+
Required: False
502+
Position: Named
415503
Default value: None
416504
Accept pipeline input: False
417505
Accept wildcard characters: False
@@ -450,11 +538,11 @@ Accept wildcard characters: False
450538
### -Tenant
451539
Globally unique identifier (GUID) of the tenant account whose external user communication policy are being created. For example:
452540
453-
-Tenant "38aad667-af54-4397-aaa7-e94c79ec2308"
541+
`-Tenant "38aad667-af54-4397-aaa7-e94c79ec2308"`
454542

455543
You can return your tenant ID by running this command:
456544

457-
Get-CsTenant | Select-Object DisplayName, TenantID
545+
`Get-CsTenant | Select-Object DisplayName, TenantID`
458546

459547
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.
460548

@@ -486,37 +574,10 @@ Accept pipeline input: False
486574
Accept wildcard characters: False
487575
```
488576

489-
### -ChatPermissionRole
490-
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.
491-
492-
```yaml
493-
Type: String
494-
Position: Named
495-
Default value: Restricted
496-
Accept pipeline input: False
497-
Accept wildcard characters: False
498-
```
499-
500-
### -AllowSmartCompose
501-
Turn on this setting to let a user get text predictions for chat messages.
502-
503-
```yaml
504-
Type: Boolean
505-
Parameter Sets: (All)
506-
Aliases:
507-
508-
Required: False
509-
Position: Con nombre
510-
Default value: None
511-
Accept pipeline input: False
512-
Accept wildcard characters: False
513-
```
514-
515577
## INPUTS
516578

517579
### System.Management.Automation.PSObject
518580

519-
520581
## OUTPUTS
521582

522583
### System.Object

0 commit comments

Comments
 (0)