Remove-CsImFilterConfiguration
トピックの最終更新日: 2012-03-27
指定のインスタント メッセージング (IM) フィルター構成を削除します (IM フィルター設定は、ユーザーがハイパーリンクを含むインスタント メッセージを送信しないようにするために使用されます)。
構文
Remove-CsImFilterConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
解説
インスタント メッセージを送信するときに、ユーザーはメッセージのテキスト内に Uniform Resource Identifier (URI) を埋め込んで、会話している他の参加者に対して、特定の Web サイトまたは共有場所を参照させることができます。特定のプレフィックスを持つハイパーリンクをブロックするかアクティブではなくなるように、Microsoft Lync Server 2010 を構成できます (つまり、参加者はリンクをクリックしただけでは URI の参照先サイトにアクセスできず、リンクを手動でコピーしてブラウザーに貼り付ける必要があります)。
Remove-CsImFilterConfiguration コマンドレットを実行すると、指定の ID (特定のサイトなど) の IM フィルター構成を削除できます。Global ID に対してこのコマンドレットを実行すると、グローバル構成が既定の設定に単にリセットされます。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、Remove-CsImFilterConfiguration コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsImFilterConfiguration"}
パラメーター
パラメーター | 必須かどうか | 型 | 説明 |
---|---|---|---|
Identity |
必須 |
XdsIdentity |
削除する構成の一意の識別子。Global または Site:<サイト名> のいずれかになります (ここで、<サイト名> は、設定を適用するサイトの名前を示します)。 完全なデータ型:Microsoft.Rtc.Management.Xds.XdsIdentity |
Force |
省略可能 |
SwitchParameter |
変更を行う前に表示されるように設定されているすべての確認メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration オブジェクト。IM フィルター構成オブジェクトのパイプライン処理された入力を受け入れます。
戻り値の種類
Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration 型のオブジェクトを削除します。
例
-------------------------- 例 1 --------------------------
Remove-CsImFilterConfiguration -Identity site:Redmond
例 1 では、Remove-CsImFilterConfiguration を使用して、site:Redmond という Identity を持つ IM フィルター構成を削除しています。サイトから IM フィルター構成を削除すると、そのサイトでは、代わりにグローバル設定の使用が自動的に開始されます。
-------------------------- 例 2 --------------------------
Get-CsImFilterConfiguration -Filter site:* | Remove-CsImFilterConfiguration
例 2 では、サイト スコープでのすべての IM フィルター構成が削除されます。このタスクを実行するには、コマンドでまず、Get-CsImFilterConfiguration および Filter パラメーターを使用して、サイト スコープでのすべての構成を戻します。ワイルドカード site:* を使用して、先頭が site: という文字列の Identity を持つ構成のみを戻すように、Get-CsImFilterConfiguration に指示します。次に、フィルター処理した構成のコレクションを Remove-CsImFilterConfiguration にパイプ処理して、コレクション内の各構成を削除します。