Set-AttachmentFilterListConfig

  • Artikel

 

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

Letztes Änderungsdatum des Themas: 2007-06-28

Verwenden Sie das Cmdlet Set-AttachmentFilterListConfig zum Ändern der Konfiguration des Anlagenfilter-Agents auf einem Computer, auf dem Microsoft Exchange Server 2007 mit installierter Serverfunktion Edge-Transport ausgeführt wird.

Syntax

set-attachmentfilterlistconfig [-Action <Reject | Strip | SilentDelete>] [-AdminMessage <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExceptionConnectors <MultiValuedProperty>] [-Instance <AttachmentFilteringConfig>] [-RejectResponse <String>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Der Anlagenfilter-Agent kann Anlagen am Eingang in die Exchange 2007-Organisation basierend auf dem Inhaltstyp und dem Dateinamen der Anlage hindern. Sie können das Cmdlet Set-AttachmentFilterListConfig zum Ändern der Konfigurationsinformationen für den Anlagenfilter-Agent und zum Verwalten der Verarbeitung von Anlagen verwenden. Die gleichen Konfigurationsoptionen werden auf alle Einträge in einer Anlagenfilterliste angewendet, die auf dem lokalen Computer konfiguriert ist, auf dem die Edge-Transport-Serverfunktion installiert ist. Jeder Computer, auf dem die Edge-Transport-Serverfunktion installiert ist, muss separat konfiguriert werden.

Um das Cmdlet Set-AttachmentFilterListConfig 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

Action

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.FilterActions

In diesem Parameter wird angegeben, wie der Anlagenfilter-Agent eine Anlage behandelt, die mit einem Eintrag auf der Anlagenfilterliste übereinstimmt. Der Standardwert ist Block. Zu den gültigen Werten gehören die folgenden:

  • Reject   Dieser Wert verhindert die Zustellung sowohl der E-Mail-Nachricht als auch der Anlage an den Empfänger und gibt einen Unzustellbarkeitsbericht (Non-Delivery Report, NDR) an den Absender aus.

  • Strip   Dieser Wert entfernt die verletzende Anlage von der E-Mail-Nachricht und lässt die Nachricht sowie andere Anlagen, die nicht mit einem Eintrag auf der Anlagenfilterliste übereinstimmen, durch. Der E-Mail-Nachricht wird eine Benachrichtigung hinzugefügt, dass die Anlage entfernt wurde.

  • SilentDelete   Dieser Wert verhindert die Zustellung sowohl der E-Mail-Nachricht als auch der Anlage an den Empfänger. Es wird keine Benachrichtigung an den Absender gesendet, dass die E-Mail-Nachricht und die Anlage gesperrt wurden.

AdminMessage

Optional

System.String

Dieser Parameter legt den Inhalt einer Textdatei fest, die Anlagen ersetzt, die vom Anlagenfilter-Agent entfernt wurden. Der Parameter AdminMessage wird nur angezeigt, wenn der Anlagenfilter-Agent so konfiguriert ist, dass eine als unzulässig erkannte Anlage entfernt wird.

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.

ExceptionConnectors

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Dieser Parameter gibt eine Liste von Connectors an, die von der Anlagenfilterung ausgenommen werden sollen. Anlagenfilter werden nicht auf E-Mail-Nachrichten angewendet, die über diese Connectors empfangen werden. Sie müssen die Connector-GUID verwenden, um den ExceptionConnectors-Wert anzugeben.

Instance

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.AttachmentFilteringConfig

Der Parameter Instance ermöglicht das Übergeben eines gesamten Objekts an den zu verarbeitenden Befehl. Er wird hauptsächlich in Skripts verwendet, in denen ein gesamtes Objekt an den Befehl übergeben werden muss.

RejectResponse

Optional

System.String

Dieser Parameter ist nur erforderlich, wenn Sie den Action-Parameter auf Reject festlegen. Der Parameter RejectResponse akzeptiert eine Zeichenfolge. Geben Sie den Nachrichtentext ein, der in dem Unzustellbarkeitsbericht (NDR) an Absender übermittelt werden soll, deren Nachrichten eine Anlage enthalten, die geblockt wird. Dieses Argument darf nicht mehr als 240 Zeichen aufweisen. Wenn Sie ein Argument übergeben, müssen Sie den Parameter RejectResponse in doppelte Anführungszeichen setzen, falls der Ausdruck Leerzeichen wie im folgenden Beispiel enthält: "Message rejected". Die Standardeinstellung ist Message rejected due to unacceptable attachments.

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

Ausnahmen

Ausnahmen Beschreibung

Beispiel

Standardmäßig ist der Anlagenfilter-Agent für das Blocken von Anlagen und der zugeordneten Nachrichten konfiguriert, die mit einem Eintrag in der Anlagenfilterliste übereinstimmen. Im folgenden Codebeispiel wird die Aktion geändert, die der Anlagenfilter-Agent für eine Anlage ausführt, die mit einem Eintrag in der Anlagenfilterliste übereinstimmt, so dass sowohl die E-Mail-Nachricht als auch die Anlage nicht an den Empfänger zugestellt werden und ein Unzustellbarkeitsbericht an den Absender gesendet wird. Das Codebeispiel gibt darüber hinaus einen Connector an, der den Anlagenfilter-Agent nicht ausführt.

Set-AttachmentFilterListConfig -Action Reject -ExceptionConnectors fc4d8ce2-2c0d-4116-b036-143b19a81384