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 コマンドレットを使用して、サイトごとにカスタム設定を作成できます。サイト スコープで作成する設定は、後で Remove-CSDialInConferencingDtmfConfiguration コマンドレットを使用して削除できます。サイト スコープで適用されている DTMF 設定を削除すると、影響を受けるサイトのユーザーは、自動的にグローバル DTMF 構成設定で管理されるようになります。
Remove-CSDialInConferencingDtmfConfiguration は、グローバル設定に対しても実行できます。ただし、この操作を実行しても、グローバル設定は削除されません。グローバル DTMF 設定は削除できないようになっているためです。代わりに、グローバル設定のプロパティが既定値にリセットされます。たとえば、4 キーをミュート/ミュート解除キーにするよう、グローバル設定を変更したとします。ここで、グローバル設定に対して Remove-CSDialInConferencingDtmfConfiguration を実行すると、ミュート/ミュート解除キーの値は既定値の 6 にリセットされます。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、Remove-CsDialInConferencingDtmfConfiguration コマンドレットのローカル実行を承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsDialInConferencingDtmfConfiguration"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
必須 |
XdsIdentity |
削除する DTMF 設定のコレクションを表す一意の識別子です。グローバル設定を "削除" するには、次の構文を使用します。-Identity global。(前に説明したとおり、グローバル設定を実際に削除することはできません。プロパティを既定値にリセットできるだけです)。サイト スコープで構成されているコレクションを削除するには、次のような構文を使用します。-Identity site:Redmond。ID 指定時にワイルドカードを使用することはできません。 |
Force |
省略可能 |
スイッチ パラメーター |
コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
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
上記のコマンドでは、ID が site:Redmond である DTMF 構成設定のコレクションを削除しています。
-------------------------- 例 2 ------------------------
Get-CSDialInConferencingDtmfConfiguration -Filter "site:*" | Remove-CSDialInConferencingDtmfConfiguration
例 2 に示すコマンドでは、サイト スコープで構成されている DTMF 設定をすべて削除しています。このタスクを実行するため、コマンドでまず Get-CSDialInConferencingDtmfConfiguration と Filter パラメーターを使用して、サイト スコープで構成されているすべての DTMF 設定のコレクションを戻します。フィルター値 "site:*" により、文字列値 "site" で始まる ID を持つ設定のみが返されます。次に、このフィルター処理したコレクションは 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 にパイプ処理され、コレクション内の各項目が削除されます。