Add-AttachmentFilterEntry (RTM)

  • Artikel

 

Gilt für: Exchange Server 2007

Letztes Änderungsdatum des Themas: 2007-06-17

Verwenden Sie das Cmdlet Add-AttachmentFilterEntry, um der Anlagenfilterliste auf einem Computer, auf dem die Serverfunktion Edge-Transport installiert ist, einen Eintrag hinzuzufügen.

Syntax

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

Detaillierte Beschreibung

Der Anlagenfilter-Agent kann Anlagen am Eingang in die Microsoft Exchange Server 2007-Organisation basierend auf dem Inhaltstyp und dem Dateinamen der Anlage hindern. Die Konfiguration des Anlagenfilter-Agents legt die Verarbeitung von Anlagen fest.

Weitere Informationen zum Konfigurieren des Anlagenfilter-Agents finden Sie unter Set-AttachmentFilterListConfig (RTM).

Das Cmdlet Add-AttachmentFilterEntry filtert E-Mail-Anlagen auf der Basis von MIME-Inhaltstypen und Dateinamen. In der folgenden Liste sind die einzelnen Anlagentypen beschrieben:

  • MIME-Inhaltstypen   MIME-Inhaltstypen zeigen an, ob eine Anlage z. B. ein JPEG-Bild, eine ausführbare Datei, eine Microsoft Office Excel 2003-Datei oder ein anderer Dateityp ist. E-Mail-Anlagen werden in E-Mail-Nachrichten als ASCII-Text codiert. E-Mail-Server und -Clients verwenden die Informationen über MIME-Inhaltstypen, um die ASCII-Textinformationen in einer E-Mail-Nachricht zu decodieren und sie in eine verwendbare Binärdatei zu konvertieren, die dem Benutzer vertraut ist. Inhaltstypen werden als type/subtype ausgedrückt. Beispielsweise wird der Inhaltstyp für JPEG-Bilder als image/jpeg ausgedrückt.

    Weitere Informationen über MIME-Inhaltstypen finden Sie in RFC 1341 (Request for Comments).

  • Dateinamen   Es bestehen zwei Verfahren zum Angeben von Anlagendateinamen in den Anlagenfilterlisten. Es kann ein exakter Dateiname angegeben werden, wie z. B. BadFilename.exe. Alternativ kann eine beliebige Datei angegeben werden, die einen bestimmten Erweiterungstyp aufweist, indem Sie den Dateinamen links vom Punkt durch ein Platzhalterzeichen ersetzen. Ein Beispiel für die Verwendung eines Platzhalterzeichens in einem Dateinamen ist *.exe.

Um das Cmdlet Add-AttachmentFilterEntry auf einem Computer ausführen zu können, auf dem die Serverfunktion Edge-Transport installiert ist, müssen Sie sich mit einem Konto anmelden, das Mitglied der lokalen Gruppe Administratoren auf diesem Computer ist.

Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Exchange 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.

Parameter

Parameter Erforderlich Typ Beschreibung

Name

Erforderlich

System.String

Dieser Parameter gibt den MIME-Inhaltstyp oder den Dateinamen der Anlage an. Wenn Type FileName ist, kann der Parameter Name einen beliebigen exakten Dateinamen annehmen, wie etwa BadFile.Exe, oder eine Dateinamenerweiterung, wie etwa *.exe. Wenn Type ContentType ist, kann der Parameter Name jeden gültigen MIME-Inhaltstyp annehmen.

Typ

Erforderlich

Microsoft.Exchange.Data.Directory.SystemConfiguration.AttachmentType

Dieser Parameter gibt an, welcher Typ Anlage von diesem Anlagenfiltereintrag geblockt wird. Gültige Werte sind ContentType und Filename.

  • ContentType   Dieser Wert vergleicht den Anlagenfiltereintrag mit dem MIME-Inhaltstyp, der im Parameter AttachmentName angegeben ist.

  • FileName   Dieser Wert vergleicht den Anlagenfiltereintrag mit dem einfachen Dateinamen, der im Parameter AttachmentName angegeben ist.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Um den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers anzugeben, der diese Konfigurationsänderung in den Active Directory-Verzeichnisdienst schreibt, fügen Sie dem Befehl den Parameter DomainController hinzu. Der Parameter DomainController wird nicht auf Computern unterstützt, auf denen die Serverfunktion Edge-Transport installiert ist. Die Serverfunktion Edge-Transport schreibt nur in die lokale ADAM-Instanz.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

Ausnahmen

Ausnahmen Beschreibung

Beispiel

Es kann sinnvoll sein, der Anlagenfilterliste Einträge hinzuzufügen, um die Benutzer vor bösartigen oder unangemessenen E-Mail-Anlagen zu schützen. Die folgenden Codebeispiele zeigen, wie der Anlagenfilterliste ein Eintrag hinzugefügt wird.

Im ersten Codebeispiel wird ein auf einem Dateinamen basierender Anlagenfiltereintrag hinzugefügt. Dieser Anlagenfilter wird auf alle Anlagen mit der Erweiterung TXT angewendet.

Im zweiten Codebeispiel wird der Anlagenfilterliste ein auf dem MIME-Inhaltstyp image/jpeg basierender Eintrag hinzugefügt, der eine JPEG-Bildbinärdatei angibt. Dieser Anlagenfilter wird auf alle Anlagen mit dem MIME-Inhaltstyp image/jpeg angewendet.

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