次の方法で共有


New-CsDialInConferencingDtmfConfiguration

 

トピックの最終更新日: 2012-03-23

ダイヤルイン会議に使用するデュアルトーン多重周波数 (DTMF) シグナリング設定の新しいコレクションを作成します。DTMF を使用すると、会議にダイヤルインするユーザーは、電話のキーパッドで会議設定 (自身をミュートおよびミュート解除したり、会議をロックおよびロック解除するなど) を制御できます。

構文

New-CsDialInConferencingDtmfConfiguration -Identity <XdsIdentity> [-AdmitAll <String>] [-AudienceMuteCommand <String>] [-CommandCharacter <String>] [-Confirm [<SwitchParameter>]] [-EnableDisableAnnouncementsCommand <String>] [-Force <SwitchParameter>] [-HelpCommand <String>] [-InMemory <SwitchParameter>] [-LockUnlockConferenceCommand <String>] [-MuteUnmuteCommand <String>] [-PrivateRollCallCommand <String>] [-WhatIf [<SwitchParameter>]]

解説

Microsoft Lync Server 2010 では、ユーザーは電話を介してダイヤルインすることで会議に参加できます。ダイヤルイン ユーザーは、ビデオの表示や会議の他の参加者とのインスタント メッセージの交換はできませんが、会議の音声部分には完全に参加できます。

ユーザーは会議に参加できるだけでなく、電話のキーパッドを使用してその会議の選択した部分を管理することもできます (この特定の会議の設定をユーザーが管理可能かどうかは、ユーザーが発表者であるかないかによって変わります)。たとえば既定では、ユーザーはキーパッドの 6 キーで自身をミュートまたはミュート解除できます。参加者は、会議に参加している他のすべてのメンバーの名前を自分だけに再生できますが、発表者は会議の参加者全員をミュートまたはミュート解除したり、誰かが会議に参加したり会議から退室するたびに再生されるアナウンスを有効または無効にするなどができます。

電話のキーパッドを使用してこのような選択を行う機能を、デュアルトーン多重周波数 (DTMF) シグナリングといいます。ある電話番号にダイヤルして、"英語の場合は 1 を、スペイン語の場合は 2 を押してください" のような指示を受けた場合、DTMF シグナリングを使用しています。

Lync Server 2010 をインストールするときに、DTMF 設定のグローバル コレクションが作成されます。このようなグローバル設定に加え、New-CSDialInConferencingDtmfConfiguration コマンドレットを使用して、サイトごとにカスタム設定を作成できます。たとえば、Redmond サイト (ただし Redmond サイトのみ) に対して、ミュートとミュート解除用に 6 キーの代わりに 4 キーを使用する設定の新しいコレクションを作成できます。サイト スコープで構成する設定はすべて、グローバル スコープで構成された設定よりも優先されることに注意してください。そのため、グローバル設定で 6 キーがミュートとミュート解除用に使用されていても、Redmond サイトのユーザーは 4 キーをミュートとミュート解除用のキーとして使用します。

DTMF 設定のコレクションおよびグローバル コレクションは、1 つのサイトにつき 1 つしか持つことができません。たとえば、site:Redmond という ID を持つコレクションが既に存在し、次のコマンドを実行するとします。

New-CSDialInConferencingDtmfConfiguration –Identity site:Redmond

site:Redmond コレクションは既に存在するため、このコマンドは失敗します。Redmond サイトの設定を変更する場合、Set-CSDialInConferencingDtmfConfiguration コマンドレットを使用するか、または既存のコレクションを削除して site:Redmond という ID を使用する新しいコレクションを作成します。

