From d90833ae7c12a7fd05da28bfb01bb07765796917 Mon Sep 17 00:00:00 2001 From: michbrown-png <83979060+michbrown-png@users.noreply.github.com> Date: Fri, 27 Sep 2024 14:06:43 -0400 Subject: [PATCH 1/5] Uploading Teams Messaging Configuration --- .../Get-CsTeamsMessagingConfiguration.md | 92 ++++++++++ .../Set-CsTeamsMessagingConfiguration.md | 170 ++++++++++++++++++ 2 files changed, 262 insertions(+) create mode 100644 teams/teams-ps/teams/Get-CsTeamsMessagingConfiguration.md create mode 100644 teams/teams-ps/teams/Set-CsTeamsMessagingConfiguration.md diff --git a/teams/teams-ps/teams/Get-CsTeamsMessagingConfiguration.md b/teams/teams-ps/teams/Get-CsTeamsMessagingConfiguration.md new file mode 100644 index 0000000000..47e8852736 --- /dev/null +++ b/teams/teams-ps/teams/Get-CsTeamsMessagingConfiguration.md @@ -0,0 +1,92 @@ +--- +external help file: Microsoft.Teams.Policy.Administration.Cmdlets.Core.dll-Help.xml +Module Name: MicrosoftTeams +online version: https://learn.microsoft.com/powershell/module/teams/Get-CsTeamsMessagingConfiguration +schema: 2.0.0 +--- + +# Get-CsTeamsMessagingConfiguration + +## SYNOPSIS + +TeamsMessagingConfiguration determines the messaging settings for users. This cmdlet returns your organization's current settings. + +## SYNTAX + +### Identity (Default) + +```powershell +Get-CsTeamsMessagingConfiguration [[-Identity] ] [] +``` + +### Filter + +```powershell +Get-CsTeamsMessagingConfiguration [-Filter ] [] +``` + +## DESCRIPTION + +TeamsMessagingConfiguration determines the messaging settings for users. + +## EXAMPLES + +### Example 1 + +```powershell +PS C:\> Get-CsTeamsMessagingConfiguration +``` + +The command shown in Example 1 returns teams messaging configuration information for the current tenant. + +## PARAMETERS + +### -Filter + +Enables you to use wildcard characters in order to return a collection of tenant messaging configuration settings. Because each tenant is limited to a single, global collection of the messaging configuration settings there is no need to use the Filter parameter. + +```yaml +Type: String +Parameter Sets: Filter +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: 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. + +```yaml +Type: String +Parameter Sets: Identity +Aliases: + +Required: False +Position: 1 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters + +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). + +## INPUTS + +### None + +## OUTPUTS + +### TeamsMessagingConfiguration.Cmdlets.TeamsMessagingConfiguration + +## NOTES + +## RELATED LINKS + +[Set-CsTeamsMeetingConfiguration](Set-CsTeamsMeetingConfiguration.md) diff --git a/teams/teams-ps/teams/Set-CsTeamsMessagingConfiguration.md b/teams/teams-ps/teams/Set-CsTeamsMessagingConfiguration.md new file mode 100644 index 0000000000..fc5d112c94 --- /dev/null +++ b/teams/teams-ps/teams/Set-CsTeamsMessagingConfiguration.md @@ -0,0 +1,170 @@ +--- +external help file: Microsoft.Teams.Policy.Administration.Cmdlets.Core.dll-Help.xml +Module Name: MicrosoftTeams +online version: https://learn.microsoft.com/powershell/module/teams/Set-CsTeamsMessagingConfiguration +schema: 2.0.0 +--- + +# Set-CsTeamsMessagingConfiguration + +## SYNOPSIS + +The TeamsMessagingConfiguration determines the messaging settings for users in your tenant. + +## SYNTAX + +```powershell +Set-CsTeamsMessagingConfiguration [-EnableVideoMessageCaptions ] + [-EnableInOrganizationChatControl ] [-CustomEmojis ] [-Identity] [-Force] [-WhatIf] + [-Confirm] [] +``` + +## 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 + +```powershell +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. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: 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 + +```yaml +Type: Boolean +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -EnableInOrganizationChatControl + +This setting determines if chat regulation for internal communication in tenant is allowed. +Possible Values: True, False + +```yaml +Type: Boolean +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -EnableVideoMessageCaptions + + This setting determines if closed captions will be displayed, for Teams Video Clips, during playback. + Possible values: True, False + +```yaml +Type: Boolean +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +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. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: 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. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 1 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf + +Shows what would happen if the cmdlet runs. +The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters + +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). + +## INPUTS + +### None + +## OUTPUTS + +### System.Void + +## NOTES + +## RELATED LINKS + +[Get-CsTeamsMeetingConfiguration](Get-CsTeamsMeetingConfiguration.md) From 5d96f9beb515fde0ecc107c1486238bd14acd322 Mon Sep 17 00:00:00 2001 From: michbrown-png <83979060+michbrown-png@users.noreply.github.com> Date: Fri, 27 Sep 2024 16:16:32 -0400 Subject: [PATCH 2/5] Update teams.md --- teams/teams-ps/teams/teams.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/teams/teams-ps/teams/teams.md b/teams/teams-ps/teams/teams.md index ac0d27d7a7..14711acfed 100644 --- a/teams/teams-ps/teams/teams.md +++ b/teams/teams-ps/teams/teams.md @@ -118,6 +118,7 @@ The following cmdlet references are for Microsoft Teams. ### [Get-CsTeamsMeetingPolicy](Get-CsTeamsMeetingPolicy.md) ### [Get-CsTeamsMeetingTemplateConfiguration](Get-CsTeamsMeetingTemplateConfiguration.md) ### [Get-CsTeamsMeetingTemplatePermissionPolicy](Get-CsTeamsMeetingTemplatePermissionPolicy.md) +### [Get-CsTeamsMessagingConfiguration](Get-CsTeamsMessagingConfiguration.md) ### [Get-CsTeamsMessagingPolicy](Get-CsTeamsMessagingPolicy.md) ### [Get-CsTeamsMobilityPolicy](Get-CsTeamsMobilityPolicy.md) ### [Get-CsTeamsNetworkRoamingPolicy](Get-CsTeamsNetworkRoamingPolicy.md) @@ -462,6 +463,7 @@ The following cmdlet references are for Microsoft Teams. ### [Set-CsTeamsMeetingConfiguration](Set-CsTeamsMeetingConfiguration.md) ### [Set-CsTeamsMeetingPolicy](Set-CsTeamsMeetingPolicy.md) ### [Set-CsTeamsMeetingTemplatePermissionPolicy](Set-CsTeamsMeetingTemplatePermissionPolicy.md) +### [Set-CsTeamsMessagingConfiguration](Set-CsTeamsMessagingConfiguration.md) ### [Set-CsTeamsMessagingPolicy](Set-CsTeamsMessagingPolicy.md) ### [Set-CsTeamsMobilityPolicy](Set-CsTeamsMobilityPolicy.md) ### [Set-CsTeamsNetworkRoamingPolicy](Set-CsTeamsNetworkRoamingPolicy.md) From 1d63aa41c187c54b5dcfce654d9a7e98477be4c3 Mon Sep 17 00:00:00 2001 From: michbrown-png <83979060+michbrown-png@users.noreply.github.com> Date: Fri, 27 Sep 2024 16:19:59 -0400 Subject: [PATCH 3/5] Update and rename Set-CsTeamsMessagingConfiguration.md to set-csteamsmessagingconfiguration.md --- ...gConfiguration.md => set-csteamsmessagingconfiguration.md} | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) rename teams/teams-ps/teams/{Set-CsTeamsMessagingConfiguration.md => set-csteamsmessagingconfiguration.md} (93%) diff --git a/teams/teams-ps/teams/Set-CsTeamsMessagingConfiguration.md b/teams/teams-ps/teams/set-csteamsmessagingconfiguration.md similarity index 93% rename from teams/teams-ps/teams/Set-CsTeamsMessagingConfiguration.md rename to teams/teams-ps/teams/set-csteamsmessagingconfiguration.md index fc5d112c94..da71766e9e 100644 --- a/teams/teams-ps/teams/Set-CsTeamsMessagingConfiguration.md +++ b/teams/teams-ps/teams/set-csteamsmessagingconfiguration.md @@ -1,7 +1,7 @@ --- external help file: Microsoft.Teams.Policy.Administration.Cmdlets.Core.dll-Help.xml Module Name: MicrosoftTeams -online version: https://learn.microsoft.com/powershell/module/teams/Set-CsTeamsMessagingConfiguration +online version: https://learn.microsoft.com/powershell/module/teams/set-csteamsmessagingconfiguration schema: 2.0.0 --- @@ -167,4 +167,4 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## RELATED LINKS -[Get-CsTeamsMeetingConfiguration](Get-CsTeamsMeetingConfiguration.md) +[Get-CsTeamsMeetingConfiguration](get-csteamsmeetingconfiguration.md) From d9777a8b953cdd9c872524dd2d0809ed09736dc3 Mon Sep 17 00:00:00 2001 From: michbrown-png <83979060+michbrown-png@users.noreply.github.com> Date: Fri, 27 Sep 2024 16:23:33 -0400 Subject: [PATCH 4/5] Update and rename Get-CsTeamsMessagingConfiguration.md to get-csteamsmessagingconfiguration.md --- ...ingConfiguration.md => get-csteamsmessagingconfiguration.md} | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) rename teams/teams-ps/teams/{Get-CsTeamsMessagingConfiguration.md => get-csteamsmessagingconfiguration.md} (93%) diff --git a/teams/teams-ps/teams/Get-CsTeamsMessagingConfiguration.md b/teams/teams-ps/teams/get-csteamsmessagingconfiguration.md similarity index 93% rename from teams/teams-ps/teams/Get-CsTeamsMessagingConfiguration.md rename to teams/teams-ps/teams/get-csteamsmessagingconfiguration.md index 47e8852736..5be71c055d 100644 --- a/teams/teams-ps/teams/Get-CsTeamsMessagingConfiguration.md +++ b/teams/teams-ps/teams/get-csteamsmessagingconfiguration.md @@ -89,4 +89,4 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## RELATED LINKS -[Set-CsTeamsMeetingConfiguration](Set-CsTeamsMeetingConfiguration.md) +[Set-CsTeamsMeetingConfiguration](set-csteamsmeetingconfiguration.md) From 329505bced6210d3a7cb854ebd17e0930657c9a8 Mon Sep 17 00:00:00 2001 From: michbrown-png <83979060+michbrown-png@users.noreply.github.com> Date: Fri, 27 Sep 2024 16:24:15 -0400 Subject: [PATCH 5/5] Update set-csteamsmessagingconfiguration.md --- teams/teams-ps/teams/set-csteamsmessagingconfiguration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/teams/teams-ps/teams/set-csteamsmessagingconfiguration.md b/teams/teams-ps/teams/set-csteamsmessagingconfiguration.md index da71766e9e..9c32f6242b 100644 --- a/teams/teams-ps/teams/set-csteamsmessagingconfiguration.md +++ b/teams/teams-ps/teams/set-csteamsmessagingconfiguration.md @@ -1,7 +1,7 @@ --- external help file: Microsoft.Teams.Policy.Administration.Cmdlets.Core.dll-Help.xml Module Name: MicrosoftTeams -online version: https://learn.microsoft.com/powershell/module/teams/set-csteamsmessagingconfiguration +online version: https://learn.microsoft.com/powershell/module/teams/Set-CsTeamsMessagingConfiguration schema: 2.0.0 ---