Set-IPAllowListProvider

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

Mit dem Cmdlet Set-IPAllowListProvider können die Konfigurationsinformationen einer bestimmten Konfiguration des Anbieters für zugelassene IP-Adressen auf einem Computer geändert werden, auf dem eine der beiden Serverfunktionen Edge-Transport oder Hub-Transport installiert ist.

Syntax

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

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

Detaillierte Beschreibung

Verwenden Sie das Cmdlet Set-IPAllowListProvider, um vorhandene Konfigurationen des Anbieters für zugelassene IP-Adressen zu ändern. Diese Konfiguration wird vom Verbindungsfilter-Agent verwendet. Der Parameter Identity ist erforderlich.

Damit Sie das Cmdlet Set-IPAllowListProvider 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 Set-SystemMessage 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.IPAllowListProviderIdParameter	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 AnyMatch 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 zugelassene IP-Adressen zurückgegebenen Statuscodes für IP-Adressen als Übereinstimmung.
BitmaskMatch	Optional	System.Net.IPAddress	Wenn eine IP-Adresse für den Parameter BitmaskMatch konfiguriert wird, verarbeitet der Verbindungsfilter-Agent nur Nachrichten, die dem Statuscode der IP-Adresse entsprechen, der vom Anbieterdienst für zugelassene IP-Adressen zurückgegeben wird.
Confirm	Optional	System.Management.Automation.SwitchParameter	Der Parameter Confirm bewirkt eine Unterbrechung der Befehlsausführung und zwingt Sie, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für den Parameter Confirm muss kein Wert angegeben werden.
DomainController	Optional	Microsoft.Exchange.Data.Fqdn	Um anzugeben, welcher Domänencontroller diese Änderung an den Konfigurationsdaten für die Verbindungsfilterung in den Verzeichnisdienst Active Directory schreibt, fügen Sie dem Befehl den Parameter DomainController hinzu. Wenn Sie diesen Befehl auf einem Computer ausführen, auf dem die Serverfunktion Edge-Transport installiert ist, wird der Parameter DomainController nicht unterstützt. 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 zugelassene IP-Adressen gemäß der Priorität ab, die für diese Konfiguration des Anbieters für zugelassene IP-Adressen festgelegt ist.
Instance	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.IPAllowListProvider	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 eine IP-Adresse für den Parameter IPAddressesMatch konfiguriert wird, verarbeitet der Verbindungsfilter-Agent nur Nachrichten, die dem Statuscode der IP-Adresse entsprechen, der vom Anbieterdienst für zugelassene IP-Adressen zurückgegeben wird.
LookupDomain	Optional	Microsoft.Exchange.Data.SmtpDomain	Der Domänenname, der vom Verbindungsfilter-Agent auf aktualisierte zugelassene IP-Adressdaten abgefragt wird.
Name	Optional	System.String	Der Name des Anbieterdiensts für zugelassene IP-Adressen. 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 zugelassene IP-Adressen abfragt, die Sie konfiguriert haben. Standardmäßig wird bei jedem Hinzufügen eines neuen Anbieterdiensts für zugelassene IP-Adressen dem Eintrag eine Priorität von N+1 zugewiesen, wobei "N" die Anzahl der von Ihnen konfigurierten Anbieterdienste für zugelassene IP-Adressen ist. Wenn Sie den Parameter Priority auf einen Wert festlegen, der mit dem eines anderen Anbieterdiensts für zugelassene IP-Adressen identisch ist, wird die Priorität des von Ihnen zuerst hinzugefügten Anbieterdiensts für zugelassene IP-Adressen um den Wert "1" erhöht.
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 Parameters WhatIf können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für den Parameter WhatIf muss kein Wert angegeben werden.

Eingabetypen

Rückgabetypen

Fehler

Fehler	Beschreibung

Beispiel

Das erste Codebeispiel zeigt einen Befehl Set-IPAllowListProvider, mit dem der Verbindungsfilter so eingestellt wird, dass jede Übereinstimmung des Anbieterdiensts für zugelassene IP-Adressen als Ereignis interpretiert wird, das einer Aktion bedarf.

Das zweite Codebeispiel zeigt einen Befehl Set-IPAllowListProvider, mit dem die Priorität einer vorhandenen Konfiguration auf 1 festgelegt wird.

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