Add-IPBlockListEntry
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2007-07-06
Verwenden Sie das Cmdlet Add-IPBlockListEntry zum Hinzufügen einer IP-Adresse oder eines IP-Adressbereichs zu den IP-Sperrlistenkonfigurationsinformationen für die Verbindungsfilterkonfiguration für den Computer, auf dem der Befehl ausgeführt wird. Sie müssen auf dem Computer über Administratorrechte verfügen, auf dem die Serverfunktion Hub-Transport oder die Serverfunktion Edge-Transport installiert ist.
Syntax
Add-IPBlockListEntry -IPRange <IPRange> [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ExpirationTime <DateTime>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
Add-IPBlockListEntry -IPAddress <IPAddress> [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ExpirationTime <DateTime>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Wenn Sie den Parameter IPAddress beim Ausführen des Cmdlets Add-IPBlockListEntry nicht angeben, fordert Sie die Exchange-Verwaltungsshell zu dessen Eingabe auf. Entweder ist der Parameter IPAddress oder der Parameter IPRange erforderlich.
Hinweis
Wenn Microsoft Exchange Server 2007 Service Pack 1 (SP1) auf einem Computer bereitgestellt wird, der Windows Server 2008 ausführt, können Sie IP-Adressen und IP-Adressbereiche im Internetprotokollformat Version 4 (IPv4), Internetprotokollformat Version 6 (IPv6) oder in beiden Formaten eingeben. In einer Standardinstallation von Windows Server 2008 ist die Unterstützung für IPv4 und IPv6 aktiviert. Weitere Informationen über die Unterstützung von IPv6-Adressen in Exchange 2007 SP1 finden Sie unter IPv6-Unterstützung in Exchange 2007 SP1 und SP2.
Damit Sie das Cmdlet Add-IPBlockListEntry 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 Add-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 |
Sie können eine IP-Adresse angeben, die der IP-Sperrliste hinzugefügt werden soll. Beispiel: |
IPRange |
Erforderlich |
Microsoft.Exchange.Data.IPRange |
Sie können der IP-Sperrliste IP-Adressen in den folgenden Formaten hinzufügen:
|
Comment |
Optional |
System.String |
Verwenden Sie diesen Parameter, um Verwaltungsnotizen oder Erinnerungen zu diesem bestimmten Eintrag zu erfassen. Der Wert des Parameters Comment muss wie folgt in doppelte Anführungszeichen eingeschlossen werden. Beispiel: "Dies ist eine Adminnotiz." |
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. |
ExpirationTime |
Optional |
System.DateTime |
Sie können einen Tag und eine Uhrzeit für den Ablauf des IP-Sperrlisteneintrags angeben, den Sie erstellen. Wenn Sie nur eine Uhrzeit und kein Datum angeben, wird der aktuelle Tag angenommen. Verwenden Sie bei Eingabe eines bestimmten Datums das kurze Datumsformat entsprechend den unter Regionale Einstellungen auf dem lokalen Computer konfigurierten Konventionen. Beispiel: Wenn Ihr Computer zum Verwenden des kurzen Datumsformats MM/TT/JJJJ hh:mm:ss konfiguriert ist, geben Sie zum Festlegen der Ablaufzeit auf den 3. Januar 2007 um 11:00 Uhr die folgenden Informationen, umgeben von doppelten Anführungszeichen, ein: |
Server |
Optional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Zum Angeben eines anderen Hub-Transport-Servers, auf dem das Cmdlet Add-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 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 |
|---|---|
|
Beispiel
Das folgende Codebeispiel zeigt die Verwendung des Cmdlets Add-IPBlockListEntry zum Hinzufügen eines IP-Adressbereichs für die IP-Sperrliste auf dem Computer, auf dem der Befehl ausgeführt wird. Das zweite Beispiel legt den Ablauf des gleichen IP-Sperrlisteneintrags auf den 03.01.07 um 23:59 Uhr fest.
Add-IPBlockListEntry -IPRange:192.168.0.1/24
Add-IPBlockListEntry -IPRange:192.168.0.1/24 -ExpirationTime "1/3/2007 23:59"