Share via


Get-AttachmentFilterEntry (RTM)

Microsoft Exchange Server 2007 will reach end of support on April 11, 2017. To stay supported, you will need to upgrade. For more information, see Resources to help you upgrade your Office 2007 servers and clients.

 

Applies to: Exchange Server 2007

The Get-AttachmentFilterEntry cmdlet enables an e-mail administrator to view the list of attachment filter entries that are configured on a computer that has the Edge Transport server role installed.

Syntax

get-attachmentfilterentry [-Identity <String>] [-DomainController <Fqdn>]

Detailed Description

The Attachment Filter agent can block attachments from entering the Microsoft Exchange Server 2007 organization based on the content type and the file name of the attachment. The configuration of the Attachment Filtering agent determines how attachments are processed.

To run the Get-AttachmentFilterEntry cmdlet on a computer that has the Edge Transport server role installed, you must log on by using an account that is a member of the local Administrators group on that computer.

For more information about permissions, delegating roles, and the rights that are required to administer Exchange 2007, see Permission Considerations.

Parameters

Parameter Required Type Description

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

To specify the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to Active Directory directory service, include the DomainController parameter on the command. The DomainController parameter is not supported on computers that have the Edge Transport server role installed. The Edge Transport server role writes only to the local ADAM instance.

Identity

Optional

System.String

This parameter specifies which attachment filter entry the command retrieves. The Identity parameter accepts values in the format Type:Name, where Type is one of the following two values:

  • ContentType   This value will match the attachment filter entry against the MIME content type.

  • FileName   This value will match the attachment filter entry against the simple file name.

Input Types

Return Types

Errors

Error Description

Exceptions

Exceptions Description

Example

The following code examples show how to retrieve information about attachment filter entries.

The first code example returns all attachment filter entries.

The second code example returns only the attachment filter entries that filter file names with a .txt extension.

The third code example returns only the attachment filter entries that filter attachments that have the MIME content type image/jpeg.

Get-AttachmentFilterEntry
Get-AttachmentFilterEntry -Identity filename:*.txt
Get-AttachmentFilterEntry -Identity contenttype:image/jpeg