Edit

Share via

New-CsTeamsCallParkPolicy

Module:
MicrosoftTeams PowerShell module

The New-CsTeamsCallParkPolicy cmdlet lets you create a new custom policy that can then be assigned to one or more specific users.

Syntax

Identity (Default) 

New-CsTeamsCallParkPolicy
    [[-Identity] <XdsIdentity>]
    [-Tenant <System.Guid>]
    [-AllowCallPark <Boolean>]
    [-PickupRangeStart <Integer>]
    [-PickupRangeEnd <Integer>]
    [-ParkTimeoutSeconds <Integer>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [-Description <String>]
    [<CommonParameters>]

Description

The TeamsCallParkPolicy controls whether or not users are able to leverage the call park feature in Microsoft Teams. Call park allows enterprise voice customers to place a call on hold and then perform a number of actions on that call: transfer to another department, retrieve via the same phone, or retrieve via a different phone.

NOTE: The call park feature currently available in desktop. mobile and web clients. Supported with TeamsOnly mode.

Examples

Example 1

PS C:\> New-CsTeamsCallParkPolicy -Identity "SalesPolicy" -AllowCallPark $true

Create a new custom policy that has call park enabled. This policy can then be assigned to individual users.

Example 2

PS C:\> New-CsTeamsCallParkPolicy -Identity "SalesPolicy" -AllowCallPark $true -PickupRangeStart 500 -PickupRangeEnd 1500

Create a new custom policy that has call park enabled. This policy will generate pickup numbers starting from 500 and up until 1500.

Example 3

PS C:\> New-CsTeamsCallParkPolicy -Identity "SalesPolicy" -AllowCallPark $true -ParkTimeoutSeconds 600

Create a new custom call park policy which will ring back the parker after 600 seconds if the parked call is unanswered

Parameters

-AllowCallPark

If set to true, customers will be able to leverage the call park feature to place calls on hold and then decide how the call should be handled - transferred to another department, retrieved using the same phone, or retrieved using a different phone.

Parameter properties

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

Parameter sets

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

-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

-Description

Enables administrators to provide explanatory text about the policy. For example, the Description might indicate the users the policy should be assigned to.

Parameter properties

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

Parameter sets

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

-Force

Suppress all non-fatal errors.

Parameter properties

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

Parameter sets

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

-Identity

A unique identifier for the policy - this will be used to retrieve the policy later on to assign it to specific users.

Parameter properties

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

Parameter sets

Identity
Position:1
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ParkTimeoutSeconds

Specify the number of seconds to wait before ringing the parker when the parked call hasn't been picked up. Value can be from 120 to 1800 (seconds).

Parameter properties

Type:Integer
Default value:300
Supports wildcards:False
DontShow:False

Parameter sets

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

-PickupRangeEnd

Specify the maximum value that a rendered pickup code can take. Value can be from 10 to 9999.

Note: PickupRangeStart must be smaller than PickupRangeEnd.

Parameter properties

Type:Integer
Default value:99
Supports wildcards:False
DontShow:False

Parameter sets

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

-PickupRangeStart

Specify the minimum value that a rendered pickup code can take. Value can be from 10 to 9999.

Note: PickupRangeStart must be smaller than PickupRangeEnd.

Parameter properties

Type:Integer
Default value:10
Supports wildcards:False
DontShow:False

Parameter sets

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

-Tenant

Internal Microsoft use only.

Parameter properties

Type:System.Guid
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
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.

Inputs

None

Outputs

System.Object