Test-IPAllowListProvider
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2007-06-28
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> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
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:
- Exchange-Serveradministrator-Rolle und lokale 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. |
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. |
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. |
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
| 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.
|
Matched |
Matched gibt einen der folgenden Werte zurück: True oder False.
|
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