Get-CsFileTransferFilterConfiguration
上一次修改主题: 2012-03-23
返回组织中的文件传输筛选器配置。这些配置阻止用户使用 Microsoft Lync Server 2010 客户端传输特定类型的文件,例如文件扩展名为 .vbs 或 .ps1 的文件。
语法
Get-CsFileTransferFilterConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsFileTransferFilterConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
详细说明
发送即时消息时,用户可附加文件并将其发送给会话中的其他参与者。可以配置 Lync Server 2010,以禁止使用 Lync Server 2010 客户端发送具有特定扩展名的文件,通常是具有潜在危害的文件扩展名类型。
Get-CsFileTransferFilterConfiguration cmdlet 提供了一种检索特定设置(可以在 global 作用域或在 site 作用域配置这些设置)集合的方式。文件传输筛选器配置包括禁止传输的文件扩展名列表、启用筛选的程度(禁止所有文件传输或仅禁止具有指定扩展名的文件)以及是否启用文件传输筛选。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Get-CsFileTransferFilterConfiguration cmdlet:RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsFileTransferFilterConfiguration"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
可选 |
Xds 标识 |
要检索的文件传输筛选器配置的唯一标识符。要引用全局设置,请使用此语法:-Identity global。要引用在 site 作用域配置的设置,请使用类似如下的语法:-Identity site:Redmond。请注意,指定 Identity 时不能使用通配符值。如果要使用通配符,请改用 Filter 参数。 |
Filter |
可选 |
字符串 |
使您可以在指定要返回的文件传输筛选器配置时使用通配符。例如,要返回 site 作用域的所有文件传输筛选器设置,请使用以下语法:-Filter "site:*"。根据设计,Identity(唯一可筛选的属性)以字符串值“site:”开头的文件传输筛选器配置在 site 作用域配置。 |
LocalStore |
可选 |
开关参数 |
从中央管理存储的本地副本,而不是从中央管理存储本身检索文件传输筛选器配置。 |
输入类型
无。
返回类型
Get-CsFileTransferFilterConfiguration 返回 Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsFileTransferFilterConfiguration
示例 1 中显示的命令返回在组织中使用的所有文件传输筛选器配置的集合。每次调用不带任何其他参数的 Get-CsFileTransferFilterConfiguration 时,都会采用此默认行为。
-------------------------- 示例 2 --------------------------
Get-CsFileTransferFilterConfiguration -Identity site:Redmond
上述示例返回单个文件传输筛选器配置:Identity 为 site:Redmond 的配置。由于标识必须唯一,因此此命令绝不会返回多个配置。
-------------------------- 示例 3 --------------------------
Get-CsFileTransferFilterConfiguration -Filter site:*
示例 3 使用 Filter 参数返回站点级别的所有文件传输筛选器配置的集合。Filter 值“site:*”指示 Get-CsFileTransferFilterConfiguration 仅返回 Identity 以字符串值“site:”开头的配置。
-------------------------- 示例 4 --------------------------
Get-CsFileTransferFilterConfiguration | Where-Object {$_.Extensions -contains ".xls"}
示例 4 中显示的命令仅返回在禁止使用的文件扩展名列表中包含 .xls 的文件传输筛选器配置。为执行此操作,首先使用 Get-CsFileTransferFilterConfiguration 返回在组织中使用的所有配置的集合。然后,将此集合通过管道传递到 Where-Object cmdlet,后者所应用的筛选器将返回的数据限制为 Extensions 属性包括 (-contains)“.xls”字符串值的配置。
-------------------------- 示例 5 --------------------------
Get-CsFileTransferFilterConfiguration | Where-Object {$_.Enabled -eq $False}
上述命令返回当前已禁用的所有文件传输筛选器配置。为完成此任务,使用 Get-CsFileTransferFilterConfiguration 返回在组织中使用的所有配置的集合。然后,将该集合通过管道传递到 Where-Object cmdlet,后者会仅选择 Enabled 属性等于 (-eq) True ($True) 的配置。
-------------------------- 示例 6 --------------------------
Get-CsFileTransferFilterConfiguration -Identity Global | Select-Object -ExpandProperty Extensions
示例 6 显示了全局文件传输筛选器配置所禁止使用的文件扩展名的完整列表。该命令先调用 Get-CsFileTransferFilterConfiguration cmdlet 来指定全局配置。然后将返回的信息通过管道传递到 Select-Object cmdlet,该 cmdlet 使用 ExpandProperty 参数来展开 Extensions 属性值。结果是在屏幕上显示文件扩展名的完整列表,每行显示一个文件扩展名。