DTMF コマンドの値を構成する際には、次の 2 点に注意してください。まず、0 ~ 9 のテンキーとアスタリスク (*) のみが使用できるという点です。キーパッドにその他のキーがあっても (たとえば # キー) 使用できません。(唯一の例外として、CommandCharacter キーでは * キーまたは # キーのみ使用できます)。2 点目は、コマンドには一意のキーを割り当てる必要があるということです。たとえば、4 キーはミュートまたはミュート解除と会議のロックまたはロック解除の両方には使用できません。つまり、コマンドに割り当てられているキーを変更する場合、異なる 2 つのコマンドで使用されるキーを交換する必要のある場合があります。たとえば、4 キーを EnableDisableAnnouncementsCommand (既定値: 9) に割り当てる場合、同じコマンドで、9 キーを AudienceMuteCommand に割り当てる必要があります。

コマンドを無効にするには、値を Null ($Null) に設定します。

このコマンドレットを実行できるメンバー。既定では、次のグループのメンバーが、New-CsDialInConferencingDtmfConfiguration コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsDialInConferencingDtmfConfiguration"}

パラメーター

パラメーター 必須 説明

Identity

必須

Xds Identity

DTMF の構成設定の新しいコレクションに割り当てる一意の識別子。新しいコレクションはサイト スコープのみで作成できるので、Identity には常に "site:" のプレフィックスが付きます。その後にサイト名が続きます。たとえば、"site:Redmond" です。

AdmitAll

省略可能

文字列

ロビーにいるすべてのユーザーがすぐに会議に参加できるようにするために押すキーを示します。既定値は 8 です。

AudienceMuteCommand

省略可能

文字列

発表者が押すと、会議の他の参加者全員をミュートまたはミュート解除 (つまり、発表者以外の全員をミュートまたはミュート解除) できるキーを示します。既定のキーは 4 です。

CommandCharacter

省略可能

文字列

コマンドの最初に押すキーを示します。既定のキーは、アスタリスク (*) です。それ以外に使用できる値は # のみです。

EnableDisableAnnouncementsCommand

省略可能

文字列

誰かが会議に参加したり会議から退場するたびに再生されるアナウンスを有効または無効にするために押すキーを示します。既定のキーは 9 です。

HelpCommand

省略可能

文字列

すべての DTMF コマンドの詳細を自分だけに再生するために押すキーを示します。既定のキーは 1 です。

LockUnlockConferenceCommand

省略可能

文字列

会議をロックまたはロック解除するのに押すキーを示します。ある会議がロックされている場合、少なくともこの会議のロックが解除されるまで、新しい参加者は会議に参加できません。既定のキーは 7 です。

MuteUnmuteCommand

省略可能

文字列

自分の声をミュートまたはミュート解除するために押すキーを示します。同じキーを使用して、ミュートとミュート解除を切り替えます。既定のキーは 6 です。

PrivateRollCallCommand

省略可能

文字列

会議の各参加者の名前を自分だけに再生するために押すキーを示します。既定のキーは 3 です。

Force

省略可能

スイッチ パラメーター

コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。

InMemory

省略可能

SwitchParameter

永続的な変更としてオブジェクトをコミットせずに、オブジェクト参照を作成します。このパラメーターを指定して呼び出したコマンドレットの出力を変数に割り当てる場合、オブジェクト参照のプロパティを変更し、コマンドレットに対応する Set- コマンドレットを呼び出してそれらの変更をコミットできます。

WhatIf

省略可能

SwitchParameter

実際にコマンドを実行せずに、コマンドの実行結果がわかります。

Confirm

省略可能

SwitchParameter

コマンドの実行前に確認メッセージを表示します。

入力の種類

なし。New-CsDialInConferencingDtmfConfiguration は、パイプ処理された入力を受け入れません。

戻り値の種類

Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration オブジェクトの新しいインスタンスを作成します。

-------------------------- 例 1 ------------------------

New-CSDialInConferencingDtmfConfiguration -Identity site:Redmond -MuteUnmuteCommand 4 -AudienceMuteCommand 6

例 1 に示すコマンドでは、Redmond サイト用に DTMF 構成設定の新しいセットを作成しています。この例では、MuteUnmuteCommand プロパティを 4 に、AudienceMuteCommand プロパティを 6 に設定しています。

-------------------------- 例 2 ------------------------

New-CSDialInConferencingDtmfConfiguration -Identity site:Redmond -AdmitAll $Null

上記のコマンドでは、Redmond サイト用に DTMF 構成設定の新しいセットを作成しています。この例では、AdmitAll プロパティを無効にしています。これを行うために、AdmitAll パラメーターを使用し、このパラメーター値を Null に設定しています。

-------------------------- 例 3 ------------------------

$x = New-CSDialInConferencingDtmfConfiguration -Identity site:Redmond -InMemory
$x.AdmitAll = $Null
$x.MuteUnmuteCommand = 4 
$x.AudienceMuteCommand = 6
Set-CSDialInConferencingDtmfConfiguration -Instance $x

例 3 では、InMemory パラメーターを使用して、DTMF 構成設定のコレクションのメモリ内専用インスタンスを作成し、これらの設定を変更する方法を示しています。さらに、Set-CSDialInConferencingDtmfConfiguration を使用して、site:Redmond という ID を持つ実際のコレクションを作成しています。これを行うために、例の最初のコマンドで、DTMF 構成設定のコレクションの新しいメモリ内専用インスタンスを作成し、$x という変数にそのインスタンスを格納しています。これらの設定はメモリ内のみに存在するため、Windows PowerShell を終了したり変数 $x を削除すると、設定は失われて、Redmond サイトに適用されなくなります。

次の 3 つのコマンドでは、"仮想の" DTMF 設定のコレクションのプロパティを変更しています。2、3、および 4 番目のコマンドで、それぞれ AdmitAll、MuteUnmuteCommand、および AudienceMuteCommand に新しい値を割り当てています。次に、最後のコマンドで、Set-CSDialInConferencingDtmfConfiguration と Instance パラメーターを使用して、$x に格納されている仮想の設定を Redmond サイト用に構成される設定の実際のコレクションに変換しています。