Partager via


Set-IPAllowListProvider

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2007-06-28

La cmdlet Set-IPAllowListProvider permet de modifier les informations de configuration d'un fournisseur de listes vertes d'IP spécifique sur un ordinateur sur lequel le rôle serveur de transport Hub ou Edgeest installé.

Syntaxe

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>]]

Description détaillée

La cmdlet Set-IPAllowListProvider permet de modifier des configurations de fournisseur de listes vertes d'IP existantes. Cette configuration est utilisée par l'agent de filtrage des connexions. Le paramètre Identity est requis.

Pour exécuter la cmdlet Set-IPAllowListProvider, vous devez utiliser un compte auquel ont été délégués :

  • le rôle Administrateur de serveur Exchange et le groupe Administrateurs local pour le serveur cible.

Pour exécuter la cmdlet Set-IPAllowListProvider sur un ordinateur sur lequel le rôle serveur de transport Edge est installé, vous devez ouvrir une session en utilisant un compte membre du groupe Administrateurs local présent sur cet ordinateur.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Microsoft Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.IPAllowListProviderIdParameter

Le paramètre Identity peut prendre la valeur d'une chaîne, qui est la valeur Name, ou le GUID.

AnyMatch

Facultatif

System.Boolean

Une entrée valide pour le paramètre AnyMatch est $true ou $false. Le paramètre par défaut est $false. Lorsque le paramètre AnyMatch a la valeur $true, l'agent de filtrage des connexions traite tout code d'état d'adresse IP retourné par le service fournisseur de listes vertes d'IP comme une correspondance.

BitmaskMatch

Facultatif

System.Net.IPAddress

Lorsque vous configurez une adresse IP pour le paramètre BitmaskMatch, l'agent de filtrage des connexions intervient uniquement sur des messages qui correspondent au code d'état d'adresse IP retourné par le service fournisseur de listes vertes d'IP.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Confirm suspend le traitement par la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Il n'est pas nécessaire de spécifier une valeur pour le paramètre Confirm.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Pour indiquer quel contrôleur de domaine écrit ce changement de configuration pour les données de configuration du filtrage des connexions dans le service d'annuaire Active Directory, incluez le paramètre DomainController dans la commande. Si vous exécutez cette commande sur un ordinateur sur lequel le rôle serveur de transport Edge est installé, le paramètre DomainController n'est pas pris en charge. Le serveur de transport Edge écrit uniquement sur l'instance ADAM locale.

Enabled

Facultatif

System.Boolean

Une entrée valide pour le paramètre Enabled est $true ou $false. Le paramètre par défaut est $true. Lorsque le paramètre Enabled a la valeur $true, l'agent de filtrage des connexions interroge le service fournisseur de listes vertes d'IP en fonction de la priorité définie pour cette configuration de fournisseur de listes vertes d'IP.

Instance

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.IPAllowListProvider

Le paramètre Instance vous permet de transmettre un objet entier à la commande à traiter. Il est principalement utilisé dans les scripts où un objet entier doit être transmis à la commande.

IPAddressesMatch

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Lorsque vous configurez une adresse IP pour le paramètre IPAddressesMatch, l'agent de filtrage des connexions intervient uniquement sur des messages qui correspondent au code d'état d'adresse IP retourné par le service fournisseur de listes vertes d'IP.

LookupDomain

Facultatif

Microsoft.Exchange.Data.SmtpDomain

Nom de domaine interrogé par l'agent de filtrage des connexions pour obtenir des données mises à jour de listes vertes d'IP.

Name

Facultatif

System.String

Nom du service fournisseur de listes vertes d'IP. La valeur de chaîne pour le paramètre Identity ne change pas si vous modifiez cette valeur.

Priority

Facultatif

System.Int32

Définissez le paramètre Priority afin de configurer l'ordre dans lequel l'agent de filtrage des connexions interroge les services fournisseurs de listes vertes d'IP que vous avez configurés. Par défaut, à chaque ajout d'un nouveau service fournisseur de listes vertes d'IP, une priorité de N+1 est attribuée à l'entrée, où N est le nombre de services fournisseurs de listes vertes d'IP que vous avez configurés.

Si vous définissez le paramètre Priority sur une valeur identique à celle d'un autre service fournisseur de listes vertes d'IP, la priorité du service fournisseur de listes vertes d'IP que vous avez commencé par ajouter est incrémentée de 1.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre WhatIf donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce au paramètre WhatIf, vous pouvez afficher des changements potentiels sans devoir les appliquer. Il n'est pas nécessaire de spécifier une valeur pour le paramètre WhatIf.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

Exemple

Le premier exemple de code montre une commande Set‑IPAllowListProvider qui définit le filtre des connexions pour qu'il traite toute correspondance par le service fournisseur de listes vertes d'IP comme un événement déclenchable.

Le second exemple de code montre une commande Set‑IPAllowListProvider qui définit la priorité d'une configuration existante comme ayant la valeur 1.

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