Topic Last Modified: 2010-12-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 Lync Server 2010.

Note:
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.
Note:
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:

CallPickupTimeoutThreshold

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.

EnableMusicOnHold

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

Values are True or False. The default is True.

MaxCallPickupAttempts

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 default is 1.

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. The default is no forwarding address.

To configure Call Park settings

  1. Log on to the computer as a member of the RTCUniversalServerAdmins group, or as a member of the CsVoiceAdministrator, CsServerAdministrator, or CsAdministrator administrative role.

  2. Start the Lync Server Management Shell: Click Start, click All Programs, click Microsoft Lync Server 2010, and then click Lync Server Management Shell.

  3. 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>
    
    Tip:
    Use the Get-CsSite cmdlet to identify the site. For details, see Lync Server Management Shell documentation.

    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. Log on to the computer as a member of the Administrators group, the Domain Admins group, and the RTCUniversalServerAdmins group, or as a member of a group that is assigned a delegated administrative role.

  2. Start the Lync Server Management Shell: Click Start, click All Programs, click Microsoft Lync Server 2010, and then click Lync Server Management Shell.

  3. Run:

    Copy Code
    Set-CsCallParkServiceMusicOnHoldFile `
    -Service <ServiceID where the Call Park application resides> `
    -Content <Byte[]>
    
    Tip:
    Use the Get-CsService cmdlet to identify the service. For details, see Lync Server Management Shell documentation.

    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 details, see Lync 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