Add-AttachmentFilterEntry

 

适用于: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上一次修改主题: 2009-04-28

使用 Add-AttachmentFilterEntry cmdlet 可在安装了边缘传输服务器角色的计算机上向附件筛选器列表添加条目。

语法

add-attachmentfilterentry -Name <String> -Type <ContentType | FileName> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

详细说明

附件筛选器代理可以基于附件的内容类型和文件名阻止附件进入 Microsoft Exchange Server 2007 组织。附件筛选代理的配置确定如何处理附件。

有关如何配置附件筛选代理的详细信息,请参阅 Set-AttachmentFilterListConfig

Add-AttachmentFilterEntry cmdlet 可以根据 MIME 内容类型和文件名筛选电子邮件附件。下表介绍每种附件类型:

  • MIME 内容类型   MIME 内容类型表明附件的内容,例如附件是 JPEG 图像、可执行文件、Microsoft Office Excel 2003 文件还是其他文件类型。电子邮件附件在电子邮件中以 ASCII 文本的形式编码。电子邮件服务器和电子邮件客户端使用 MIME 内容类型的有关信息来解码电子邮件中的 ASCII 文本信息,并将其转换为用户熟悉的可用二进制文件。内容类型以 type/subtype 形式表示。例如,JPEG 图像内容类型表示为 image/jpeg

    有关 MIME 内容类型的详细信息,请参阅 Request for Comments (RFC) 1341(英文网页)。

    note注意:
    UNRESOLVED_TOKEN_VAL(exNote3rdPartyURL)
  • 文件名   可以通过两种方式在附件筛选器列表中指定附件文件名。可以指定准确的文件名,例如 BadFilename.exe。也可以使用通配符替换句点左侧的文件名,指定具有特定类型扩展名的任何文件。*.exe 就是在文件名中使用通配符的示例。

若要在安装了边缘传输服务器角色的计算机上运行 Add-AttachmentFilterEntry cmdlet,必须使用作为该计算机上的本地 Administrators 组成员的帐户进行登录。

有关管理 Exchange 2007 所需的权限、角色委派以及权利的详细信息,请参阅权限注意事项

参数

参数 必需 Type 说明

Name

必需

System.String

此参数指定附件的 MIME 内容类型或文件名。如果 TypeFileName,则 Name 参数可以接受任何准确的文件名,例如 BadFile.Exe,也可以接受文件扩展名,例如 *.exe。如果 TypeContentType,则 Name 参数可以接受任何有效的 MIME 内容类型。

Type

必需

Microsoft.Exchange.Data.Directory.SystemConfiguration.AttachmentType

此参数指定附件筛选器条目阻止的附件类型。有效值为 ContentTypeFilename

  • ContentType   此值将附件筛选器条目与 AttachmentName 参数中指定的 MIME 内容类型进行匹配。

  • FileName   此值将附件筛选器条目与 AttachmentName 参数中指定的简单文件名进行匹配。

Confirm

可选

System.Management.Automation.SwitchParameter

Confirm 参数将导致命令暂停处理,并且需要您在处理继续之前确认该命令将执行的操作。不必为 Confirm 参数指定值。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

若要指定用于将此配置更改写入 Active Directory 目录服务的域控制器的完全限定的域名 (FQDN),请在命令中包含 DomainController 参数。已安装边缘传输服务器角色的计算机不支持 DomainController 参数。边缘传输服务器角色只会写入本地 ADAM 实例。

WhatIf

可选

System.Management.Automation.SwitchParameter

WhatIf 参数指示命令模拟对对象执行的操作。通过使用 WhatIf 参数,可以查看要发生的更改,而不必应用任何这些更改。不必为 WhatIf 参数指定值。

输入类型

返回类型

错误

错误 说明

示例

您可能希望为附件筛选器列表添加条目,以便帮助避免用户收到恶意或不适合的电子邮件附件。以下代码示例显示如何为附件筛选器列表添加条目。

第一个代码示例添加基于文件名的附件筛选器条目。此附件筛选器将应用于扩展名为 .txt 的所有附件。

第二个代码示例添加基于 MIME 内容类型 image/jpeg 的附件筛选器条目,内容类型为 JPEG 图像二进制文件。此附件筛选器将应用于 MIME 内容类型 image/jpeg 的所有附件。

add-attachmentfilterentry -name *.txt -type FileName
add-attachmentfilterentry -name image/jpeg -type ContentType