New-CsFileTransferFilterConfiguration
上一次修改主题： 2012-03-26
创建新的文件传输筛选器配置。文件传输筛选器配置用于阻止用户使用 Microsoft Lync Server 2010 客户端传输某些类型的文件（例如，带有 .vbs 或 .ps1 文件扩展名的文件）。
语法
New-CsFileTransferFilterConfiguration -Identity <XdsIdentity> [-Action <BlockAll | Block>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Extensions <PSListModifier>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
发送即时消息时，用户可附加文件并将其发送给会话中的其他参与者。可以将 Lync Server 2010 配置为不允许使用 Lync Server 2010 客户端发送具有特定扩展名（通常为可能有害的文件类型的扩展名）的文件。
安装 Lync Server 2010 时，将为您创建在 global 作用域配置的单个文件传输筛选器配置。默认情况下，这些全局配置适用于组织中的所有用户。此外，还可使用 New-CsFileTransferFilterConfiguration cmdlet 为各个站点创建自定义文件传输筛选器配置。如果给定站点存在配置，则这些文件传输设置将应用于该站点中的所有用户。如果站点不存在此类集合，则将改为应用全局设置。
注意，无法在 global 作用域内创建新的文件传输筛选器配置；但是，可使用 Set-CsFileTransferFilterConfiguration cmdlet 修改全局设置。同样，无法为已定义了一个此类集合的站点创建新配置；如果尝试此操作，则命令将失败。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsFileTransferFilterConfiguration cmdlet：RTCUniversalServerAdministrator。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsFileTransferFilterConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
要指定给文件传输筛选器配置的唯一标识符。新配置的 Identity 就是前缀“site:”后跟站点名称。例如，要为 Redmond 站点创建新配置，应使用以下语法：-Identity site:Redmond。 |
Action |
可选 |
字符串 |
确定启用文件传输筛选时要执行的操作。如果设置为 BlockAll，则将禁止所有文件传输，无论文件扩展名是什么都是如此。如果设置为 Block（默认值），则将允许文件传输，除非文件扩展名是 Extensions 属性中列出的某个被禁止的文件类型。 要使文件传输不受限制（即允许用户交换任何类型的文件，而不考虑文件扩展名），请将此策略的 Enabled 属性设置为 False。 |
Enabled |
可选 |
布尔值 |
启用或禁用文件传输筛选。如果此参数设置为 True，则无法用 Lync Server 2010 客户端传输具有指定扩展名的文件（或所有文件，具体取决于 Action 属性的值）。如果此参数设置为 False，则可传输任何文件。 默认值：True。 |
Extensions |
可选 |
PS 列表修饰符 |
将阻止的文件扩展名的列表。如果尝试用 Lync Server 2010 客户端传输文件扩展名与此列表中某个扩展名匹配的文件，则将阻止该传输，并且将不会传输该文件。如果 Action 设置为 BlockAll（阻止所有文件传输），或者如果 Enabled 设置为 False（不阻止任何文件传输），则忽略此列表。 默认情况下，Extensions 属性中包括以下文件扩展名：.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 |
可选 |
开关参数 |
禁止显示任何本该在进行更改前显示的确认提示。 |
InMemory |
可选 |
开关参数 |
创建对象引用，但并不作为永久性更改实际提交对象。如果将使用此参数调用的 cmdlet 的输出分配给一个变量，您可以更改对象引用的属性，然后通过调用与此 cmdlet 匹配的 Set- cmdlet 提交这些更改。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。
返回类型
New-CsFileTransferFilterConfiguration 创建 Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration 对象的新实例。
示例
-------------------------- 示例 1 --------------------------
New-CsFileTransferFilterConfiguration -Identity site:Redmond
上述命令中使用 New-CsFileTransferFilterConfiguration 创建 Identity 为 site:Redmond 的新即时消息文件传输筛选器配置。由于未指定任何其他参数，因此将用默认值创建配置。
-------------------------- 示例 2 --------------------------
New-CsFileTransferFilterConfiguration -Identity site:Redmond -Extensions @{Add=".ps1"}
此命令中使用 New-CsFileTransferFilterConfiguration 创建 Identity 为 site:Redmond 的新文件传输筛选器配置。由于已指定 Extensions 参数，因此新配置将包含所有默认值和一个额外的文件扩展名：.ps1。用 Extensions 参数以及要添加的文件扩展名后跟随的列表修饰符 Add 添加这个新的扩展名。（注意，必须加入句点作为文件扩展名的一部分。）要添加多个文件扩展名，只需用逗号分隔这些扩展名即可：@{Add=".ps1",".ps2",".ps3"}
-------------------------- 示例 3 --------------------------
New-CsFileTransferFilterConfiguration -Identity site:Redmond -Extensions @{Replace=".vbs",".ps1"}
示例 3 中使用 New-CsFileTransferFilterConfiguration 创建 Identity 为 site:Redmond 的新文件传输筛选器配置。此示例与示例 2 类似，但使用 Replace 列表修饰符代替了 Add 修饰符。这意味着全部文件扩展名将替换为两个指定的文件扩展名：.vbs 和 .ps1。在这种情况下，Redmond 站点中阻止的文件将仅为 .vbs 和 .ps1。
-------------------------- 示例 4 --------------------------
$x = New-CsFileTransferFilterConfiguration -Identity site:Redmond -InMemory
$x.Action = "BlockAll"
Set-CsFileTransferFilterConfiguration -Instance $x
示例 4 介绍 InMemory 参数如何用于创建最初仅位于内存中的文件传输筛选器配置。为执行此操作，示例中的第一个命令使用 New-CsFileTransferFilterConfiguration 和 InMemory 参数创建 Identity 为 site:Redmond 的新文件传输筛选器配置。此时，新设置仅存在于内存中；Redmond 站点中的用户仍将受到全局文件传输筛选器设置的管辖。
第二个命令中将这个仅内存中实例的 Action 属性的值设置为 BlockAll。最后，示例中的第三个命令使用 Set-CsFileTransferFilterConfiguration 创建一组新设置，并将其应用于 Redmond 站点。
请注意，使用以下命令可在一个步骤中完成该相同任务：
New-CsFileTransferFilterConfiguration -Identity site:Redmond –Action "BlockAll"