Remove-CsTeamsIPPhonePolicy

Module:

MicrosoftTeamsPowerShell

Applies to:

Microsoft Teams

Use the Remove-CsTeamsIPPhonePolicy cmdlet to remove a custom policy that's been created for controlling Teams phone experiences.

Syntax

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

Description

Use the Remove-CsTeamsIPPhonePolicy cmdlet to remove a custom policy that's been created for controlling Teams IP Phones experiences.

Note: Ensure the policy is not assigned to any users or the policy deletion will fail.

Examples

Example 1

PS C:\> Remove-CsTeamsIPPhonePolicy -Identity CommonAreaPhone

This example shows the deletion of the policy CommonAreaPhone.

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

Suppresses any confirmation prompts that would otherwise be displayed before making changes and suppresses the display of any non-fatal error message that might arise when running the command.

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

-Identity

Specify the name of the TeamsIPPhonePolicy that you would like to remove.

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

-Tenant

Internal Microsoft use only.

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