Remove-CsConferencingConfiguration
トピックの最終更新日: 2012-05-21
指定された会議構成設定のコレクションを削除します。会議構成設定では、会議コンテンツや資料の最大許容サイズ、コンテンツの猶予期間、サポートされているクライアントの内部ダウンロード用および外部ダウンロード用の URL などを指定します。
構文
Remove-CsConferencingConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
解説
会議に関しては、運用管理を行うコマンドレットが 2 つのセットに分かれています。ユーザーに対して許可することと許可しないことを管理する場合は、CsConferencingPolicy コマンドレットを使う必要があります。これは、たとえば匿名ユーザーの会議への参加を招待できるようにすることや、会議中のアプリケーション共有の実行やファイル転送をユーザーに許可する場合です。
管理者はユーザー アクティビティのほかに、Web 会議サービス を管理する必要があります。たとえば、1 つの会議に割り当てるコンテンツ保存領域のサイズの上限を指定したり、会議資料が自動的に削除されるまでの猶予期間を指定したりできる必要があります。また管理者は、アプリケーション共有やファイル転送などのアクティビティで使用するポートも指定できる必要があります。
後から述べた方の作業は、CsConferencingConfiguration コマンドレットを使って管理できます。これらのコマンドレットを使用すると、実際のサーバーそのものを管理できます。CsConferencingConfiguration コマンドレット (グローバル スコープ、サイト スコープ、およびサービス スコープに適用できます) では、ユーザーに対して会議中のアプリケーション共有を許可するかどうかを指定することはできませんが、アプリケーション共有が許可されている場合はこのコマンドレットを使って、そのアクティビティに使用するポートを指定できます。同様に、このコマンドレットを使用して、保存領域の上限や有効期限、ユーザーが会議に関するヘルプや資料を取得できる内部 URL および外部 URL などを指定できます。
Remove-CsConferencingConfiguration コマンドレットでは、組織内で使用するよう作成された会議構成設定のカスタム コレクションのいずれかを削除できます。設定のコレクションを削除すると、その設定によってそれまで適用されていたサーバーは、自動的に次の階層 (サービス - サイト - スコープ) のコレクションによって管理されるようになります。削除した設定がサービス スコープに適用されていた場合は、該当するサーバーはサイト設定で管理されるようになります。サイト スコープに設定がない場合は、該当するサーバーはグローバル設定で管理されるようになります。同様に、サイト スコープの設定を削除した場合、そのサイト設定によってそれまで管理されていたサーバーは、グローバル設定で管理されるようになります。
なお、Remove-CsConferencingConfiguration はグローバル設定に対しても実行できます。ただし、その場合、グローバル設定は削除されません (Microsoft Lync Server 2010 ではグローバル設定を削除できないため)。その代わりに、グローバル コレクション内のすべてのプロパティが既定値でリセットされます。たとえば、それまでコンテンツの保存領域のサイズの上限値を 200 MB に変更していた場合、このプロパティは既定値の 100 MB にリセットされます。
このコマンドレットを実行できるユーザー: 既定では、Remove-CsConferencingConfiguration コマンドレットをローカルで実行する権限があるのは、RTCUniversalServerAdmins グループのメンバーです。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsConferencingConfiguration"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
必須 |
Xds Identity |
削除する会議構成設定コレクションの一意の識別子。サイト スコープで構成されている設定を削除するには、次のような構文を使用します: -Identity "site:Redmond"。サービス スコープで構成されている設定を削除するには、次のような構文を使用します: -Identity "service:ConferencingServer:atl-cs-001.litwareinc.com"。 Remove-CsConferencingConfiguration はグローバル設定に対しても実行できます。ただしこの場合設定は削除されず、代わりにすべてのプロパティが既定値にリセットされます。 |
Force |
省略可能 |
スイッチ パラメーター |
コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
スイッチ パラメーター |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
スイッチ パラメーター |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Settings.WebConf.ConfSettings オブジェクトです。Remove-CsConferencingConfiguration は、会議構成オブジェクトのインスタンスをパイプ処理で受け入れます。
戻り値の種類
なし。代わりに、Remove-CsConferencingConfiguration は、Microsoft.Rtc.Management.WritableConfig.Settings.WebConf.ConfSettings オブジェクトの既存のインスタンスを削除します。
例
-------------------------- 例 1 --------------------------
Remove-CsConferencingConfiguration -Identity site:Redmond
上のコマンドを実行すると、Redmond サイトに適用されていた会議構成設定が削除されます。このようなサイト設定が削除されると、そのサイトのユーザーは、グローバル会議構成設定の各種設定を自動的に継承します。
-------------------------- 例 2 --------------------------
Get-CsConferencingConfiguration -Filter site:* | Remove-CsConferencingConfiguration
例 2 に示すコマンド を実行すると、サイト スコープに適用されていたすべての会議構成設定が削除されます。これを行うため、まず Get-CsConferencingConfiguration に Filter パラメーターとフィルター値 "site:" を指定して呼び出します。これにより、"site:" という文字列で始まる ID を持つ設定だけが戻されます。次に、このフィルター処理されたコレクションを Remove-CsConferencingConfiguration にパイプ処理し、コレクション内の各項目を削除しています。
-------------------------- 例 3 --------------------------
Get-CsConferencingConfiguration | Where-Object {$_.Organization -ne "Litwareinc"} | Remove-CsConferencingConfiguration
例 3 では、組織が Litwareinc に設定されていないすべての会議構成設定が削除されます。これを行うため、まず、パラメーターを指定せずに Get-CsConferencingConfiguration を呼び出して、組織で使用されているすべての会議構成設定のコレクションを戻します。次に、このコレクションを Where-Object コマンドレットにパイプ処理し、Organization プロパティが Litwareinc に等しくない設定のみを選択します。最後に、フィルターされたコレクションを Remove-CsConferencingConfiguration にパイプ処理し、コレクション内のすべての設定を削除します。