Set-RecipientFilterConfig
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2009-05-18
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>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-ExternalMailEnabled <$true | $false>] [-Instance <RecipientFilterConfig>] [-InternalMailEnabled <$true | $false>] [-RecipientValidationEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]
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 Microsoft 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 |
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 |
ExternalMailEnabled |
Optional |
System.Boolean |
Die gültige Eingabe für den Parameter ExternalMailEnabled lautet |
Instance |
Optional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.RecipientFilterConfig |
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 |
RecipientValidationEnabled |
Optional |
System.Boolean |
Die gültige Eingabe für den Parameter RecipientValidationEnabled Enabled lautet |
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 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 Liste Geblockte Empfänger aktiviert wird und wie der Liste Geblockte Empfänger Empfänger hinzugefügt werden.
Der Parameter BlockedRecipients kann mehrere Werte annehmen. Wenn Sie einen Wert an den Parameter BlockedRecipients übergeben, wird der vorhandene Wert durch den neuen Wert ersetzt. Weitere Informationen zum Hinzufügen oder Entfernen von Werten zu/aus mehrwertigen Eigenschaften finden Sie unter Ändern von mehrwertigen Eigenschaften.
Set-RecipientFilterConfig -RecipientValidationEnabled:$true
Set-RecipientFilterConfig -BlockListEnabled:$true -BlockedRecipients user1@contoso.com,user2@contoso.com