Add-IPBlockListEntry
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-IPBlockListEntry permet d'ajouter une adresse IP ou une plage d'adresses IP aux informations de configuration de liste rouge d'IP pour la configuration du filtre des connexions relative à l'ordinateur sur lequel la commande est exécutée. Vous devez disposer des droits Administrateur sur l'ordinateur sur lequel le rôle serveur de transport Hub ou serveur de transport Edge est installé.
Syntaxe
Add-IPBlockListEntry -IPRange <IPRange> [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ExpirationTime <DateTime>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
Add-IPBlockListEntry -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-IPBlockListEntry, 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-IPBlockListEntry, 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-IPBlockListEntry 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 |
|---|---|---|---|
IPAddress |
Obligatoire |
System.Net.IPAddress |
Vous pouvez spécifier une adresse IP unique à ajouter à la liste d'interdiction d'IP. Par exemple, |
IPRange |
Obligatoire |
Microsoft.Exchange.Data.IPRange |
Vous pouvez ajouter des adresses IP à la liste d'interdiction d'IP dans les formats suivants :
|
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 d'interdiction 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 : |
Server |
Facultatif |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Pour spécifier un autre serveur de transport Hub sur lequel exécuter la cmdlet Add-IPBlockListEntry, incluez le paramètre Serverdans 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
L'exemple de code suivant montre comment utiliser la cmdlet Add-IPBlockListEntry pour ajouter une plage d'adresses IP à la liste rouge 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 d'adresses IP bloquées expirera à 23 h. 59 le 3 janvier 2007.
Add-IPBlockListEntry -IPRange:192.168.0.1/24
Add-IPBlockListEntry -IPRange:192.168.0.1/24 -ExpirationTime "1/3/2007 23:59"