Remove-IPAllowListEntry
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-IPAllowListEntry kann eine IP-Adresse aus den Konfigurationsinformationen des Verbindungsfilter-Agents auf dem Computer entfernt werden, auf dem der Befehl ausgeführt wird.
Syntax
Remove-IPAllowListEntry -Identity <IPListEntryIdentity> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Wenn der Parameter Identity beim Ausführen des Befehls Remove-IPAllowListEntry nicht angegeben wird, werden Sie von der Exchange-Verwaltungsshell zu dessen Eingabe aufgefordert.
Die Konfiguration des Eintrags für zugelassene IP-Adressen wird vom Verbindungsfilter-Agent verwendet.
Damit Sie das Cmdlet Remove-IPAllowListEntry 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 Remove-IPAllowListEntry 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-Zulassungsliste eine IP-Adresse hinzufügen, erhöht sich der Parameter Identity automatisch. |
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. |
Server |
Optional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Zum Angeben eines anderen Hub-Transport-Servers, auf dem das Cmdlet Remove-IPAllowListEntry 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 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
Fehler
| Fehler | Beschreibung |
|---|---|
|
Beispiele
Beschreibung
Das folgende Codebeispiele zeigen einen Befehl Remove-IPAllowListEntry, mit dem die IP-Adresse bzw. der IP-Adressbereich der IP-Zulassungsliste 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-Zulassungsliste.
Get-IPAllowListEntry | Where {$_.IPRange -eq '192.168.0.100'} | Remove-IPAllowListEntry
BEISPIEL 2
Das folgende Beispiel entfernt den IP-Bereich 192.168.0.0/24 aus der IP-Zulassungsliste.
Get-IPAllowListEntry | Where {$_.IPRange -eq '192.168.0.0/24'} | Remove-IPAllowListEntry
Hinweis
Sie müssen das Attribut Identity eines IP-Zulassungslisteneintrags angeben, wenn Sie den Befehl Remove-IPAllowListEntry verwenden. Das Attribut Identity ist ein ganzzahliger Wert, der automatisch zugewiesen wird, wenn der IP-Zulassungslisteneintrag zum ersten Mal erstellt wird. Um eine bestimmte IP-Adresse bzw. einen IP-Adressbereich aus der IP-Zulassungsliste zu entfernen, können Sie die Ausgabe des Befehls Get-IPAllowListEntry verwenden.
Code
Remove-IPAllowListEntry -Identity <Integer>