Set-CsFileTransferFilterConfiguration
上一次修改主题： 2012-03-26
修改文件传输筛选器配置设置的集合。文件传输筛选器设置用于阻止用户使用 Microsoft Lync Server 2010 客户端传输某些类型的文件（例如，带有 .vbs 或 .ps1 文件扩展名的文件）。
语法
Set-CsFileTransferFilterConfiguration [-Identity <XdsIdentity>] [-Action <BlockAll | Block>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Extensions <PSListModifier>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsFileTransferFilterConfiguration [-Action <BlockAll | Block>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Extensions <PSListModifier>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]
详细说明
发送即时消息时，用户可能会附加文件并将其发送到对话中的其他参与者。可以对 Lync Server 2010 进行配置，以便不允许从该客户端发送带有某些扩展名（通常是可能证明有害的文件类型的扩展名）的文件。
用户使用 Lync Server 2010 客户端传输文件的能力取决于在 global 作用域或（可选）site 作用域应用的文件传输筛选器配置设置。通过 Set-CsFileTransferFilterConfiguration cmdlet，您可以修改现有的文件传输筛选器配置。可以通过添加或删除扩展名，或者完全创建一个新列表来修改将被阻止的扩展名列表。您还可以使用此 cmdlet 更改是否启用文件传输筛选，以及执行该操作的级别（仅阻止其扩展名与扩展名列表中的扩展名匹配的文件，或阻止所有文件）。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsFileTransferFilterConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsFileTransferFilterConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
字符串 |
要修改的文件传输配置的唯一标识符。该值将为 global 或 site:<site name>，其中 <site name> 是应用设置的站点的名称，例如 site:Redmond。 如果未指定此参数，则在默认情况下，Set-CsFileTransferFilterConfiguration 将更新全局设置。 |
Instance |
可选 |
FileTransferFilterConfiguration |
用于将对某个对象的引用传递到 cmdlet，而不是设置各个参数值。此对象必须为 FileTransferFilterConfiguration 类型，并且可以通过调用 Get-CsFileTransferFilterConfiguration cmdlet 来检索。 |
Action |
可选 |
字符串 |
确定启用此文件传输筛选器配置后要进行的操作。如果设置为 BlockAll，则无论文件扩展名为何，都将禁止所有文件传输。如果设置为 Block（默认值），则除非文件扩展名显示为 Extensions 属性中所列的某种被禁止的文件类型，否则将允许文件传输。 要使文件传输不受限制（即允许用户交换任何类型的文件，而不考虑文件扩展名），请将此策略的 Enabled 属性设置为 False。 |
Enabled |
可选 |
布尔值 |
启用或禁用文件传输筛选。如果此参数设置为 True，则无法从客户端传输带有指定扩展名的文件（或所有文件，具体取决于 Action 属性的值）。如果此参数设置为 False，则可以传输任何文件。 默认值：True。 |
Extensions |
可选 |
字符串列表 |
将被阻止的文件扩展名列表。如果尝试用 Lync Server 2010 客户端传输文件扩展名与此列表中某个扩展名匹配的文件，则将阻止该传输，并且将不会传输该文件。如果 Action 设置为 BlockAll（阻止所有文件传输）或者 Enabled 设置为 False（不阻止任何文件传输），则将忽略此列表。 默认情况下，以下文件扩展名包含在 Extensions 属性 Default 中：.ade, .adp, .app, .asp, .bas, .bat, .cer, .chm, .cmd, .com, .cpl, .crt, .csh, .exe, .fxp, .grp, .hlp, .hta, .inf, .ins, .isp, .its, .js, .jse, .ksh, .lnk, .mad, .maf, .mag, .mam, .maq, .mar.、mas., .mat, .mau, .mav, .maw, .mda, .mdb, .mde, .mdt, .mdw, .mdz, .msc, .msi, .msp, .mst, .ocx, .ops, .pcd, .pif, .pl, .pnp, .prf, .prg, .pst, .reg, .scf, .scr, .sct, .shb, .shs, .tmp, .url, .vb, .vbe, .vbs, .vsd, .vsmacros, .vss, .vst, .vsw, .ws, .wsc, .wsf, .wsh |
Force |
可选 |
开关参数 |
在进行更改前取消可能另外显示的任何确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration 对象。接受通过管道传递的文件传输筛选器配置对象的输入。
返回类型
此 cmdlet 不会返回值或对象。此 cmdlet 会配置 Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Set-CsFileTransferFilterConfiguration -Identity site:Redmond -Enabled $False
示例 1 中显示的命令对 Redmond 站点禁用文件传输筛选（即，Identity 为 site:Redmond 的文件传输筛选配置）。为了执行此任务，该命令中包含 Enabled 参数并将其设置为 $False。
-------------------------- 示例 2 --------------------------
Set-CsFileTransferFilterConfiguration -Identity site:Redmond -Extensions @{Add=".ps1"}
上述命令将一个新文件扩展名（.ps1，Windows PowerShell 脚本的文件扩展名）添加到 Redmond 站点中禁止的文件扩展名列表中。为了添加新文件扩展名，Set-CsFileTransferFilterConfiguration 使用 Extensions 参数和 Add 列表修饰符。此修饰符将指定的文件扩展名 (.ps1) 添加到禁止的扩展名列表中。要使用单个命令添加多个扩展名，只需使用逗号将这些文件扩展名隔开：@{Add=".ps1",".ps2",".ps3"}。请注意，在指定文件扩展名时必须包含圆点。
-------------------------- 示例 3 --------------------------
Get-CsFileTransferFilterConfiguration | Set-CsFileTransferFilterConfiguration -Extensions @{Add=".ps1"}
在示例 3 中，.ps1 文件扩展名将添加到组织中当前使用的所有文件传输筛选器配置的 Extensions 列表中。为执行此操作，首先调用不带任何其他参数的 Get-CsFileTransferFilterConfiguration，以返回当前使用的所有文件传输筛选器配置的集合。然后，将该集合通过管道传递到 Set-CsFileTransferFilterConfiguration，后者会将 .ps1 文件扩展名添加到集合中的每一项。
-------------------------- 示例 4 --------------------------
Set-CsFileTransferFilterConfiguration -Identity site:Redmond -Extensions @{Remove=".ps1"}
在上述示例中，将从 Redmond 站点的文件传输筛选器配置阻止的扩展名列表中删除文件扩展名 .ps1。此示例与示例 3 相同，不同之处在于，它不是调用 Add 列表修饰符将扩展名添加到列表中，而是调用 Remove 列表修饰符从该列表中删除扩展名。
-------------------------- 示例 5 --------------------------
$a = Get-CsFileTransferFilterConfiguration -Identity site:Redmond
$a.Extensions.Remove(".ps1")
Set-CsFileTransferFilterConfiguration -Instance $a
示例 5 执行与示例 4 相同的操作：它从 Redmond 站点的文件传输筛选器扩展名列表中删除 .ps1 扩展名。但是，在此示例中，我们会先检索 site:Redmond 的文件传输筛选器配置，并将输出分配给变量 $a。$a 现在包含 Redmond 站点的配置。接下来，我们检索 $a 的 Extensions 属性，它是 site:Redmond 的 Extensions 属性 ($a.Extensions)。此属性包含文件扩展名列表。Extensions 属性后是对 Remove 方法的调用 ($a.Extensions.Remove)。我们将值 .ps1 传递到 Remove 方法；这会从 Extension 属性的列表中删除该扩展名。但是，它只从存储在内存中变量 $a 的配置中删除了该扩展名。要对数据库进行更改，需要调用 Set-CsFileTransferFilterConfiguration，并将 $a 传递到 Instance 参数。