[This is pre-release documentation and subject to change in future releases. This topic's current status is: Milestone-Ready]

Topic Last Modified: 2010-07-13

You can optionally customize Call Park settings. When you install the Call Park application, global settings are configured by default. You can modify the global settings, and you can also specify site-specific settings. Use the New-CsCpsConfiguration cmdlet to create new site-specific settings. Use the Set-CsCpsConfiguration cmdlet to modify existing settings.

You can also use the Set-CsCallParkServiceMusicOnHoldFile cmdlet to specify your own music file to use in place of the default music file that ships with Communications Server 2010.

If you customize music on hold and want the same music for multiple sites, you must configure the music file for each site that runs the Call Park application.
At a minimum, we recommend that you configure the OnTimeoutURI option for the fallback destination to use when a parked call times out and ringback fails.

Use New-CsCpsConfiguration or Set-CsCpsConfiguration to configure any of the following settings:

This option: Specifies this:


The amount of time that elapses after a call has been parked before it rings back to the phone where the call was answered.

The value must be entered in the format hh:mm:ss to specify the hours, minutes, and seconds. The minimum value is 10 seconds, and the maximum value is 10 minutes. The default is 00:01:30.


Whether music plays for a caller while a call is parked.

Values are True or False. The default is True.


The number of times a parked call rings back to the answering phone before it is forwarded to the fallback Uniform Resource Identifier (URI) that is specified for OnTimeoutURI.


The SIP address of the user or response group to which an unanswered parked call is routed when MaxCallPickupAttempts is exceeded.

Value must be a SIP URI beginning with the string sip:. For example, sip:bob@contoso.com.

To configure Call Park settings

  1. Open Communications Server Management Shell.

  2. Run:

    Copy Code
    New-CsCpsConfiguration –Identity site:<sitename to apply settings> 
    -CallPickupTimeoutThreshold <hh:mm:ss> -EnableMusicOnHold <True | False> 
    -MaxCallPickupAttempts <number of rings> 
    -OnTimeoutURI sip:<sip URI for routing unanswered call>

    For example:

    Copy Code
    New-CsCpsConfiguration –Identity site:Redmond1 
    -CallPickupTimeoutThreshold 00:01:00 
    -EnableMusicOnHold $false -MaxCallPickupAttempts 2 
    -OnTimeoutURI sip:bob@contoso.com

To customize the music file

  1. Open Communications Server Management Shell.

  2. Run:

    Copy Code
    –Service <ServiceID where the Call Park application resides> 
    -Content <Byte[]>

    The following example shows how to obtain the contents of a file, soothingmusic.wma, as a byte array and assign it to a variable. Then the audio file is assigned as the music-on-hold file for Call Park. For more information, see Communications Server 2010 cmdlet Help for Set-CsCallParkServiceMusicOnHoldFile.

    Copy Code
    $a = Get-Content -ReadCount 0 -Encoding byte "C:\MoHFiles\soothingmusic.wma"
    Set-CsCallParkServiceMusicOnHoldFile -Service Redmond1-applicationserver-1 
    -Content $a