Set-IPAllowListConfig

  • Artikel

 

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

Letztes Änderungsdatum des Themas: 2007-06-28

Mit dem Cmdlet Set-IPAllowListConfig kann die Konfiguration der IP-Zulassungsliste auf einem Computer geändert werden, auf dem eine der beiden Serverfunktionen Edge-Transport oder Hub-Transport installiert ist.

Syntax

Set-IPAllowListConfig [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-ExternalMailEnabled <$true | $false>] [-Instance <IPAllowListConfig>] [-InternalMailEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Die IP-Zulassungsliste wird vom Verbindungsfilter-Agent verwendet.

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

  • Exchange-Serveradministrator-Rolle und lokale Gruppe Administratoren für den Zielserver

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

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.

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, ist die Verbindungsfilterung auf dem Computer aktiviert, auf dem der Befehl Set-IPAllowListConfig ausgeführt wird.

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 Verbindungen außerhalb der Exchange-Organisation zur Verarbeitung durch den Verbindungsfilter-Agent geleitet.

Instance

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.IPAllowListConfig

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 von Absendern, die für die Exchange-Organisation intern sind, zur Verarbeitung durch den Verbindungsfilter-Agent geleitet. Authentifizierte Partnernachrichten werden nicht als interne E-Mail-Nachrichten betrachtet.

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

 

Beispiel

Das folgende Codebeispiel zeigt, wie der Befehl Set-IPAllowListConfig zum Festlegen des Domänencontrollers verwendet wird, der die Konfigurationsänderung der Verbindungsfilterungs-Konfigurationsdaten in Active Directory schreibt.

Set-IPAllowListConfig -InternalMailEnabled:$true -DomainController ad-server.example.com