Removes the specified voice policy.
Syntax
Remove-CsVoicePolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]] |
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Identity |
Required |
XdsIdentity |
A unique identifier specifying the scope, and in some cases the name, of the policy to be removed. |
|
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
This cmdlet removes an existing voice policy. Voice policies are used to manage such Enterprise Voice-related features as simultaneous ringing (the ability to have a second phone ring each time someone calls your office phone) and call forwarding. This cmdlet can also be used to remove the global voice policy. In that case, however, the policy will not actually be removed; instead, the policy settings will simply be reset to their default values.
Return Types
This cmdlet does not return a value. It removes an instance of a Microsoft.Rtc.Management.WriteableConfig.Policy.Voice.VoicePolicy object.
Examples
-------------------------- Example 1 --------------------------
 Copy Code |
|
|---|---|
Remove-CsVoicePolicy -Identity UserVoicePolicy1 |
|
This example removes the UserVoicePolicy1 per-user voice policy settings.
-------------------------- Example 2 --------------------------
| Copy Code |
|
|---|---|
Get-CsVoicePolicy -Filter tag* | Remove-CsVoicePolicy |
|
This example removes all the voice policy settings that can be assigned to specific users. First the Get-CsVoicePolicy cmdlet is called with a Filter of tag*, which retrieves all the per-user voice policies. That collection of policies is then piped to the Remove-CsVoicePolicy cmdlet to be removed.