Add-AttachmentFilterEntry

  • Artikel

 

Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Letztes Änderungsdatum des Themas: 2009-04-28

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> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

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.

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 zu MIME-Inhaltstypen finden Sie in Request for Comments (RFC) 1341 (englischsprachig).

    Hinweis

    UNRESOLVED_TOKEN_VAL(exNote3rdPartyURL)

  • 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.

Type

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.

Confirm

Optional

System.Management.Automation.SwitchParameter

Der Confirm-Parameter bewirkt eine Unterbrechung der Befehlsausführung und zwingt Sie, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für den Confirm-Parameter muss kein Wert angegeben werden.

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.

WhatIf

Optional

System.Management.Automation.SwitchParameter

Der Parameter WhatIf weist den Befehl an, die für das Objekt ausgeführten Aktionen lediglich zu simulieren. Durch Verwendung des WhatIf-Parameters können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für den WhatIf-Parameter muss kein Wert angegeben werden.

Eingabetypen

Rückgabetypen

Fehler

Fehler 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