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

Removes an existing Call Park application configuration. 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 then immediately places the call on hold. Anyone (not just the person who originally answered the call) can resume the conversation from any telephone simply by entering the correct number.


Remove-CsCpsConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]


Parameter Required Type Description




The unique identifier of the Call Park application configuration you want to remove. This identifier will be either Global or site:<sitename>, where <sitename> is the name of the site to which the configuration applies.




Prompts you for confirmation before executing the command.




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 remove a Call Park application configuration. 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.

This cmdlet can be used to remove any Call Park application configurations, including the Global configuration. In the case of the Global configuration, however, the configuration will not actually be removed; instead, it will simply be reset to the default values.

Return Types

Removes an object of type Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings.


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

Copy Code
Remove-CsCpsConfiguration -Identity site:Redmond1

The preceding command uses the Remove-CsCpsConfiguration cmdlet to delete the Call Park application configuration with the Identity site:Redmond1. Because identities are unique, this command will result in only one configuration being deleted.

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

Copy Code
Get-CsCpsConfiguration -Filter site:* | Remove-CsCpsConfiguration

In Example 2, all the Call Park application configurations that have been defined at the site scope are deleted. To carry out this task, the command first uses Get-CsCpsConfiguration and the Filter parameter to return all the Call Park application configurations that have been defined at the site scope; the wildcard site:* ensures that only settings that have an Identity that begins with the string value site: will be returned. This filtered collection is then piped to Remove-CsCpsConfiguration, which proceeds to delete each item in the collection. Note that any time you remove Call Park application settings from a site, the site will automatically begin to use the Call Park application settings configured at the global scope.