Remove-IPBlockListEntry
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2011-01-12
Mit dem Cmdlet Remove-IPBlockListEntry kann eine IP-Adresse aus den Konfigurationsinformationen des Verbindungsfilter-Agents auf dem Computer entfernt werden, auf dem das Cmdlet ausgeführt wird.
Syntax
Remove-IPBlocklistEntry -Identity <IPListEntryIdentity> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Wenn der Parameter Identity beim Ausführen des Cmdlets Remove-IPBlockListEntry nicht angegeben wird, werden Sie von der Exchange-Verwaltungsshell zu dessen Eingabe aufgefordert.
Die Konfiguration des Eintrags für geblockte IP-Adressen wird vom Verbindungsfilter-Agent verwendet.
Damit Sie das Cmdlet Remove-IPBlockListEntry 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 Remove-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 |
|---|---|---|---|
Identity |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.IPListEntryIdentity |
Sie müssen den Parameter Identity der IP-Adresse angeben, die Sie entfernen möchten. Wenn Sie der IP-Sperrliste eine IP-Adresse hinzufügen, erhöht sich der Parameter Identity automatisch. |
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
Der Parameter Confirm bewirkt eine Unterbrechung der Befehlsausführung und zwingt Sie, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für den Parameter Confirm muss kein Wert angegeben werden. |
Server |
Optional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Zum Angeben eines anderen Hub-Transport-Servers, auf dem das Cmdlet Remove-IPBlockListEntry ausgeführt wird, 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. |
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 Parameters WhatIf können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für den Parameter WhatIf muss kein Wert angegeben werden. |
Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
|
Beispiele
Beschreibung
Das folgende Codebeispiel zeigt einen Befehl Remove-IPBlockListEntry, mit dem die IP-Adresse bzw. der IP-Adressbereich der IP-Sperrliste für den Computer entfernt wird, auf dem der Befehl ausgeführt wird.
BEISPIEL 1
Das folgende Beispiel entfernt die IP-Adresse 192.168.0.100 aus der IP-Sperrliste.
Get-IPBlockListEntry | Where {$_.IPRange -eq '192.168.0.100'} | Remove-IPBlockListEntry
BEISPIEL 2
Das folgende Beispiel entfernt den IP-Bereich 192.168.0.0/24 aus der IP-Sperrliste.
Get-IPBlockListEntry | Where {$_.IPRange -eq '192.168.0.0/24'} | Remove-IPBlockListEntry
Hinweis
Sie müssen das Attribut Identity eines IP-Sperrlisteneintrags angeben, wenn Sie den Befehl Remove-PBlockListEntry verwenden. Das Attribut Identity ist ein ganzzahliger Wert, der automatisch zugewiesen wird, wenn der IP-Sperrlisteneintrag zum ersten Mal erstellt wird. Um eine bestimmte IP-Adresse bzw. einen IP-Adressbereich aus der IP-Sperrliste zu entfernen, können Sie die Ausgabe des Befehls Get-IPBlockListEntry verwenden.
Code
Remove-IPBlockListEntry -Identity <Integer>