Remove-CsDialInConferencingDtmfConfiguration
上次修改主題的時間: 2012-03-26
移除用於電話撥入式會議之雙音多頻 (DTMF) 訊號設定的現有集合。DTMF 可讓撥電話參與會議的使用者使用其電話鍵盤來控制會議設定 (例如自行設定靜音和解除靜音,或鎖定和解除鎖定會議)。
語法
Remove-CsDialInConferencingDtmfConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
Microsoft Lync Server 2010 可讓使用者透過撥打電話來參與會議。撥入的使用者無法檢視視訊或與其他會議出席者交換立即訊息,但他們可以完整參與會議的音訊部分。
除了可以參與會議,使用者還可以使用其電話按鍵來管理選取的會議部分。(使用者所能管理的特定會議設定會取決於使用者是否為簡報者)。例如,依預設使用者可以按其鍵盤上的數字鍵 6,自行設定靜音或解除靜音。參與者可以私下播放參與會議的所有其他人員名字,而簡報者可對所有會議出席者設定靜音或解除靜音,以及隨時有某人加入或離開會議時啟用/停用宣告播放。
像這些使用電話鍵盤來做選擇的功能稱為雙音多頻 (DTMF) 訊號:如果您曾經撥打電話號碼,並且接受指示,依照「英語請按 1,或西班牙語請按 2」的順序執行某些動作,即表示您已用過 DTMF 訊號。
當您安裝 Lync Server 2010,會為您建立 DTMF 設定的通用集合。除了這些通用設定外,您可以使用 New-CSDialInConferencingDtmfConfiguration Cmdlet 逐一建立各個站台的自訂設定。您在站台範圍建立的設定稍後可以使用 Remove-CSDialInConferencingDtmfConfiguration Cmdlet 移除。當您移除在站台範圍套用的 DTMF 設定時,受影響之站台的使用者會自動由通用 DTMF 組態設定管轄。
您也可以針對通用設定執行 Remove-CSDialInConferencingDtmfConfiguration。不過,如果您這樣做,將不會移除通用設定;那是因為您無法移除通用 DTMF 設定。而是將通用設定中的屬性重設為其預設值。例如,假設您已修改通用設定,將鍵 4 設為靜音/解除靜音鍵。此時,如果您對該通用設定執行 Remove-CSDialInConferencingDtmfConfiguration,則靜音/解除靜音鍵的值會重設為預設值 6。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 Remove-CsDialInConferencingDtmfConfiguration Cmdlet:RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsDialInConferencingDtmfConfiguration"}
參數
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
Identity |
必要 |
XdsIdentity |
要移除之 DTMF 設定集合的唯一識別碼。若要「移除」通用設定,請使用此語法:-Identity global。(如前所述,您無法實際移除通用設定;您只能將屬性重設為其預設值)。若要修改在站台範圍設定的集合,請使用類似如下的語法:-Identity site:Redmond。您無法在指定 Identity 時使用萬用字元 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果,但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration 物件。Remove-CsDialInConferencingDtmfConfiguration 接受管線傳送的電話撥入式會議 DTMF 組態物件執行個體。
傳回類型
無。而是 Remove-CSDialInConferencingDtmfConfiguration 會刪除 Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Remove-CSDialInConferencingDtmfConfiguration -Identity site:Redmond
以上的命令會刪除 Identity 為 site:Redmond 之 DTMF 組態設定的集合。
-------------------------- 範例 2 ------------------------
Get-CSDialInConferencingDtmfConfiguration -Filter "site:*" | Remove-CSDialInConferencingDtmfConfiguration
範例 2 所示的命令會刪除已在站台範圍設定的所有 DTMF 設定。若要執行此工作,此命令會先使用 Get-CSDialInConferencingDtmfConfiguration 和 Filter 參數,傳回已在站台範圍設定之所有 DTMF 設定的集合;篩選值 "site:*" 可確保只會傳回 Identity 開頭為字串值 "site:" 的設定。才會傳回。接著,這個篩選過的集合會傳送到 Remove-CSDialInConferencingConfiguration,這會移除該集合中的每一個項目。
-------------------------- 範例 3 ------------------------
Get-CSDialInConferencingDtmfConfiguration | Where-Object {$_.PrivateRollCallCommand -eq $Null} | Remove-CSDialInConferencingDtmfConfiguration
在範例 3 中,Remove-CSDialInConferencingDtmfConfiguration 是用於刪除 PrivateRollCallCommand 屬性等於 Null 值的所有 DTMF 設定。(亦即,已停用私人通話名單命令)。若要這樣做,此命令會先使用 Get-CSDialInConferencingDtmfConfiguration 傳回目前用於組織之所有 DTMF 設定的集合。接著,此集合會傳送到 Where-Object 指令程式,這樣只會選取 PrivateRollCallCommand 等於 Null 值的設定。然後,這個篩選過的集合會傳送到 Remove-CSDialInConferencingDtmfConfiguration,以刪除集合中的每一個項目。