Remove-IPAllowListEntry

Article
09/30/2014

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

Dernière rubrique modifiée : 2011-01-12

La cmdlet Remove‑IPAllowListEntry permet de supprimer une adresse IP des informations sur la configuration de l'agent de filtrage des connexions de l'ordinateur sur lequel la commande est exécutée.

Syntaxe

Remove-IPAllowListEntry -Identity <IPListEntryIdentity> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Si vous ne spécifiez pas le paramètre Identity lors de l'exécution de la commande Remove‑IPAllowListEntry, Exchange Management Shell vous invite à le faire.

L'agent de filtrage des connexions utilise la configuration de l'entrée de liste verte d'IP.

Pour exécuter la cmdlet Remove-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 Remove-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 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.IPListEntryIdentity	Vous devez spécifier le paramètre Identity de l'adresse IP que vous souhaitez supprimer. Lorsque vous ajoutez une adresse IP à la liste verte d'IP, le paramètre Identity est automatiquement incrémenté.
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.
Server	Facultatif	Microsoft.Exchange.Configuration.Tasks.ServerIdParameter	Pour spécifier un autre serveur de transport Hub sur lequel exécuter la cmdlet Remove-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

Exemples

Description

Les exemples de code suivants montrent une commande Remove-IPAllowListEntry qui supprime l'adresse IP ou la plage d'adresses IP de la liste verte IP pour l'ordinateur sur lequel la commande est exécutée.

EXEMPLE 1

L'exemple suivant supprime l'adresse IP 192.168.0.100 de la liste verte IP.

Get-IPAllowListEntry | Where {$_.IPRange -eq '192.168.0.100'} | Remove-IPAllowListEntry

EXEMPLE 2

L'exemple suivant supprime la plage d'adresses IP 192.168.0.0/24 de la liste verte IP.

Get-IPAllowListEntry | Where {$_.IPRange -eq '192.168.0.0/24'} | Remove-IPAllowListEntry

Remarque :
Vous devez spécifier l'attribut Identity d'une entrée de liste verte IP lors de l'utilisation de la commande Remove-IPAllowListEntry. L'attribut Identity est une valeur de nombre entier affectée automatiquement lorsque l'entrée de liste verte IP est créée. Pour supprimer une adresse IP ou une plage d'adresses IP de la liste verte IP, vous pouvez utiliser la sortie de la commande Get-IPAllowListEntry.

Vous devez spécifier l'attribut Identity d'une entrée de liste verte IP lors de l'utilisation de la commande Remove-IPAllowListEntry. L'attribut Identity est une valeur de nombre entier affectée automatiquement lorsque l'entrée de liste verte IP est créée. Pour supprimer une adresse IP ou une plage d'adresses IP de la liste verte IP, vous pouvez utiliser la sortie de la commande Get-IPAllowListEntry.

Code

Remove-IPAllowListEntry -Identity <Integer>