Add-IPAllowListProvider

Article
09/30/2014

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

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

La cmdlet Add-IPAllowListProvider permet de créer une configuration de fournisseur de listes vertes d'IP sur un ordinateur sur lequel le rôle serveur de transport Hub ou Edge est installé.

Syntaxe

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

Description détaillée

La configuration du fournisseur de listes vertes d'IP est utilisée par l'agent de filtrage des connexions.

Les paramètres Name et LookupDomain sont requis. Si vous ne transmettez pas les paramètres requis, Exchange Management Shell vous invite à les entrer.

Pour exécuter la cmdlet Add-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 Add-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 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
LookupDomain	Obligatoire	Microsoft.Exchange.Data.SmtpDomain	Nom de domaine interrogé par l'agent de filtrage des connexions pour obtenir des informations mises à jour de listes vertes d'IP
Name	Obligatoire	System.String	Nom du service fournisseur de listes vertes d'IP
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 le paramètre BitmaskMatch pour utiliser une adresse IP, 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.
IPAddressesMatch	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Lorsque vous configurez une adresse IP pour le paramètre IPAddressMatch, 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.
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.
TemplateInstance	Facultatif	System.Management.Automation.PSObject	Lorsqu'un objet existant est fourni pour ce paramètre, la commande utilise la configuration de l'objet pour créer un copie de l'objet sur un serveur local ou cible.
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

L'exemple de code suivant montre une commande Add-IPAllowListProvider qui a les paramètres requis : LookupDomain et Name.

Add-IPAllowListProvider -Name:Example -LookupDomain:Example.com