Add-IPAllowListEntry

 

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

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

La cmdlet Add-IPAllowListEntry permet d'ajouter une adresse IP ou une plage d'adresses IP aux informations de configuration de listes vertes d'IP pour l'agent de filtrage des connexions sur un ordinateur sur lequel le rôle serveur de transport Hub ou Edge est installé.

Syntaxe

Add-IPAllowListEntry -IPRange <IPRange> [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ExpirationTime <DateTime>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Add-IPAllowListEntry -IPAddress <IPAddress> [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ExpirationTime <DateTime>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Si vous ne spécifiez pas le paramètre IPAddress lors de l'exécution de la cmdlet Add-IPAllowListEntry, Exchange Management Shell vous invite à le faire. Le paramètre IPAddress ou IPRange est obligatoire.

Notes

Si Microsoft Exchange Server 2007 Service Pack 1 (SP1) est déployé sur un ordinateur exécutant Windows Server 2008, vous pouvez entrer des adresses IP et des plages d'adresses IP au format du protocole IPv4, du protocole IPv6 ou aux deux formats. Une installation par défaut de Windows Server 2008 prend en charge les protocoles IPv4 et IPv6. Pour plus d'informations sur la prise en charge par Exchange 2007 SP1 des adresses IPv6, consultez la rubrique Prise en charge du protocole IPv6 dans Exchange 2007 SP1 et SP2.

Pour exécuter la cmdlet Add-IPAllowListEntry, 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-IPAllowListEntry 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

IPAddress

Obligatoire

System.Net.IPAddress

Vous pouvez spécifier une adresse IP unique à ajouter à la liste verte d'IP comme suit, par exemple : 192.168.0.1.

IPRange

Obligatoire

Microsoft.Exchange.Data.IPRange

Vous pouvez ajouter des plages d'adresses IP à la liste verte d'IP dans les formats suivants :

  • CIDR IP    Routage inter-domaines sans classe. Par exemple, 192.168.0.1/24

  • Plage IP   Par exemple, 192.168.0.1-192.168.0.254

Comment

Facultatif

System.String

Utilisez ce paramètre pour créer des notes administratives ou des rappels concernant cette entrée spécifique. La valeur du paramètre Comment doit être placée entre guillemets, par exemple : « ceci est une note administrative ».

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.

ExpirationTime

Facultatif

System.DateTime

Vous pouvez spécifier un jour et une heure d'expiration de l'entrée de liste verte d'IP que vous créez. Si vous spécifiez uniquement une heure mais pas de date, le système suppose qu'il s'agit du jour en cours. Si vous entrez une date spécifique, utilisez le format de date courte défini dans les paramètres Options régionales configurés sur l'ordinateur local. Par exemple, si l'ordinateur est configuré pour utiliser le format de date courte mm/jj/aaaa hh:mm:ss, pour fixer le délai d'expiration à 11h00 le 3 janvier 2007, placez les informations suivantes entre guillemets doubles : "1/3/2007 11:00".

Server

Facultatif

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Pour spécifier un autre serveur de transport Hub sur lequel exécuter la cmdlet Add-IPAllowListEntry, incluez le paramètre Server dans la commande. Si vous n’utilisez pas le paramètre Server, la commande est exécutée sur le serveur local sur lequel la commande est exécutée.

Vous ne pouvez pas utiliser cette cmdlet pour configurer d'autres serveurs de transport Edge à distance.

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 Add‑IPBlockListEntry qui ajoute une plage d'adresses IP à la liste verte d'IP pour l'ordinateur sur lequel la commande est exécutée. Le second exemple définit que la même entrée de liste verte d'IP expirera à 23h59 le 3 janvier 2007.

Add-IPAllowListEntry -IPRange:192.168.0.1/24 
Add-IPAllowListEntry -IPRange:192.168.0.1/24 -ExpirationTime "1/3/2007 23:59"