Get-CsImFilterConfiguration
上一次修改主题： 2012-03-23
返回在组织中配置的即时消息 (IM) 链接筛选器。这些筛选器用于阻止用户发送包含带有特定前缀的超链接（例如，以 http 或 telnet 为前缀的链接）的即时消息。这意味着，以此类架构之一开头的任何统一资源标识符 (URI) 都将转换为不可单击的超链接或将完全删除，具体取决于您的设置。
语法
Get-CsImFilterConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsImFilterConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
详细说明
发送即时消息时，用户可能会在该消息文本中嵌入 URI，以便将对话中的其他参与者指引到特定网站或共享。可以将 Microsoft Lync Server 2010 配置为阻止包含某些前缀的超链接，或者使这类超链接处于非活动状态。（也就是说，只单击该链接，这些参与者将无法转至 URI 所指向的站点；他们必须手动将链接复制并粘贴到浏览器中。）
Get-CsImFilterConfiguration cmdlet 可检索用于筛选即时消息中的 URI 的所有设置。单独调用 Get-CsImFilterConfiguration（不带参数）可返回所有 URI IM 筛选器设置（包括全局设置和适用于所有站点的设置）。您也可以指定 Identity 以显示特定站点的设置（或全局设置）。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsImFilterConfiguration cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsImFilterConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
要检索的设置的唯一标识符。此标识符将为 global 或 site:>site name<，其中 >site name< 是应用这些设置的站点的名称，如 site:Redmond。 完整数据类型：Microsoft.Rtc.Management.Xds.XdsIdentity |
Filter |
可选 |
字符串 |
执行通配符搜索以查找与给定的 Identity 模式相匹配的配置。例如，返回标识以 site* 开头的所有设置（所有特定于站点的设置）。 |
LocalStore |
可选 |
开关参数 |
从中央管理存储的本地副本，而不是从中央管理存储本身检索 IM 筛选器配置。 |
输入类型
无。
返回类型
Get-CsImFilterConfiguration 返回 Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsImFilterConfiguration
上面显示的命令返回配置为在组织中使用的所有 IM 超链接筛选器的集合。这是调用不带其他任何参数的 Get-CsImFilterConfiguration 时的行为。
-------------------------- 示例 2 --------------------------
Get-CsImFilterConfiguration -Identity site:Redmond
上述示例返回一个 IM 筛选器的设置：Identity 为 site:Redmond 的设置。由于标识必须唯一，因此此命令绝不会返回多个配置。
-------------------------- 示例 3 --------------------------
Get-CsImFilterConfiguration -Filter site:*
示例 3 使用 Filter 参数返回在站点级别配置的所有 IM 筛选器的集合。通配符字符串 site:* 指示 Get-CsImFilterConfiguration 仅返回 Identity 以字符串值 site: 开头的 IM 筛选器配置。
-------------------------- 示例 4 --------------------------
(Get-CsImFilterConfiguration -Identity Global).Prefixes
在示例 4 中，当显示在屏幕上时，全局 IM 筛选器配置的 Prefixes 属性的值将“展开”，这意味着以更加用户友好和易读的方式显示该属性及其值。为执行此任务，首先使用 Get-CsImFilterConfiguration 检索全局 IM 筛选器配置。（请注意，对 Get-CsImFilterConfiguration 的调用包含在括号中。这将指示 Windows PowerShell 首先执行括号中的命令，然后再继续执行其他命令。）检索配置后，将显示 Prefixes 属性的值，每行中显示一个前缀。