Set-IPBlockListProvider

Artikel
09/29/2014

Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Letztes Änderungsdatum des Themas: 2007-06-28

Verwenden Sie das Cmdlet Set-IPBlockListProvider zum Ändern der Konfigurationsinformationen eines Anbieters für geblockte IP-Adressen auf einem Computer, auf dem die Serverfunktion Edge-Transport oder Hub-Transport installiert ist.

Syntax

Set-IPBlockListProvider -Identity <IPBlockListProviderIdParameter> [-AnyMatch <$true | $false>] [-BitmaskMatch <IPAddress>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-IPAddressesMatch <MultiValuedProperty>] [-LookupDomain <SmtpDomain>] [-Name <String>] [-Priority <Int32>] [-RejectionResponse <AsciiString>] [-WhatIf [<SwitchParameter>]]

Set-IPBlockListProvider [-AnyMatch <$true | $false>] [-BitmaskMatch <IPAddress>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-Instance <IPBlockListProvider>] [-IPAddressesMatch <MultiValuedProperty>] [-LookupDomain <SmtpDomain>] [-Name <String>] [-Priority <Int32>] [-RejectionResponse <AsciiString>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Mit dem Cmdlet Set-IPBlockListProvider können Sie vorhandene Konfigurationen von Anbietern für geblockte IP-Adressen ändern. Diese Konfiguration wird vom Verbindungsfilter-Agent verwendet. Der Parameter Identity ist erforderlich.

Damit Sie das Cmdlet Set-IP 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 Set-IPBlockListProvider 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.IPBlockListProviderIdParameter	Der Parameter Identity kann einen Zeichenfolgenwert, der dem Wert von Name entspricht, oder die GUID verwenden.
AnyMatch	Optional	System.Boolean	Die gültige Eingabe für den Parameter Enabled lautet `$true` oder `$false`. Die Standardeinstellung ist `$false`. Wenn der Parameter AnyMatch auf `$true` festgelegt ist, bewertet der Verbindungsfilter-Agent alle vom Anbieterdienst für geblockte IP-Adressen zurückgegebenen Statuscodes für IP-Adressen als Übereinstimmung.
BitmaskMatch	Optional	System.Net.IPAddress	Wenn Sie eine IP-Adresse für den Parameter BitmaskMatch konfigurieren, agiert der Verbindungsfilter-Agent nur bei Nachrichten, die dem IP-Adressstatuscode entsprechen, der vom Anbieterdienst für geblockte IP-Adressen zurückgegeben wird.
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.
DomainController	Optional	Microsoft.Exchange.Data.Fqdn	Um den vollqualifizierten Domänennamen des Domänencontrollers anzugeben, der diese Konfigurationsänderung in den Active Directory-Verzeichnisdienst schreibt, fügen Sie dem Befehl den Parameter DomainController hinzu. Der Parameter DomainController wird nicht auf Computern unterstützt, auf denen die Serverfunktion Edge-Transport ausgeführt wird. Die Serverfunktion Edge-Transport schreibt nur in die lokale ADAM-Instanz.
Enabled	Optional	System.Boolean	Die gültige Eingabe für den Parameter Enabled lautet `$true` oder `$false`. Die Standardeinstellung ist `$true`. Wenn der Parameter Enabled auf `$true` festgelegt ist, fragt der Verbindungsfilter-Agent den Anbieterdienst für geblockte IP-Adressen gemäß der Priorität ab, die für diese Konfiguration des Anbieters für geblockte IP-Adressen festgelegt ist.
Instance	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.IPBlockListProvider	Der Parameter Instance ermöglicht das Übergeben eines gesamten Objekts an den zu verarbeitenden Befehl. Er wird hauptsächlich in Skripts verwendet, in denen ein gesamtes Objekt an den Befehl übergeben werden muss.
IPAddressesMatch	Optional	Microsoft.Exchange.Data.MultiValuedProperty	Wenn Sie eine IP-Adresse für den Parameter IPAddressesMatch konfigurieren, agiert der Verbindungsfilter-Agent nur bei Nachrichten, die dem IP-Adressstatuscode entsprechen, der vom Anbieterdienst für geblockte IP-Adressen zurückgegeben wird.
LookupDomain	Optional	Microsoft.Exchange.Data.SmtpDomain	Dieser Parameter gibt den Domänennamen an, den der Verbindungsfilter-Agent auf aktualisierte IP-Sperrlistendaten abfragt.
Name	Optional	System.String	Dieser Parameter gibt den Namen des Anbieterdiensts für geblockte IP-Adressen an. Der Zeichenfolgenwert des Parameters Identity ändert sich nicht, wenn Sie diesen Wert ändern.
Priority	Optional	System.Int32	Legen Sie den Parameter Priority fest, um die Reihenfolge zu konfigurieren, in welcher der Verbindungsfilter-Agent die Anbieterdienste für geblockte IP-Adressen abfragt, die Sie konfiguriert haben. Immer wenn Sie einen neuen Anbieter für geblockte IP-Adressen hinzufügen, wird dem Eintrag standardmäßig die Priorität N+1 zugewiesen. Dabei ist N die Anzahl der Anbieterdienste für geblockte IP-Adressen, die Sie konfiguriert haben. Wenn Sie den Parameter Priority auf einen Wert festlegen, der dem eines anderen Anbieters für geblockte IP-Adressen entspricht, wird der Wert des anderen Anbieters für geblockte IP-Adressen um 1 erhöht.
RejectionResponse	Optional	Microsoft.Exchange.Data.AsciiString	Der Parameter RejectionResponse benötigt eine Zeichenfolge. Geben Sie den Nachrichtentext ein, der in der SMTP-Sitzung an Absender übermittelt werden soll, deren Nachrichten vom Verbindungsfilter-Agent geblockt werden, wenn ein Anbieterdienst für geblockte IP-Adressen eine Übereinstimmung mit der IP-Adresse des Absenders feststellt. Es wird empfohlen, dass Sie den Anbieterdienst für geblockte IP-Adressen in der Antwort angeben, damit berechtigte Absender den Anbieterdienst kontaktieren können. Das Argument darf maximal 240 Zeichen aufweisen. Wenn Sie ein Argument übergeben, müssen Sie den Parameter RejectionResponse in doppelte Anführungszeichen setzen, falls der Ausdruck Leerzeichen wie im folgenden Beispiel enthält: `"Originating IP addresses matched to Example.com's IP Block List Provider service"`.
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

Die folgende Codebeispiele zeigt zwei Set-IPBlockListProvider-Befehle.

Das erste Codebeispiel zeigt einen Set-IPBlockListProvider-Befehl, der den Verbindungsfilter so festlegt, dass auf alle vom Anbieterdienst für geblockte IP-Adressen gefundenen Übereinstimmungen eine Aktion erfolgen muss.

Das zweite Codebeispiel zeigt einen Set-IPBlockListProvider-Befehl, der die Priorität einer vorhandenen Konfiguration auf 1 festlegt.

Set-IPBlockListProvider -Identity Example.com -AnyMatch:$true 
Set-IPBlockListProvider -Identity Example.com -Priority 1

Freigeben über