Remove-CsVoiceConfiguration
上次修改主題的時間： 2012-03-27
將語音設定重設為預設值。
語法
Remove-CsVoiceConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
語音測試設定可根據特定語音原則、路由和撥號對應表，用來測試電話號碼。此指令程式會移除通用 (且只有) 語音設定，這是針對 Microsoft Lync Server 2010 部署所定義的所有語音測試設定的容器。「移除」語音設定不會真的移除該設定，通用執行個體仍然存在。不過，它會將語音測試設定的清單設為預設值，也就是空的。
警告：移除語音設定 (將語音測試設定的清單設為空的) 會刪除針對 Lync Server 2010 部署定義的所有語音測試設定。呼叫此指令程式之後，呼叫 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 物件。接受管線傳送的語音組態物件輸入。
傳回類型
此指令程式會移除 (重設) Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoiceConfiguratione 類型的物件。
範例
-------------------------- 範例 1 --------------------------
Remove-CsVoiceConfiguration -Identity Global -Confirm
此範例將 Global (且只有) 語音設定重設為預設值。此動作會刪除所有已定義的語音測試設定，所以我們增加 Confirm 參數來接收提示，詢問在移除之前是否真的想要執行此動作。