Test-ImapConnectivity
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2010-08-18
La cmdlet Test-ImapConnectivity permet de vérifier que le service IMAP4 s'exécute comme prévu. Le cmdlet Test-ImapConnectivity permet de tester la fonctionnalité IMAP4 d'un serveur d'accès au client spécifié pour toutes les boîtes aux lettres sur des serveurs Exchange 2007 se trouvant dans le même site Active Directory.
Syntaxe
Test-ImapConnectivity [-ClientAccessServer <ServerIdParameter>] [-Confirm [<SwitchParameter>]] [-ConnectionType <Plaintext | Tls | Ssl>] [-DomainController <Fqdn>] [-LightMode <SwitchParameter>] [-MailboxCredential <PSCredential>] [-MailboxServer <ServerIdParameter>] [-MonitoringContext <SwitchParameter>] [-PerConnectionTimeout <Int32>] [-PortClientAccessServer <Int32>] [-ResetTestAccountCredentials <SwitchParameter>] [-Timeout <UInt32>] [-TrustAnySSLCertificate <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Description détaillée
La cmdlet Test-ImapConnectivity permet de vérifier que le service IMAP4 s'exécute comme prévu. Le cmdlet Test-ImapConnectivity permet de tester la fonctionnalité IMAP4 d'un serveur d'accès au client spécifié.
Pour exécuter la cmdlet Test-PopConnectivity pour tester la fonctionnalité IMAP4 sur un serveur d'accès au client, vous devez utiliser un compte auquel ont été délégués le rôle Administrateur de serveur Exchange et l'appartenance au groupe Administrateurs local pour le serveur cible.
Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
ClientAccessServer |
Facultatif |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Ce paramètre spécifie le nom du serveur d'accès au client à tester. N'utilisez pas ce paramètre avec le paramètre URL. |
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. |
ConnectionType |
Facultatif |
Microsoft.Exchange.Monitoring.ProtocolConnectionType |
Ce paramètre spécifie le type de connexion utilisée pour se connecter au serveur d'accès au client. |
DomainController |
Facultatif |
Microsoft.Exchange.Data.Fqdn |
Pour spécifier le nom de domaine complet du contrôleur de domaine qui extrait des données du service d'annuaire Active Directory, incluez le paramètre DomainController dans la cmdlet. |
LightMode |
Facultatif |
System.Management.Automation.SwitchParameter |
Ce paramètre n'est pas implémenté pour la cmdlet Test-ImapConnectivity. L'utilisation de ce paramètre ne modifie pas le comportement de la cmdlet. > [!Note] > Cette cmdlet est implémentée pour d'autres cmdlets de diagnostic Exchange 2007. |
MailboxCredential |
Facultatif |
System.Management.Automation.PSCredential |
Ce paramètre inclut les informations d'identification de boîte aux lettres pour un test d'URL unique. |
MailboxServer |
Facultatif |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Ce paramètre spécifie le nom du serveur de boîtes aux lettres à tester. S'il n'est pas spécifié, tous les serveurs de boîtes aux lettres se trouvant dans le site Active Directory local sont testés. |
MonitoringContext |
Facultatif |
System.Management.Automation.SwitchParameter |
Si ce paramètre est inclus, la tâche est exécutée par une planification MOM (Microsoft Operations Manager). L'exécution de la tâche avec ce paramètre sans MOM entraîne un échec de la tâche. En cas d'exclusion de ce paramètre, un administrateur doit exécuter la tâche de façon interactive. |
PerConnectionTimeout |
Facultatif |
System.Int32 |
Ce paramètre spécifie le temps d'attente (en secondes) par connexion, avant l'achèvement de l'opération de test. La valeur par défaut de PerConnectionTimeout est 24 secondes. Vous devez spécifier une valeur de délai d'expiration supérieure à 0 secondes et inférieure à 120 secondes. Il est recommandé de toujours configurer ce paramètre avec une valeur minimale de 5 secondes. |
PortClientAccessServer |
Facultatif |
System.Int32 |
Ce paramètre spécifie le port utilisé pour se connecter au serveur d'accès au client que vous allez utiliser avec la cmdlet Test-ImapConnectivity. |
ResetTestAccountCredentials |
Facultatif |
System.Management.Automation.SwitchParameter |
Le paramètre ResetTestAccountCredentials réinitialise le mot de passe du compte de test utilisé pour l'exécution de cette commande. Le mot de passe du compte de test est généralement réinitialisé tous les sept jours si vous utilisez Microsoft System Center Operations Manager pour gérer votre environnement Exchange. L'utilisation de cet indicateur oblige une réinitialisation du mot de passe à tout moment en cas de nécessité pour des raisons de sécurité. |
Timeout |
Facultatif |
System.UInt32 |
Ce paramètre spécifie le temps d'attente (en secondes), avant l'achèvement de l'opération de test. La valeur par défaut pour le Délai d'expiration est 30 secondes. Vous devez spécifier un délai d'expiration supérieur à 0 secondes et inférieur à 1 heure (3 600 secondes). Il est recommandé de toujours configurer ce paramètre avec une valeur minimale de 5 secondes. |
TrustAnySSLCertificate |
Facultatif |
System.Management.Automation.SwitchParameter |
En cas d'utilisation de ce paramètre, les échecs de validation de certificat SSL (Secure Sockets Layer) ne sont pas signalés. Ce paramètre permet à la cmdlet Test-ImapConnectivity de vérifier le service IMAP4 sans générer d'erreur si le certificat ne correspond pas à l'adresse URL du serveur d'accès au client. |
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 teste la connectivité IMAP4 du serveur d'accès au client Contoso12 à l'aide des informations d'identification de l'utilisateur contoso\kweku.
Le second exemple de code teste la connectivité IMAP4 d'un serveur d'accès au client spécifique nommé Contoso12 et teste toutes les boîtes aux lettres Exchange 2007,
Test-ImapConnectivity -ClientAccessServer:Contoso12 -MailboxCredential:(get-credential contoso\kweku)
Test-ImapConnectivity -ClientAccessServer:Contoso12