Set-IPBlockListProvider

  • Artikel

 

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