Set-IPBlockListProvider

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

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

Syntaxe

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

Description détaillée

La cmdlet Set-IPBlockListProvider permet de modifier des configurations de fournisseur de listes rouges 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-IPBlockListProvider, 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-IPBlockListProvider 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.IPBlockListProviderIdParameter	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 Enabled 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 d'interdiction 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 liste d'adresses IP bloquées.
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 spécifier le nom de domaine complet du contrôleur de domaine qui écrit ce changement de configuration dans le service d'annuaire Active Directory, incluez le paramètre DomainController dans la commande. Le paramètre DomainController n'est pas pris en charge sur les ordinateurs qui exécutent le rôle serveur de transport Edge. Le rô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 d'interdiction d'IP en fonction de la priorité définie pour cette configuration de fournisseur de listes d'interdiction d'IP.
Instance	Facultatif	Microsoft.Exchange.Data.Directory.SystemConfiguration.IPBlockListProvider	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 liste d'adresses IP bloquées.
LookupDomain	Facultatif	Microsoft.Exchange.Data.SmtpDomain	Ce paramètre spécifie le nom de domaine interrogé par l'agent de filtrage des connexions pour obtenir des données de listes rouges d'IP mises à jour.
Name	Facultatif	System.String	Ce paramètre spécifie le nom du service fournisseur de listes rouges 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 d'interdiction d'IP que vous avez configurés. Par défaut, à chaque ajout d'un nouveau fournisseur de listes d'interdiction d'IP, une priorité de N+1 est attribuée à l'entrée, où N est le nombre de services fournisseurs de listes d'interdiction d'IP que vous avez configurés. Si vous définissez le paramètre Priority sur une valeur identique à celle d'un autre fournisseur de listes d'interdiction d'IP, l'autre fournisseur de listes d'interdiction d'IP est incrémenté de 1.
RejectionResponse	Facultatif	Microsoft.Exchange.Data.AsciiString	Le paramètre RejectionResponse prend une valeur de chaîne. Entrez le corps du message à délivrer durant la session SMTP aux expéditeurs dont les messages sont bloqués par l'agent de filtrage des connexions quand un service fournisseur de listes d'interdiction d'IP correspond à l'adresse IP de l'expéditeur. Il est recommandé de spécifier le service fournisseur de listes d'interdiction d'IP dans la réponse de façon à ce que les expéditeurs légitimes puissent contacter le service fournisseur. L'argument ne peut pas dépasser 240 caractères. Lorsque vous transmettez un argument, vous devez placer le paramètre RejectionResponse entre guillemets doubles si la phrase contient des espaces, comme suit : `"Originating IP addresses matched to Example.com's IP Block List Provider service"`.
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 illustre deux commandes Set‑IPBlockListProvider.

Le premier exemple de code montre une commande Set‑IPBlockListProvider qui définit le filtre de connexion pour qu'il traite toute correspondance par le serveur fournisseur de liste d'adresses IP bloquées comme un événement déclenchable.

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

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