Test-IPAllowListProvider
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2007-06-28
La cmdlet Test-IPAllowListProvider permet de tester la configuration d'un fournisseur de listes vertes d'IP sur un ordinateur sur lequel le rôle serveur de transport Hub ou Edge est installé. Cette configuration est utilisée par l'agent de filtrage des connexions.
Syntaxe
Test-IPAllowListProvider -Identity <IPAllowListProviderIdParameter> -IPAddress <IPAddress> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Cette commande contrôle la connectivité avec le fournisseur de listes vertes d'IP spécifié, puis envoie une demande de recherche au fournisseur de listes vertes d'IP. Lorsque vous testez la connexion et la fonctionnalité du fournisseur de listes vertes d'IP, vous devez entrer une adresse IP autorisée connue dans le paramètre IPAddress.
Pour exécuter la cmdlet Test-IPAllowListProvider, 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 Test-IPAllowListProvider 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 |
|---|---|---|---|
Identity |
Obligatoire |
Microsoft.Exchange.Configuration.Tasks.IPAllowListProviderIdParameter |
Entrez le nom du fournisseur de listes vertes d'IP dans ce paramètre. Le paramètre Identity doit correspondre au paramètre Name ou Identity (GUID) du fournisseur de listes vertes d'IP que vous voulez tester. |
IPAddress |
Obligatoire |
System.Net.IPAddress |
Le paramètre IPAddress sert à vérifier et tester les fournisseurs de listes vertes d'IP que vous avez configurés. |
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 (FQDN) 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 sur lesquels le rôle serveur de transport Edge est installé. Le rôle serveur de transport Edge écrit uniquement sur l'instance ADAM locale. |
Server |
Facultatif |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Pour spécifier le serveur sur lequel vous exécutez la cmdlet Test- IPAllowListProvider, incluez le paramètre Server dans le commande. Si vous n’utilisez pas le paramètre Server, la commande est exécutée sur le serveur local où la tâche est exécutée. |
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
| Sortie | Description |
|---|---|
Allow List Provider |
Allow List Provider retourne l'objet fournisseur de listes vertes d'IP comme stocké dans l'annuaire ADAM local ou dans le service d'annuaire Active Directory. |
Connected |
Connected retourne les valeurs suivantes : True ou False.
|
Matched |
Matched retourne l'une des valeurs suivantes : True ou False.
|
ProviderResult |
ProviderResult retourne une adresse IP, qui représente l'état, selon le fournisseur de listes vertes d'IP, du paramètre IPAddress soumis dans la commande Test‑IPAllowListProvider. Contactez votre fournisseur de listes vertes d'IP pour déterminer la signification de l'adresse IP retournée ici. |
Erreurs
| Erreur | Description |
|---|---|
Autorisations insuffisantes |
Vous devez ouvrir une session en utilisant un compte membre du groupe Administrateurs local sur l'ordinateur local sur lequel le rôle serveur de transport Edge est installé pour exécuter cette commande. |
Connexion à ADAM impossible |
Si vous exécutez cette tâche depuis un ordinateur sur lequel le rôle serveur de transport Edge est installé, vérifiez que le service ADAM (MsExchangeAdam) est en cours d'exécution sur l'ordinateur local. Si vous exécutez cette tâche depuis un ordinateur sur lequel le rôle serveur de transport Hub est installé, vérifiez que l'ordinateur peut se connecter à Active Directory. |
Connexion impossible au fournisseur de listes vertes d'IP |
Contactez votre fournisseur de listes vertes d'IP. |
Exemple
L'exemple de code suivant montre une commande Test‑IPAllowListProvider qui a les paramètres requis. La commande teste la connectivité avec un fournisseur fictif de listes vertes d'IP, appelé ExampleProviderName, puis émet une demande de recherche à ce fournisseur.
Test-IPAllowListProvider -IPAddress 192.168.0.1 -Provider ExampleProviderName