Add-IPAllowListEntry
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-IPAllowListEntry, um eine IP-Adresse oder einen IP-Adressbereich zu den Konfigurationsinformationen der IP-Zulassungsliste für den Verbindungsfilter-Agent auf einem Computer hinzuzufügen, auf dem die Serverfunktion Hub-Transport oder Edge-Transport installiert ist.
Syntax
Add-IPAllowListEntry -IPRange <IPRange> [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ExpirationTime <DateTime>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
Add-IPAllowListEntry -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-IPAllowListEntry nicht angeben, fordert Sie die Exchange-Verwaltungsshell dazu 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-IPAllowListEntry 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 Add-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 |
|---|---|---|---|
IPAddress |
Erforderlich |
System.Net.IPAddress |
Sie können eine einzelne IP-Adresse angeben, die der IP-Zulassungsliste hinzugefügt werden soll (siehe folgendes Beispiel). |
IPRange |
Erforderlich |
Microsoft.Exchange.Data.IPRange |
Sie können der IP-Zulassungsliste IP-Adressbereiche 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 angeben, zu der der zu erstellende Eintrag in der IP-Zulassungsliste abläuft. 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 Einstellungen unter Regionale Einstellungen, die auf dem lokalen Computer konfiguriert sind. Beispiel: Wenn Ihr Computer zum Verwenden des kurzen Datumsformats TT.MM.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-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 |
|---|---|
|
Beispiel
Das erste Codebeispiel zeigt den Befehl Add-IPAllowListEntry, der der IP-Zulassungsliste auf dem Computer, auf dem der Befehl ausgeführt wird, einen IP-Adressbereich hinzufügt. Im zweiten Codebeispiel wird für den gleichen Eintrag in der IP-Zulassungsliste das Ablaufen um 23:59 am 3. Januar 2007 festgelegt.
Add-IPAllowListEntry -IPRange:192.168.0.1/24
Add-IPAllowListEntry -IPRange:192.168.0.1/24 -ExpirationTime "1/3/2007 23:59"