Set-RecipientFilterConfig (RTM)

 

Gilt für: Exchange Server 2007

Letztes Änderungsdatum des Themas: 2007-08-27

Verwenden Sie das Ccmdlet Set-RecipientFilterConfig zum Aktivieren und Konfigurieren des Empfängerfilter-Agents auf einem Computer, auf dem die Serverfunktion Edge-Transport oder Hub-Transport installiert ist.

Syntax

Set-RecipientFilterConfig [-BlockedRecipients <MultiValuedProperty>] [-BlockListEnabled <$true | $false>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-ExternalMailEnabled <$true | $false>] [-Instance <RecipientFilterConfig>] [-InternalMailEnabled <$true | $false>] [-RecipientValidationEnabled <$true | $false>]

Detaillierte Beschreibung

Damit Sie das Cmdlet Set-RecipientFilterConfig 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

Zum Ausführen des Cmdlets Set-RecipientFilterConfig auf einem Computer, 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 Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.

Parameter

Parameter	Erforderlich	Typ	Beschreibung
BlockedRecipients	Optional	Microsoft.Exchange.Data.MultiValuedProperty	Eine gültige Eingabe für den Parameter BlockedRecipients Enabled besteht in mindestens einer SMTP-Adresse. Es können bis zu 800 einzelne SMTP-Adressen für den Parameter BlockedRecipients eingegeben werden.
BlockListEnabled	Optional	System.Boolean	Die gültige Eingabe für den Parameter BlockListEnabled Enabled lautet $true oder $false. Die Standardeinstellung ist $false. Wenn der Parameter BlockListEnabled auf $true festgelegt ist, blockt der Empfängerfilter-Agent Nachrichten, die an Empfänger gesendet werden, die im BlockedRecipients-Parameter aufgelistet sind.
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 ist, wird der Empfängerfilter-Agent auf dem Computer aktiviert, auf dem Sie das Cmdlet Set-RecipientFilterConfig 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 Empfängerfilter-Agent geleitet.
Instance	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.RecipientFilterConfig	Der Parameter Instance ermöglicht das Übergeben eines vollständigen Objekts an den zu verarbeitenden Befehl. Er wird hauptsächlich in Skripts verwendet, in denen ein vollständiges 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 Empfängerfilter-Agent geleitet.
RecipientValidationEnabled	Optional	System.Boolean	Die gültige Eingabe für den Parameter RecipientValidationEnabled Enabled lautet $true oder $false. Die Standardeinstellung ist $false. Wenn der RecipientValidationEnabled-Parameter auf $true festgelegt ist, blockt der Empfängerfilter-Agent Nachrichten, die Empfänger enthalten, die nicht in der Organisation enthalten sind.

Eingabetypen

Rückgabetypen

Fehler

Fehler	Beschreibung

Beispiel

Das folgende Beispiel veranschaulicht zwei Set-RecipientFilterConfig-Befehle.

Im ersten Codebeispiel wird gezeigt, wie die Empfängerfilterkonfiguration so geändert wird, dass die Empfängerüberprüfung aktiviert ist.

Das zweite Codebeispiel zeigt, wie die IP-Sperrliste aktiviert wird und wie der IP-Sperrliste Empfänger hinzugefügt werden.

Die Eigenschaft BlockedRecipients kann mehrere Werte annehmen. Wenn Sie einen neuen Wert an die Eigenschaft BlockedRecipients übergeben, wird der vorhandene Wert von dem neuen Wert überschrieben. Informationen über die Vorgehensweise zum Anfügen von Werten an eine vorhandene mehrwertige Eigenschaft finden Sie unter Ändern von mehrwertigen Eigenschaften.

Set-RecipientFilterConfig -RecipientValidationEnabled:$true
Set-RecipientFilterConfig -BlockListEnabled:$true -BlockedRecipients user1@contoso.com,user2@contoso.com