Get-CsDialInConferencingDtmfConfiguration
上次修改主題的時間： 2012-03-23
傳回用於電話撥入式會議的複頻式 (DTMF) 訊號設定。DTMF 可讓撥電話參與會議的使用者使用其電話鍵盤來控制會議設定 (例如自行設定靜音和解除靜音，或鎖定和解除鎖定會議)。
語法
Get-CsDialInConferencingDtmfConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsDialInConferencingDtmfConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
Microsoft Lync Server 2010 可讓使用者透過撥打電話來參與會議。撥入的使用者無法檢視視訊或與其他會議出席者交換立即訊息，但他們可以完整參與會議的音訊部分。
除了可以參與會議，使用者還可以使用其電話按鍵來管理選取的會議部分。(使用者所能管理的特定會議設定會取決於使用者是否為簡報者)。例如，依預設使用者可以按其鍵盤上的數字鍵 6，自行設定靜音或解除靜音。參與者可以私下播放參與會議的所有其他人員名字，而簡報者可對所有會議出席者設定靜音或解除靜音，以及隨時有某人加入或離開會議時啟用/停用宣告播放。
使用電話鍵盤來做選擇的功能稱為複頻式 (DTMF) 訊號：如果您曾經撥打電話號碼，並且接受指示，依照「英語請按 1，或西班牙語請按 2」的順序執行某些動作，即表示您已用過 DTMF 訊號。Get-CsDialInConferencingDtmfConfiguration 指令程式可讓您擷取所有可用的 DTMF 命令清單，以及用來執行那些命令的數字鍵。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsDialInConferencingDtmfConfiguration Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsDialInConferencingDtmfConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
字串 |
指出您要傳回之 DTMF 設定集合的唯一識別碼。若要參考通用設定，請使用此語法：-Identity global。若要參照在此站台範圍設定的集合，請使用如下語法：-Identity site:Redmond。請注意，在指定 Identity 時無法使用萬用字元。如果您必須使用萬用字元，請改用 Filter 參數。 如果未指定此參數，則 Get-CsDialInConferencingDtmfConfiguration 會傳回目前用於組織之所有 DTMF 組態設定的集合。 |
Filter |
選用 |
字串 |
可讓您使用萬用字元傳回 DTMG 組態設定的一或多個集合。若要傳回在站台範圍所設定之所有設定集合，請使用此語法：-Filter site:*。若要傳回在 Identity (您唯一可篩選的屬性) 中某處有字串值 "EMEA" 的所有設定集合，請使用此語法：-Filter *EMEA*。 |
LocalStore |
選用 |
切換參數 |
從中央管理存放區本機複本擷取 DTMF 組態資料，而不是從中央管理存放區本身擷取。 |
輸入類型
無。Get-CsDialInConferencingDtmfConfiguration 不會接受管線傳送的輸入。
傳回類型
Get-CsDialInConferencingDtmfConfiguration 傳回 Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsDialInConferencingDtmfConfiguration -Identity site:Redmond
範例 1 所示的命令會傳回 Redmond 站台的 DTMF 設定。
-------------------------- 範例 2 ------------------------
Get-CsDialInConferencingDtmfConfiguration | Select-Object Identity, HelpCommand
範例 2 會傳回所有 DTMF 設定的集合，然後針對集合中的每一個項目顯示要按的數字鍵值，以便私下播放 DTMF 命令的描述。為了執行這項作業，會呼叫 Get-CsDialInConferencingDtmfConfiguration，以便傳回目前用於組織的所有 DTMF 設定之各項屬性值集合。該集合接著會傳送到 Select-Object 指令程式，其會挑出兩個要在畫面上顯示的內容 (Identity 和 HelpCommand)。
-------------------------- 範例 3 ------------------------
Get-CsDialInConferencingDtmfConfiguration -Filter "site:*"
範例 3 所示的命令會傳回站台範圍所設定的所有 DTMF 設定。此項作業可透過包含 Filter 參數和篩選值 "site:*" 加以完成。該篩選值限制傳回具有以字元 "site:" 為開頭之 Identity 的設定資料。根據定義，那些是在站台範圍所設定的設定。
-------------------------- 範例 4 ------------------------
Get-CsDialInConferencingDtmfConfiguration | Where-Object {$_.AdmitAll -ne 8}
上述命令會傳回 AdmitAll 屬性不等於 8 (預設值) 的所有 DTMF 組態設定。若要完成此工作，會先呼叫不含任何參數的 Get-CsDialInConferencingDtmfConfiguration，以傳回目前正在使用的所有 DTMF 設定集合。接著會將此集合傳送到 Where-Object 指令程式，這樣只會挑選出 AdmitAll 屬性不等於 8 的設定。