Remove-CsDialInConferencingConfiguration
トピックの最終更新日: 2012-03-26
1 つまたは複数のダイヤルイン会議の構成設定のコレクションを削除します。これらの設定では、ユーザーがダイヤルイン会議に参加したり、またはダイヤルイン会議から退出したりするときの Microsoft Lync Server 2010 の応答方法を決定します。
構文
Remove-CsDialInConferencingConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
解説
ユーザーがダイヤルイン会議に参加したり、またはダイヤルイン会議から退出したりするときに、Lync Server 2010 はさまざまな方法で応答できます。たとえば、実際に会議に参加する前に、参加者に自分の名前を記録するよう求めることができます。同様に、管理者は、ダイヤルイン参加者の会議からの退出または会議への参加時に、Lync Server による通知を行うかどうかを決定できます。
このような会議への "参加に関する動作" は、ダイヤルイン会議の構成設定を使用して管理します。これらの設定は、グローバル スコープまたはサイト スコープで構成できます (サイト スコープで構成した設定は、グローバル スコープで構成した設定より優先されます)。Lync Server のインストール時に、ダイヤルイン会議の構成設定のグローバル コレクションが作成されます。サイトやサイトのセットによって異なる設定を行いたい場合は、New-CSDialInConferencingConfiguration コマンドレットを使用して、それらのサイト用のコレクションを作成できます。
Remove-CSDialInConferencingConfiguration コマンドレットを使用すると、サイト スコープで構成されているダイヤルイン会議設定を削除できます。このようなサイト固有の設定を削除すると、影響を受けたサイトのユーザーのダイヤルイン会議での動作はグローバル設定によって管理されます。
Remove-CSDialInConferencingConfiguration をグローバルのダイヤルイン会議設定に対して実行することもできます。この操作を実行しても、グローバル設定は削除されません。グローバル設定は削除できないようになっているからです。代わりに、グローバル設定のコレクション内のすべてのプロパティが既定値にリセットされます。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、Remove-CsDialInConferencingConfiguration コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsDialInConferencingConfiguration"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
必須 |
Xds Identity |
削除するダイヤルイン会議の構成設定の Identity を示します。グローバル設定を参照するには、次の構文を使用します。-Identity global。サイト設定を参照するには、次のような構文を使用します。-Identity site:Redmond。Identity 指定時はワイルドカードを使用できないことに注意してください。 |
Force |
省略可能 |
SwitchParameter |
コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingConfiguration オブジェクト。Remove-CSDialInConferencingConfiguration はダイヤルイン会議構成オブジェクトのパイプライン処理されたインスタンスを受け入れます。
戻り値の種類
なし。代わりに、Remove-CSDialInConferencingConfiguration は、Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingConfiguration オブジェクトのインスタンスを削除します。
例
-------------------------- 例 1 ------------------------
Remove-CSDialInConferencingConfiguration -Identity "site:Redmond"
例 1 では、Redmond サイト用のダイヤルイン会議の構成設定を削除しています。
-------------------------- 例 2 ------------------------
Get-CSDialInConferencingConfiguration -Filter "site:*" | Remove-CSDialInConferencingConfiguration
上記の例では、サイト スコープで構成されているダイヤルイン会議の構成設定をすべて削除しています。これを実行するには、コマンドはまず Get-CSDialInConferencingConfiguration と Filter パラメーターを使用して、サイト スコープで構成されているすべてのダイヤルイン会議設定のコレクションを戻します (フィルター値 "site:*" を指定して、文字列値 "site:" で始まる Identity を持つ設定のみを戻すようにします)。次に、このフィルター処理されたコレクションを Remove-CSDialInConferencingConfiguration にパイプ処理され、コレクション内の各項目を削除しています。
-------------------------- 例 3 ------------------------
Get-CSDialInConferencingConfiguration | Where-Object {$_.EnableNameRecording -eq $False} | Remove-CSDialInConferencingConfiguration
例 3 では、名前の記録を使用していないダイヤルイン会議の構成設定を削除しています。このタスクを実行するには、コマンドはまず、Get-CSDialInConferencingConfiguration をパラメーターなしで呼び出し、組織で現在使用されているすべてのダイヤルイン会議の構成設定のコレクションを戻します。次に、このコレクションが Where-Object コマンドレットにパイプ処理され、EnableNameRecording プロパティが False と等しい設定のみを選び出します。さらに、このフィルター処理されたコレクションを Remove-CSDialInConferencingConfiguration にパイプ処理し、コレクション内の各項目を削除します。