Get-IPBlockListEntry

 

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 Get-IPBlockListEntry können Sie Informationen zur IP-Adresskonfiguration des Verbindungsfilter-Agents für den Computer abrufen, auf dem der Befehl ausgeführt wird.

Syntax

Get-IPBlockListEntry [-Identity <IPListEntryIdentity>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>]

Get-IPBlockListEntry -IPAddress <IPAddress> [-ResultSize <Unlimited>] [-Server <ServerIdParameter>]

Detaillierte Beschreibung

Die IP-Sperrliste wird vom Verbindungsfilter-Agent verwendet.

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

  • die Rolle Exchange-Administratoren mit Leserechten

Um das Cmdlet Get-IPBlockListEntry 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

IPAddress

Erforderlich

System.Net.IPAddress

Wenn Sie IP-Sperrlisteneinträge mit einer bestimmten IP-Adresse anzeigen möchten, können Sie mit dem Befehl IPAddress eine IP-Adresse angeben. Beispiel: Wenn es einen IP-Sperrlisteneintrag gibt, der einen IP-Adressbereich von 192.168.0.1 bis 192.168.0.20 angibt, geben Sie eine beliebige IP-Adresse im IP-Adressbereich der IP-Sperrliste ein, um den IP-Sperrlisteneintrag zurückzugeben.

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.IPListEntryIdentity

Wenn Sie einen bestimmten IP-Sperrlisteneintrag anzeigen möchten, können Sie mit dem Befehl Identity die Konfigurationsnummer angeben. Wenn Sie der IP-Sperrliste eine IP-Adresse hinzufügen, erhöht sich der Parameter Identity automatisch.

ResultSize

Optional

Microsoft.Exchange.Data.Unlimited

Der ResultSize-Parameter gibt die maximale Anzahl zurückzugebender Ergebnisse an. Zum Zurückgeben aller Einträge verwenden Sie unlimited als Wert für diesen Parameter. Der Standardwert ist 1000.

Server

Optional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Zum Angeben eines anderen Hub-Transport-Servers, auf dem das Cmdlet Get-IPBlockListEntry ausgeführt werden soll, müssen Sie dem Befehl den Parameter Server hinzufügen. Wenn Sie den Server-Parameter nicht verwenden, wird der Befehl auf dem lokalen Server ausgeführt, auf dem der Befehl ausgeführt wird.

Dieses Cmdlet kann nicht zur Remotekonfiguration anderer Edge-Transport-Server verwendet werden.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

 

Beispiel

Das erste Codebeispiel zeigt einen Get-IPBlockListEntry-Befehl, der computergenerierte Einträge zurückgibt, die nach Absenderzuverlässigkeit eingefügt werden.

Das zweite Codebeispiel zeigt einen Get-IPBlockListEntry-Befehl, der computergenerierte Einträge löscht, die vor 14 Tagen abgelaufen sind.

Get-IPBlockListEntry | where { $_.IsMachineGenerated }
Get-IPBlockListEntry | where { $_.IsMachineGenerated -and $_.ExpirationTime -lt (date).AddDays(-14) } | Remove-IPBlockListEntry