Resets the voice configuration to its default values.
Syntax
Remove-CsVoiceConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]] |
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Identity |
Required |
XdsIdentity |
The scope of the voice configuration to remove. This value must be Global. |
|
Confirm |
Optional |
SwitchParameter |
Prompts you for confirmation before executing the command. |
|
Force |
Optional |
SwitchParameter |
Suppresses any confirmation prompts that would otherwise be displayed before making changes. |
|
WhatIf |
Optional |
SwitchParameter |
Describes what would happen if you executed the command without actually executing the command. |
Detailed Description
Voice test configurations are used to test a phone number against a specific voice policy, route, and dial plan. This cmdlet removes the global (and only) voice configuration, which is a container for all voice test configurations defined for a Microsoft Communications Server 2010 deployment. "Removing" the voice configuration doesn’t actually remove it; the Global (and only) instance is still there. However, it does set the list of voice test configurations to the default, which is empty.
WARNING: Removing the voice configuration (which sets the list of voice test configurations to empty) deletes all defined voice test configurations for a Communications Server 2010 deployment. After calling this cmdlet, a call to Get-CsVoiceTestConfiguration will return no results.
Return Types
This cmdlet removes (resets) an object of type Microsoft.Rtc.Management.WriteableConfig.Policy.Voice.VoiceConfiguration.
Examples
-------------------------- Example 1 --------------------------
 Copy Code |
|
|---|---|
Remove-CsVoiceConfiguration -Identity Global -Confirm |
|
This example resets the Global (and only) voice configuration to the default values. This action deletes all defined voice test configurations, so we added the Confirm parameter in order to receive a prompt asking whether we really want to perform this action before the removal takes place.