Add-IPAllowListProvider

  • Artikel

 

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

Letztes Änderungsdatum des Themas: 2007-06-22

Mit dem Cmdlet Add-IPAllowListProvider können Sie eine neue Konfiguration eines Anbieters für zugelassene IP-Adressen auf dem Computer erstellen, auf dem die Serverfunktion Edge-Transport oder Hub-Transport installiert ist.

Syntax

Add-IPAllowListProvider -Name <String> -LookupDomain <SmtpDomain> [-AnyMatch <$true | $false>] [-BitmaskMatch <IPAddress>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-IPAddressesMatch <MultiValuedProperty>] [-Priority <Int32>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Die Konfiguration des Anbieters für zugelassene IP-Adressen wird vom Verbindungsfilter-Agent verwendet.

Die Parameter Name und LookupDomain sind erforderlich. Wenn Sie die erforderlichen Parameter nicht übergeben, fordert Sie die Exchange-Verwaltungsshell zu deren Angabe auf.

Damit Sie das Cmdlet Add-IPAllowListProvider 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 Add-IPAllowListProvider 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

LookupDomain

Erforderlich

Microsoft.Exchange.Data.SmtpDomain

Der Domänenname, den der Verbindungsfilter-Agent auf aktualisierte IP-Zulassungslistendaten abfragt.

Name

Erforderlich

System.String

Der Name des Anbieterdiensts für zugelassene IP-Adressen

AnyMatch

Optional

System.Boolean

Die gültige Eingabe für den Parameter AnyMatch lautet $true oder $false. Die Standardeinstellung ist $false. Wenn der Parameter AnyMatch auf $true festgelegt ist, bewertet der Verbindungsfilter-Agent alle vom Anbieterdienst für zugelassene IP-Adressen zurückgegebenen Statuscodes für IP-Adressen als Übereinstimmung.

BitmaskMatch

Optional

System.Net.IPAddress

Wenn Sie den Parameter BitmaskMatch für die Verwendung einer IP-Adresse konfigurieren, agiert der Verbindungsfilter-Agent nur bei Nachrichten, die dem IP-Adressstatuscode entsprechen, der vom Anbieterdienst für zugelassene IP-Adressen zurückgegeben 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 anzugeben, welcher Domänencontroller diese Änderung an den Konfigurationsdaten für die Verbindungsfilterung in den Active Directory-Verzeichnisdienst schreibt, fügen Sie dem Befehl den Parameter DomainController hinzu. Wenn Sie diesen Befehl auf einem Computer ausführen, auf dem die Serverfunktion Edge-Transport installiert ist, wird der Parameter DomainController nicht unterstützt. 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, fragt der Verbindungsfilter-Agent den Anbieterdienst für zugelassene IP-Adressen gemäß der Priorität ab, die für diese Konfiguration des Anbieters für zugelassene IP-Adressen festgelegt ist.

IPAddressesMatch

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Wenn Sie eine IP-Adresse für den Parameter IPAddressesMatch konfigurieren, agiert der Verbindungsfilter-Agent nur bei Nachrichten, die dem IP-Adressstatuscode entsprechen, der vom Anbieterdienst für zugelassene IP-Adressen zurückgegeben wird.

Priority

Optional

System.Int32

Legen Sie den Parameter Priority fest, um die Reihenfolge zu konfigurieren, in welcher der Verbindungsfilter-Agent die Anbieterdienste für zugelassene IP-Adressen abfragt, die Sie konfiguriert haben. Immer wenn Sie einen neuen Anbieter für zugelassene IP-Adressen hinzufügen, wird dem Eintrag standardmäßig die Priorität N+1 zugewiesen. Dabei ist N die Anzahl der Anbieterdienste für zugelassene IP-Adressen, die Sie konfiguriert haben.

Wenn Sie den Parameter Priority auf einen Wert festlegen, der dem eines anderen Anbieters für zugelassene IP-Adressen entspricht, wird der Wert des anderen Anbieters für zugelassene IP-Adressen um 1 erhöht.

TemplateInstance

Optional

System.Management.Automation.PSObject

Wenn ein vorhandenes Objekt an diesen Parameter übergeben wird, verwendet der Befehl die Konfiguration des Objekts zum Erstellen eines exakten Duplikats des Objekts auf einem lokalen oder Zielserver.

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 einen Add-IPAllowListProvider-Befehl, der die erforderlichen Parameter aufweist: LookupDomain und Name.

Add-IPAllowListProvider -Name:Example -LookupDomain:Example.com