[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

Creates a new collection of Call Park application settings. Call parking is a service that allows a user to park an incoming phone call. Parking a call transfers it to a number in a specified range, or orbit, and immediately places the call on hold. Anyone (not just the person who originally answered the call) can resume the conversation from any telephone by entering the correct number.


New-CsCpsConfiguration -Identity <XdsIdentity> [-CallPickupTimeoutThreshold <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnableMusicOnHold <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxCallPickupAttempts <Nullable>] [-OnTimeoutURI <String>] [-WhatIf [<SwitchParameter>]]


Parameter Required Type Description




The site to which the settings are applied. This must be entered in the format site:<sitename>, such as site:Redmond




The amount of time that will elapse after a call has been parked before it will ring back to the phone on which the call was answered.

This must be entered in the format hh:mm:ss (hh = hours, mm = minutes, ss = seconds)

Default: 00:01:30 (90 seconds); Minimum Value: 10 seconds (00:00:10); Maximum Value: 10 minutes (00:10:00)




Prompts you for confirmation before executing the command.




Determines whether music plays for the caller while a call is parked.

Microsoft Communications Server 2010 ships with a default Music on Hold file. You can change this file (thereby changing the music the caller hears while parked) with the Set-CsCallParkServiceMusicOnHoldFile cmdlet.

Default: True




Creates an object reference without actually committing the object as a permanent change. If you assign the output of this cmdlet called with this parameter to a variable, you can make changes to the properties of the object reference and then commit those changes by calling this cmdlet’s matching Set- cmdlet.




The number of times a parked call will ring back to the answering phone before giving up and forwarding the call to the fallback Uniform Resource Identifier (URI). The fallback URI is set with the OnTimeoutURI parameter.

Default: 1; Minimum Value: 1; Maximum Value: 10




The SIP address of the user or Response Group to which unanswered parked calls will be routed. The parked call will be routed after the number of ringbacks defined with the MaxCallPickupAttempts parameter. If that parameter is set to Null, the OnTimeoutURI will be ignored and the parked call will be disconnected after unsuccessful ringback attempts.

Values must be SIP URIs, beginning with the string sip:. For example, sip:rgs1@litwareinc.com.




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




Describes what would happen if you executed the command without actually executing the command.

Detailed Description

This cmdlet is used to create a new Call Park application configuration. When the Call Park application is installed, global settings are configured by default and cannot be removed. ("Removing" the global settings simply resets them to the default values.) Therefore this cmdlet is used to create only site-specific settings.

A Call Park application configuration specifies what happens to a call once it’s parked. For example, if a parked call isn’t answered after a period of time, it can be automatically forwarded to someone else, such as an administrator, or to a Response Group. Calls can be configured to ring after a certain period of time to ensure the call isn’t forgotten. In addition, the Call Park application can be configured to play music on hold to the caller while the call is parked.

Available scopes: Global, Site

Return Types

This cmdlet creates an object of type Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings.


-------------------------- Example 1 --------------------------

Copy Code
New-CsCpsConfiguration -Identity site:Redmond1 -EnableMusicOnHold $False

The command shown in Example 1 uses the New-CsCpsConfiguration cmdlet to create a Call Park application configuration for site Redmond1. This configuration is created with default values with the exception of EnableMusicOnHold. This command sets this property to False, meaning the caller whose calls has been parked will not hear anything while on hold. (EnableMusicOnHold is set to True by default, assuming the Call Park application has been deployed.)

-------------------------- Example 2 --------------------------

Copy Code
New-CsCpsConfiguration -Identity site:Redmond1 -OnTimeoutURI sip:kenmyer@litwareinc.com

The command shown in Example 2 uses the New-CsCpsConfiguration cmdlet to create a Call Park applicationconfiguration for site Redmond1. By default no OnTimeoutURI is supplied, so this example adds a value for that parameter. In this case the OnTimeoutURI is set to sip:kenmyer@litwareinc.com. The value passed to this parameter must begin with the string "sip:" and should point to a user or Response Group that will receive parked calls that aren’t picked up after a specified number of ringback attempts.

-------------------------- Example 3 --------------------------

Copy Code
New-CsCpsConfiguration -Identity site:Redmond1 -MaxCallPickupAttempts 2

This command uses the New-CsCpsConfiguration cmdlet to create a Call Park application configuration for site Redmond1. For this site, the MaxCallPickupAttempts has been set to 2. That means the call rings back twice.