Get-IPBlockListEntry

 

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

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

La cmdlet Get-IPBlockListEntry permet d'obtenir des informations sur la configuration des adresses IP pour l'agent de filtrage des connexions de l'ordinateur sur lequel la commande est exécutée.

Syntaxe

Get-IPBlockListEntry [-Identity <IPListEntryIdentity>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>]

Get-IPBlockListEntry -IPAddress <IPAddress> [-ResultSize <Unlimited>] [-Server <ServerIdParameter>]

Description détaillée

L'agent de filtrage de connexion utilise la liste d'adresses IP bloquées.

Pour exécuter la cmdlet Get-IPBlockListEntry, vous devez utiliser un compte auquel a été délégué :

  • le rôle Administrateurs Affichage seul d'Exchange.

Pour exécuter la cmdlet Get-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

Si vous voulez afficher la ou les entrées de liste d'interdiction d'IP contenant une adresse IP spécifique, utilisez le paramètre IPAddress pour spécifier une adresse IP. Par exemple, si une entrée de liste d'interdiction d'IP spécifie une plage d'adresses IP allant de 192.168.0.1 à 192.168.0.20, entrez une adresse IP quelconque dans la plage d'adresses IP de la liste d'interdiction d'IP pour retourner l'entrée de liste d'interdiction d'IP.

Identity

Facultatif

Microsoft.Exchange.Configuration.Tasks.IPListEntryIdentity

Si vous voulez afficher une entrée spécifique de liste d'interdiction d'IP, utilisez le paramètre Identity pour spécifier le numéro de configuration. Lorsque vous ajoutez une adresse IP à la liste d'interdiction d'IP, le paramètre Identity est automatiquement incrémenté.

ResultSize

Facultatif

Microsoft.Exchange.Data.Unlimited

Le paramètre ResultSize spécifie le nombre maximal de résultats à retourner. Si vous voulez retourner toutes les entrées, utilisez unlimited comme valeur pour ce paramètre. La valeur par défaut est 1000.

Server

Facultatif

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Pour spécifier un autre serveur de transport Hub sur lequel exécuter la cmdlet Get-IPBlockListEntry, 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.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

Exemple

Le premier exemple de code présente une commande Get-IPBlockListEntry qui renvoie des entrées générées par ordinateur qui sont insérées par la fonctionnalité de réputation de l'expéditeur.

Le deuxième exemple de code présente une commande Get-IPBlockListEntry qui supprime des entrées générées par ordinateur qui ont expiré il y a 14 jours.

Get-IPBlockListEntry | where { $_.IsMachineGenerated }
Get-IPBlockListEntry | where { $_.IsMachineGenerated -and $_.ExpirationTime -lt (date).AddDays(-14) } | Remove-IPBlockListEntry