Test-IPBlockListProvider
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 Test-IPBlockListProvider können Sie die Informationen einer bestimmten Konfiguration eines Anbieters für geblockte IP-Adressen auf einem Computer testen, auf dem die Serverfunktion Edge-Transport oder Hub-Transport installiert ist. Diese Konfiguration wird vom Verbindungsfilter-Agent verwendet.
Syntax
Test-IPBlockListProvider -Identity <IPBlockListProviderIdParameter> -IPAddress <IPAddress> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Das Cmdlet Test-IPBlockListProvider überprüft die Konnektivität mit dem angegebenen Anbieter für geblockte IP-Adressen und übermittelt eine Lookupanforderung an den Anbieter für zugelassene IP-Adressen. Zum Überprüfen der Verbindung und Funktionalität des Anbieters für geblockte IP-Adressen müssen Sie in den Parameter IPAddress eine bekannte geblockte IP-Adresse eingeben.
Damit Sie das Cmdlet Test-IPBlockListProvider 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-IPBlockListProvider 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 |
|---|---|---|---|
Identity |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.IPBlockListProviderIdParameter |
Geben Sie den Namen des Anbieters für geblockte IP-Adressen in diesen Parameter ein. Der Parameter Identity muss entweder dem Parameter Name oder dem Parameter Identity (GUID) des Anbieters für geblockte IP-Adressen entsprechen, den Sie testen möchten. |
IPAddress |
Erforderlich |
System.Net.IPAddress |
Der Parameter IPAddress dient dem Überprüfen und Testen der Anbieter für geblockte IP-Adressen, die Sie konfiguriert haben. |
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 Sie das Cmdlet Test-IPBlockListProvider ausführen, fügen Sie dem Befehl den 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 |
|---|---|
Block List Provider |
Block List Provider gibt das Anbieterobjekt für geblockte IP-Adressen so zurück, wie es im lokalen ADAM-Verzeichnis oder in Active Directory 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 gemäß dem Anbieter für geblockte IP-Adressen des Parameters IPAddress wiedergibt, der im Befehl Test-IPBlockListProvider übermittelt wird. Kontaktieren Sie Ihren Anbieter für geblockte IP-Adressen, um die Bedeutung der IP-Adresse zu bestimmen, die hier zurückgegeben wird. |
Fehler
| Fehler | Beschreibung |
|---|---|
Unzureichende Berechtigungen |
Um diesen Befehl ausführen zu können, müssen Sie Administrator auf dem lokalen Computer sein, auf dem die Serverfunktion Edge-Transport installiert ist. |
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 geblockte IP-Adressen nicht möglich |
Kontaktieren Sie Ihren Anbieter für geblockte IP-Adressen. |
Beispiel
Das folgende Codebeispiel zeigt einen Test-IPBlockListProvider-Befehl, der die erforderlichen Parameter aufweist. Der Befehl überprüft die Konnektivität mit einem fiktiven Anbieter für geblockte IP-Adressen mit dem Namen ExampleProviderName und übermittelt anschließend eine Lookupanforderung an diesen Anbieter.
Test-IPBlockListProvider -IPAddress 192.168.0.1 -Provider ExampleProviderName