Set-SenderFilterConfig

 

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-SenderFilterConfig zum Ändern der Absenderfilterkonfiguration auf einem Computer, auf dem die Serverfunktion Hub-Transport oder Edge-Transport installiert ist.

Syntax

Set-SenderFilterConfig [-Action <StampStatus | Reject>] [-BlankSenderBlockingEnabled <$true | $false>] [-BlockedDomains <MultiValuedProperty>] [-BlockedDomainsAndSubdomains <MultiValuedProperty>] [-BlockedSenders <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-ExternalMailEnabled <$true | $false>] [-Instance <SenderFilterConfig>] [-InternalMailEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Damit Sie das Cmdlet Set-SenderFilterConfig ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:

  • die Rolle Exchange-Serveradministrator und die Mitgliedschaft in der lokalen Gruppe Administratoren für den Zielserver

Um das Cmdlet Set-SenderFilterConfig 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 Microsoft Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.

Parameter

Parameter Erforderlich Typ Beschreibung

Action

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.BlockedSenderAction

Dieser Parameter gibt die Aktion an, die der Absenderfilter-Agent für die Nachricht ausführt, wenn ein geblockter Absender oder eine geblockte Domäne gefunden wird. Der Parameter Action nimmt die folgenden Werte an: StampStatus oder Reject. Der Standardwert ist Reject.

BlankSenderBlockingEnabled

Optional

System.Boolean

Die gültige Eingabe für den Parameter BlankSenderBlockingEnabled lautet $true oder $false. Die Standardeinstellung ist $false. Wenn der Parameter BlankSenderBlockingEnabled auf $true festgelegt wird, werden alle Nachrichten geblockt, die keinen Absender in der Anweisung SMTP MAIL FROM: enthalten.

BlockedDomains

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Die gültige Eingabe für den Parameter BlockedDomains ist mindestens ein Domänenname. Wenn der Absenderfilter-Agent eine Nachricht erkennt, die von einer Domäne auf dieser Liste gesendet wurde, führt er die Aktion aus, die im Parameter Action angegeben wurde. Platzhalterzeichen wie "*" sind zulässig. Die Höchstanzahl von Einträgen für diesen Parameter ist 800.

BlockedDomainsAndSubdomains

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Die gültige Eingabe für den Parameter BlockedDomainsAndSubdomains ist mindestens ein Domänenname. Wenn der Absenderfilter-Agent eine Nachricht erkennt, die von einer Domäne oder Unterdomäne auf dieser Liste gesendet wurde, führt er die Aktion aus, die im Parameter Action angegeben wurde. Platzhalterzeichen wie "*" sind zulässig. Die Höchstanzahl von Einträgen für diesen Parameter ist 800.

BlockedSenders

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Die gültige Eingabe für den Parameter BlockedSenders ist mindestens eine SMTP-Adresse. Wenn der Absenderfilter-Agent eine Nachricht erkennt, die von einem Absender auf dieser Liste gesendet wurde, führt er die Aktion aus, die im Parameter Action angegeben wurde. Die Höchstanzahl von Einträgen für diesen Parameter ist 800.

Confirm

Optional

System.Management.Automation.SwitchParameter

Der Parameter Confirm bewirkt eine Unterbrechung der Befehlsausführung und zwingt Sie, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für den Parameter Confirm 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.

Enabled

Optional

System.Boolean

Die gültige Eingabe für den Parameter Enabled lautet $true oder $false. Die Standardeinstellung ist $true. Wenn der Parameter Enabled auf $true festgelegt wird, wird der Absenderfilter-Agent auf dem Computer aktiviert, auf dem Sie den Befehl Set-SenderFilterConfig ausführen.

ExternalMailEnabled

Optional

System.Boolean

Die gültige Eingabe für den Parameter ExternalMailEnabled lautet $true oder $false. Die Standardeinstellung ist $true. Wenn der Parameter ExternalMailEnabled auf $true festgelegt ist, werden sämtliche Nachrichten aus nicht authentifizierten Verbindungen zur Verarbeitung durch den Absenderfilter-Agent geleitet.

Instance

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.SenderFilterConfig

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.

InternalMailEnabled

Optional

System.Boolean

Die gültige Eingabe für den Parameter InternalMailEnabled lautet $true oder $false. Die Standardeinstellung ist $false. Wenn der Parameter InternalMailEnabled auf $true festgelegt ist, werden sämtliche Nachrichten aus authentifizierten Absenderdomänen, die zu autorisierenden Domänen in Ihrem Unternehmen gehören, zur Verarbeitung durch den Absenderfilter-Agent geleitet.

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 Parameters WhatIf können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für den Parameter WhatIf muss kein Wert angegeben werden.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

 

Beispiel

Das folgende Codebeispiel zeigt einen Set-SenderFilterConfig-Befehl, der die folgenden Änderungen der Absenderfilterkonfiguration aufweist:

  • Er ermöglicht das Blocken leerer Absender.

  • Er blockiert die Domäne und Unterdomäne von example.com.

  • Er definiert zwei geblockte Absender.

Set-SenderFilterConfig -BlankSenderBlockingEnabled:$true -BlockedDomainsAndSubdomains *example.com -BlockedSenders user1@contoso.com, user2@contoso.com