Set-CsVoiceConfiguration
上次修改主題的時間： 2012-03-26
修改語音測試設定的清單。
語法
Set-CsVoiceConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-VoiceTestConfigurations <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Set-CsVoiceConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-VoiceTestConfigurations <PSListModifier>] [-WhatIf [<SwitchParameter>]]
詳細描述
語音測試設定可根據特定語音原則、路由和撥號對應表，用來測試電話號碼。這個指令程式可以用來對 Microsoft Lync Server 2010 部署修改語音測試設定（從包含所有語音測試設定的清單）。
這個指令程式會修改屬於 VoiceConfiguration 類型的物件。由於此物件只是語音測試組態的容器物件，因此我們不建議使用這個指令程式。若要修改語音設定，可呼叫 Set-CsVoiceTestConfiguration 指令程式，修改個別的語音測試設定。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsVoiceConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsVoiceConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
字串 |
這個物件的範圍。這個參數唯一可能的值是 Global。 |
Instance |
選用 |
VoiceConfiguration |
語音設定 (Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoiceConfiguration) 物件的參照。您可以呼叫 Get-CsVoiceConfiguration 指令程式來擷取此類型物件。 |
VoiceTestConfigurations |
選用 |
PSListModifier |
針對 Lync Server 2010 部署定義的所有語音測試設定 (Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration 物件) 清單。 您應該使用 Set-CsVoiceTestConfiguration 指令程式，修改個別的語音測試設定物件。那是修改此清單中之設定的建議方式。 |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoiceConfiguration 物件。接受管線傳送的語音組態物件輸入。
傳回類型
Set-CsVoiceConfiguration 不會傳回值或物件。而是指令程式會設定 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoiceConfiguration 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
$a = Get-CsVoiceConfiguration
$b = $a.VoiceTestConfigurations | Where-Object {$_.Name -eq "TestConfig2"}
$b.DialedNumber = 5551212
$b.ExpectedTranslatedNumber = +5551212
Set-CsVoiceConfiguration -Instance $a
在語音設定內修改測試語音設定需要數個步驟。在本例中，我們一開始是先呼叫 Get-CsVoiceConfiguration，以擷取語音設定物件。我們將擷取的物件 (只會有一個) 指定到變數 $a。
我們在此範例的第 2 行中擷取了 VoiceTestConfigurations 內容的內容，其是來自變數 $a 的語音測試組態物件集合。接著將該集合傳送到 Where-Object 指令程式，我們會在此處搜尋 Name 等於字串 TestConfig2 的語音測試組態物件集合。我們將該物件指定到變數 $b。
接下來，會修改 TestConfig2 語音測試設定物件，方法是將新值指派給 DialedNumber 和 ExpectedTranslatedNumber 屬性。更新該物件，即可更新變數 $a 中的物件。但是該物件仍然只留在記憶體中。最後一步，我們需要儲存那些變更，方法是將 $a 傳遞給 Set-CsVoiceConfiguration。
這並不是修改語音設定的建議方式。若要修改語音設定，只需使用 Set-CsVoiceTestConfiguration 屬性變更個別語音測試設定，如下所示：
Set-CsVoiceTestConfiguration -Identity TestConfig2 -DialedNumber 5551212 -ExpectedTranslatedNumber +5551212
這一行會完成範例 1 所示的相同工作。