Applies to: Exchange Server 2007
Topic Last Modified: 2007-06-06
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>]
|
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
|
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.
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.
 Copy Code |
|
|---|---|
Get-AttachmentFilterEntry Get-AttachmentFilterEntry -Identity filename:*.txt Get-AttachmentFilterEntry -Identity contenttype:image/jpeg |
|