Remove-CsImFilterConfiguration
上一次修改主题： 2012-03-27
删除指定的即时消息 (IM) 筛选器配置。（IM 筛选器设置用于阻止用户发送包含超链接的即时消息。）
语法
Remove-CsImFilterConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
发送即时消息时，用户可能会在该消息文本中嵌入统一资源标识符 (URI)，以便将对话中的其他参与者指引到特定网站或共享。可以将 Microsoft Lync Server 2010 配置为阻止包含某些前缀的超链接，或者使这类超链接处于非活动状态。（也就是说，只单击该链接，这些参与者将无法转至 URI 所指向的站点；他们必须手动将链接复制并粘贴到浏览器中。）
Remove-CsImFilterConfiguration cmdlet 删除指定标识（如某个特定站点）的 IM 筛选器配置。针对 Global 标识运行此 cmdlet 会将全局配置重置为默认设置。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsImFilterConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsImFilterConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
要删除的配置的唯一标识。此标识将为 Global 或 Site:<site name>（其中 <site name> 表示设置所适用于的站点的名称）。 完整数据类型：Microsoft.Rtc.Management.Xds.XdsIdentity |
Force |
可选 |
开关参数 |
禁止显示任何本该在进行更改前显示的确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration 对象。接受通过管道传递的 IM 筛选器配置对象的输入。
返回类型
删除一个类型为 Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration 的对象。
示例
-------------------------- 示例 1 --------------------------
Remove-CsImFilterConfiguration -Identity site:Redmond
在示例 1 中，使用 Remove-CsImFilterConfiguration 删除 Identity 为 site:Redmond 的 IM 筛选器配置。从站点中删除 IM 筛选器配置后，该站点将自动开始在其位置使用全局设置。
-------------------------- 示例 2 --------------------------
Get-CsImFilterConfiguration -Filter site:* | Remove-CsImFilterConfiguration
在示例 2 中，将删除 site 作用域的所有 IM 筛选器配置。为完成此任务，该命令首先使用 Get-CsImFilterConfiguration 和 Filter 参数返回 site 作用域的所有配置；通配符字符串 site:* 指示 Get-CsImFilterConfiguration 仅返回 Identity 以字符串值 site: 开头的配置。然后，将筛选出的配置集合通过管道传递给 Remove-CsImFilterConfiguration，后者删除集合中的每个配置。