Set-AttachmentFilterListConfig

Artikel
09/29/2014

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

Freigeben über