Test-OwaConnectivity
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-OwaConnectivity permet de vérifier que Microsoft Office Outlook Web Access s'exécute comme prévu. La cmdlet Test-OwaConnectivity permet de tester la connectivité Outlook Web Access pour tous les répertoires virtuels Microsoft Exchange 2007 sur un serveur d'accès au client spécifié pour toutes les boîtes aux lettres se trouvant sur des serveurs Exchange 2007 dans le même site Active Directory. La cmdlet Test-OwaConnectivity peut également être utilisée pour tester la connectivité pour une URL Exchange 2007 Outlook Web Access individuelle.
Syntaxe
Test-OwaConnectivity [-ClientAccessServer <ServerIdParameter>] [-AllowUnsecureAccess <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-LightMode <SwitchParameter>] [-MailboxServer <ServerIdParameter>] [-MonitoringContext <SwitchParameter>] [-ResetTestAccountCredentials <SwitchParameter>] [-Site <AdSiteIdParameter>] [-TestType <Internal | External>] [-Timeout <UInt32>] [-TrustAnySSLCertificate <SwitchParameter>] [-VirtualDirectoryName <String>] [-WhatIf [<SwitchParameter>]]
Test-OwaConnectivity [-URL <String>] [-AllowUnsecureAccess <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-LightMode <SwitchParameter>] [-MailboxCredential <PSCredential>] [-ResetTestAccountCredentials <SwitchParameter>] [-Site <AdSiteIdParameter>] [-Timeout <UInt32>] [-TrustAnySSLCertificate <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Description détaillée
La cmdlet Test-OwaConnectivity permet de tester la connectivité de tous les répertoires virtuels Exchange 2007 Outlook Web Access sur un serveur d'accès au client ou de tester la connectivité d'une adresse URL Exchange 2007 Outlook Web Access unique.
Pour tester les répertoires virtuels Exchange 2007 Outlook Web Access sur un serveur d'accès au client, un compte Active Directory de test doit exister. Il doit y avoir au moins une boîte aux lettres de test sur chaque serveur Exchange 2007 sur lequel le rôle serveur de boîtes aux lettres est installé, accessible via les répertoires virtuels testés. Vous pouvez créer des comptes et des boîtes aux lettres de test au cours d'une étape de l'installation du serveur de boîtes aux lettres. Si l'environnement de test n'a pas été créé durant l'installation du serveur de boîtes aux lettres, vous êtes invité à exécuter le script qui crée les boîtes aux lettres de test et les utilisateurs de test lors de l'exécution de la cmdlet Test-OwaConnectivity.
Si le serveur hébergeant la boîte aux lettres de test n'est pas disponible, la cmdlet Test-OWAConnectivity renverra une erreur qui risque de ne pas identifier clairement le problème. Pour éviter cela, vérifiez que le serveur hébergeant la boîte aux lettres de test est en cours d'exécution et que la boîte aux lettres est disponible avant d'exécuter la cmdlet Test-OWAConnectivity.
Si vous exécutez la cmdlet Test-OwaConnectivity sur un serveur d'accès au client sans utiliser le paramètre ClientAccessServer ou le paramètre URL, la cmdlet teste le serveur sur lequel vous l'exécutez. Pour tester un serveur d'accès au client, utilisez le paramètre ClientAccessServer.
Pour exécuter la cmdlet Test-OwaConnectivity pour tester la connectivité Outlook Web Access de l'ensemble des répertoires virtuels Exchange 2007 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.
Pour tester une adresse URL unique, exécutez Test-OwaConnectivity à l'aide du paramètre URL et des informations d'identification d'une boîte aux lettres Exchange 2007 existante. Si l'adresse URL se situe derrière un dispositif d'équilibrage de charge, il est impossible de prédire quel serveur d'accès au client la cmdlet va tester. Puisque des informations d'identification sont requises en cas d'utilisation du paramètre URL, vous pouvez utiliser un compte quelconque pour exécuter Test-OwaConnectivity en cas d'utilisation du paramètre URL.
Si la cmdlet rencontre un répertoire virtuel ne requérant pas le protocole SSL (Secure Sockets Layer), elle ignore ce répertoire à moins que vous n'utilisiez le paramètre AllowUnsecureAccess. Si vous utilisez le paramètre AllowUnsecureAccess, les communications entre les serveurs ont lieu en texte clair pour le test.
Vous pouvez exécuter la cmdlet Test-OwaConnectivity en tant que tâche interactive ponctuelle ou en tant que tâche planifiée sous le contrôle de Microsoft Operations Manager (MOM). Pour exécuter la cmdlet Test-OwaConnectivity comme tâche MOM, l'environnement de test du serveur d'accès au client doit être disponible sur les serveurs de boîtes aux lettres que la cmdlet doit tester.
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
AllowUnsecureAccess |
Facultatif |
System.Management.Automation.SwitchParameter |
S'il est inclus, ce paramètre permet de tester des répertoires virtuels ne requérant pas l'utilisation du protocole SSL. Si ce paramètre n'est pas inclus, la tâche ignore les répertoires virtuels ne nécessitant pas l'utilisation du protocole SSL et une erreur est générée. |
ClientAccessServer |
Facultatif |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Ce paramètre spécifie le nom du serveur d'accès au client à tester. Si ce paramètre est inclus, tous les répertoires virtuels Exchange 2007 Outlook Web Access sur le serveur d'accès au client sont testés sur tous les serveurs de boîtes aux lettres Exchange 2007 dans le site Active Directory local. Les répertoires virtuels Microsoft Exchange 2000 Server et Microsoft Exchange Server 2003 ne sont pas testés. Les boîtes aux lettres ne se trouvant pas sur des serveurs de boîtes aux lettres Exchange 2007 ne sont pas testées. 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. |
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 l'exécution de la cmdlet de diagnostic Test-OwaConnectivity. 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. Plus précisément, elle permet d'exécuter une version moins intensive de la cmdlet. |
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. 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. |
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é. |
Site |
Facultatif |
Microsoft.Exchange.Configuration.Tasks.AdSiteIdParameter |
Le paramètre Site permet de spécifier le site Active Directory. |
TestType |
Facultatif |
Microsoft.Exchange.Monitoring.OwaConnectivityTestType |
Ce paramètre détermine si la cmdlet teste des adresses URL internes ou externes. Les valeurs valide sont Internal et External. Ce paramètre ne peut pas être utilisé avec le paramètre URL. Si aucun des paramètres TestType ou URL n'est spécifié, la valeur par défaut est TestType:Internal |
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 ne sont pas signalés. Cela est utile pour tester des adresses URL internes car IIS (Internet Information Services) ne prend pas en charge l'affectation de plusieurs certificats pour un répertoire virtuel unique. Si un répertoire contient plusieurs adresses URL pour l'accès Internet et externe et dispose d'un certificat, ce dernier est généralement destiné à l'adresse URL externe. Ce paramètre permet à la tâche de contrôler une adresse URL interne sans générer d'erreur lors que le certificat ne correspond pas à l'adresse URL. |
URL |
Facultatif |
System.String |
Ce paramètre spécifie l'adresse URL Outlook Web Access à tester. En cas d'utilisation de ce paramètre, seule l'adresse URL spécifiée est testée. N'utilisez pas le paramètre URL avec le paramètre ClientAccessServer. Vous ne pouvez pas utiliser le paramètre URL avec le paramètre TestType. |
VirtualDirectoryName |
Facultatif |
System.String |
Ce paramètre spécifie le nom du répertoire virtuel à tester sur un serveur d'accès au client particulier. Si ce paramètre n'est pas inclus, tous les répertoires virtuels d'Outlook Web Access prenant en charge les boîtes aux lettres Exchange 2007 sont testés. |
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 |
---|---|
|
|
Exceptions
Exceptions | Description |
---|---|
|
|
Exemple
Le premier exemple de code teste la connectivité de l'adresse URL https://mail.contoso.com/owa à l'aide des informations d'identification de l'utilisateur contoso\kweku.
Le second exemple de code teste la connectivité d'un serveur d'accès au client spécifique nommé Contoso12 et teste tous les répertoires virtuels d'Outlook Web Access qui prennent en charge des boîtes aux lettres Exchange 2007, y compris les répertoires virtuels ne requérant pas l'utilisation du protocole SSL.
Test-OwaConnectivity -URL:https://mail.contoso.com/owa -MailboxCredential:(get-credential contoso\kweku)
Test-OwaConnectivity -ClientAccessServer:Contoso12 -AllowUnsecureAccess