Edit

Share via


Remove-CsTeamsSharedCallingRoutingPolicy

Deletes an existing Teams shared calling routing policy instance.

Syntax

Default (Default)

Remove-CsTeamsSharedCallingRoutingPolicy
    [-Identity] <string>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

TeamsSharedCallingRoutingPolicy is used to configure shared calling.

Examples

EXAMPLE 1

Remove-CsTeamsSharedCallingRoutingPolicy -Identity "Seattle"

The command shown in Example 1 deletes the Teams shared calling routing policy instance Seattle.

EXAMPLE 2

Get-CsTeamsSharedCallingRoutingPolicy -Filter "tag:*" | Remove-CsTeamsSharedCallingRoutingPolicy

In Example 2, all Teams shared calling routing policies configured at the per-user scope are removed. To do this, the command first calls the Get-CsTeamsSharedCallingRoutingPolicy cmdlet along with the Filter parameter; the filter value "tag:*" limits the returned data to Teams shared calling routing policies configured at the per-user scope. Those per-user policies are then piped to and removed by the Remove-CsTeamsSharedCallingRoutingPolicy cmdlet.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Force

Applicable: Microsoft Teams

Suppresses any confirmation prompts that would otherwise be displayed before making changes.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Identity

Unique identifier assigned to the policy when it is created.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Notes

This cmdlet was introduced in Teams PowerShell Module 5.5.0.