Remove-CsTeamsMessagingPolicy

Reference

Module:: MicrosoftTeamsPowerShell

Applies to:: Microsoft Teams

Deletes a custom messaging policy. Teams messaging policies determine the features and capabilities that can be used in messaging within the teams client.

Syntax

Remove-CsTeamsMessagingPolicy
      [-Tenant <Guid>]
      [-Identity] <XdsIdentity>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Deletes a previously created TeamsMessagingPolicy. Any users with no explicitly assigned policies will then fall back to the default policy in the organization. You cannot delete the global policy from the organization.

Examples

Example 1

PS C:\> Remove-CsTeamsMessagingPolicy -Identity StudentMessagingPolicy

In the example shown above, the command will delete the student messaging policy from the organization's list of policies.

Parameters

-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

-Force

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Identity

Unique identifier for the teams messaging policy to be removed. To remove the global policy, use this syntax: -Identity global. (Note that the global policy cannot actually be removed. Instead, all the policy properties will be reset to their default values.) To remove a custom policy, use this syntax: -Identity StudentMessagingPolicy .

Type:	XdsIdentity
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tenant

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

Microsoft.Rtc.Management.Xds.XdsIdentity

Outputs

System.Object