Remove-CsVoiceConfiguration
上一次修改主题： 2012-03-27
将语音配置重置为默认值。
语法
Remove-CsVoiceConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
语音测试配置用于针对特定语音策略、路由和拨号计划测试电话号码。此 cmdlet 可删除全局（且只能删除此项）语音配置，该配置是为 Microsoft Lync Server 2010 部署定义的所有语音测试配置的容器。“删除”语音配置实际上并不会将其删除，全局实例仍旧存在。但是，该操作会将语音测试配置列表设置为默认设置，即为空。
警告：删除语音配置（将语音测试配置列表设置为空）会删除为 Lync Server 2010 部署定义的所有语音测试配置。调用此 cmdlet 之后，调用 Get-CsVoiceTestConfiguration 将不返回任何结果。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsVoiceConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsVoiceConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
要删除的语音配置的作用域。此值必须为 Global。 |
Force |
可选 |
开关参数 |
禁止显示任何本该在进行更改前显示的确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoiceConfiguration 对象。接受通过管道传递的语音配置对象的输入。
返回类型
此 cmdlet 可删除（重置）一个类型为 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoiceConfiguration 的对象。
示例
-------------------------- 示例 1 --------------------------
Remove-CsVoiceConfiguration -Identity Global -Confirm
此示例将 Global（且仅此项）语音配置重置为默认值。此操作会删除已定义的所有语音测试配置，因此添加了 Confirm 参数，以便在执行删除操作之前发出提示，询问是否确实要执行此操作。