Test-IPAllowListProvider (RTM)

  • Artikel

 

Gilt für: Exchange Server 2007

Letztes Änderungsdatum des Themas: 2007-06-06

Verwenden Sie das Cmdlet Test-IPAllowListProvider, um eine bestimmte Anbieterkonfiguration für zugelassene IP-Adressen auf einem Computer anzuzeigen, auf dem die Serverfunktion Hub-Transport oder Edge-Transport installiert ist. Diese Konfiguration wird vom Verbindungsfilter-Agent verwendet.

Syntax

Test-IPAllowListProvider -Identity <IPAllowListProviderIdParameter> -IPAddress <IPAddress> [-DomainController <Fqdn>] [-Server <ServerIdParameter>]

Detaillierte Beschreibung

Dieser Befehl überprüft die Konnektivität mit dem angegebenen Anbieter für zugelassene IP-Adressen und gibt dann eine Lookupanforderung für den Anbieter für zugelassene IP-Adressen aus. Beim Prüfen von Verbindung und Funktion des Anbieters für zugelassene IP-Adressen müssen Sie eine bekannte zugelassene IP-Adresse im IPAddress-Parameter eingeben.

Damit Sie das Cmdlet Test-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 Test-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 dem betreffenden 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

Identity

Erforderlich

Microsoft.Exchange.Configuration.Tasks.IPAllowListProviderIdParameter

Geben Sie den Namen des Anbieters für zugelassene IP-Adressen in diesem Parameter ein. Der Identity-Parameter muss entweder mit dem Name-Parameter oder mit dem Identity-(GUID)-Parameter des Anbieters für zugelassene IP-Adressen übereinstimmen, den Sie prüfen möchten.

IPAddress

Erforderlich

System.Net.IPAddress

Der IPAddress-Parameter wird verwendet, um die konfigurierten Anbieter für zugelassene IP-Adressen zu überprüfen und zu testen.

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.

Server

Optional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Um den Server anzugeben, auf dem das Cmdlet Test-IPAllowListProvider ausgeführt wird, fügen Sie dem Befehl der Parameter Server hinzu. Wenn Sie den Parameter Server nicht verwenden, wird der Befehl auf dem lokalen Server ausgeführt, auf dem die Aufgabe durchgeführt wird.

Eingabetypen

Rückgabetypen

Ausgabe Beschreibung

Anbieter für zugelassene IP-Adressen

Allow List Provider gibt das Anbieterobjekt für zugelassene IP-Adressen zurück, wie es im lokalen ADAM-Verzeichnis oder im Active Directory-Verzeichnisdienst gespeichert ist.

Connected

Connected gibt einen der folgenden Werte zurück: True oder False.

  • True   Der Test der Konnektivität hat Erfolg.

  • False   Der Test der Konnektivität schlägt fehl.

Matched

Matched gibt einen der folgenden Werte zurück: True oder False.

  • True   Der IPAddress-Parameter, der mit dem Test-IPAllowListProvider-Befehl übermittelt wird, stimmt mit einer IP-Adresse beim Anbieter für zugelassene IP-Adressen überein.

  • False   Der IPAddress-Parameter, der mit dem Test-IPAllowListProvider-Befehl übermittelt wird, stimmt nicht mit einer IP-Adresse beim Anbieter für zugelassene IP-Adressen überein.

ProviderResult

ProviderResult gibt eine IP-Adresse zurück, die den Status des IPAddress-Parameters gemäß dem Anbieter für zugelassene IP-Adressen angibt, der im Test-IPAllowListProvider-Befehl übermittelt wird. Wenden Sie sich an den Anbieter für zugelassene IP-Adressen, um die Bedeutung der hier zurückgegebenen IP-Adresse zu bestimmen.

Fehler

Fehler Beschreibung

Unzureichende Berechtigungen

Sie müssen sich mit einem Konto anmelden, das Mitglied der lokalen Gruppe Administratoren auf dem lokalen Computer ist, auf dem die Edge-Transport-Serverfunktion installiert ist, um diesen Befehl auszuführen.

Verbindung mit ADAM nicht möglich

Wenn Sie diesen Befehl auf einem Computer ausführen, auf dem die Serverfunktion Edge-Transport installiert ist, stellen Sie sicher, dass der ADAM-Dienst (MsExchangeAdam) auf dem lokalen Computer ausgeführt wird. Wenn Sie diesen Befehl auf einem Computer ausführen, auf dem die Serverfunktion Hub-Transport installiert ist, stellen Sie sicher, dass der Computer sich mit Active Directory verbinden kann.

Verbindung mit dem Anbieter für zugelassene IP-Adressen nicht möglich

Kontaktieren Sie Ihren Anbieter für zugelassene IP-Adressen.

Beispiel

Das folgende Codebeispiel veranschaulicht einen Test-IPAllowListProvider-Befehl mit den erforderlichen Parametern. Der Befehl prüft die Konnektivität mit einem fiktiven Anbieter für zugelassene IP-Adressen mit dem Namen ExampleProviderName und gibt dann eine Lookupanforderung für den betreffenden Anbieter aus.

Test-IPAllowListProvider -IPAddress 192.168.0.1 -Provider ExampleProviderName