Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
92 changes: 92 additions & 0 deletions teams/teams-ps/teams/get-csteamsmessagingconfiguration.md
Original file line number Diff line number Diff line change
@@ -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] <String>] [<CommonParameters>]
```

### Filter

```powershell
Get-CsTeamsMessagingConfiguration [-Filter <String>] [<CommonParameters>]
```

## 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)
170 changes: 170 additions & 0 deletions teams/teams-ps/teams/set-csteamsmessagingconfiguration.md
Original file line number Diff line number Diff line change
@@ -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 <Boolean>]
[-EnableInOrganizationChatControl <Boolean>] [-CustomEmojis <Boolean>] [-Identity] <String> [-Force] [-WhatIf]
[-Confirm] [<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

```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)
2 changes: 2 additions & 0 deletions teams/teams-ps/teams/teams.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down Expand Up @@ -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)
Expand Down