Remove-CsFileTransferFilterConfiguration
上一次修改主题： 2012-03-25
删除指定的即时消息文件传输筛选器配置。（即时消息文件传输筛选器设置用于阻止用户在即时消息内传输特定类型的文件。）
语法
Remove-CsFileTransferFilterConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
发送即时消息时，用户可能会附加文件并将其发送到对话中的其他参与者。可以将 Microsoft Lync Server 2010 配置为不允许使用 Lync Server 2010 客户端发送具有特定扩展名（通常为可能有害的文件类型的扩展名）的文件。
通过 Remove-CsFileTransferFilterConfiguration cmdlet，可以删除文件传输筛选器配置。对于 site 作用域的配置，Remove-CsFileTransferFilterConfiguration 将删除配置；而站点上的用户将自动继承全局文件传输筛选器配置。还可以针对全局配置运行 Remove-CsFileTransferFilterConfiguration。但是，这种情况下不会删除全局配置，而是将该配置中的所有属性都重置为其默认值。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsFileTransferFilterConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsFileTransferFilterConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
要删除的文件传输配置的唯一标识符。要引用全局配置，请使用以下语法：-Identity global。要在 site 作用域引用配置，请使用类似如下的语法：-Identity site:Redmond。请注意，指定 Identity 时不能使用通配符值。 |
Force |
可选 |
开关参数 |
在进行更改前取消可能另外显示的任何确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration 对象。接受通过管道传递的文件传输筛选器配置对象的输入。
返回类型
此 cmdlet 不会返回值或对象。它会删除 Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Remove-CsFileTransferFilterConfiguration -Identity site:Redmond
在上述示例中，使用 Remove-CsFileTransferFilterConfiguration 删除 Identity 为 site:Redmond 的文件传输筛选器配置。
-------------------------- 示例 2 --------------------------
Get-CsFileTransferFilterConfiguration -Filter site:* | Remove-CsFileTransferFilterConfiguration
在示例 2 中，将删除 site 作用域的所有文件传输筛选器配置。为完成此任务，该命令首先使用 Get-CsFileTransferFilterConfiguration 和 Filter 参数以返回 site 作用域的所有配置。筛选器值“site:*”指示 Get-CsFileTransferFilterConfiguration 仅返回 Identity 以字符串值“site:”开头的配置。然后，将筛选出的配置集合通过管道传递到 Remove-CsFileTransferFilterConfiguration，后者将删除集合中的每一项。
-------------------------- 示例 3 --------------------------
Get-CsFileTransferFilterConfiguration | Where-Object {$_.Enabled -eq $False} | Remove-CsFileTransferFilterConfiguration
示例 3 说明了如何删除当前禁用的所有文件传输筛选器配置。为执行此操作，该命令首先使用 Get-CsFileTransferFilterConfiguration 返回当前组织中使用的所有文件传输筛选器配置的集合。将该信息通过管道传递到 Where-Object cmdlet，后者将仅选择 Enabled 属性等于 (-eq) False ($False) 的文件传输筛选器配置。然后，将筛选出的集合通过管道传递到 Remove-CsFileTransferFilterConfiguration，后者将继续删除该集合中的每一项。