Test-WebServicesConnectivity

 

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-WebServicesConnectivity exécute des opérations de base pour vérifier les fonctionnalités des services Web Exchange sur un ordinateur Microsoft Exchange Server 2007 sur lequel le rôle serveur d'accès au client est installé.

Syntaxe

Test-WebServicesConnectivity [-ClientAccessServer <ServerIdParameter>] [-AllowUnsecureAccess <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-LightMode <SwitchParameter>] [-MailboxCredential <PSCredential>] [-MailboxServer <ServerIdParameter>] [-MonitoringContext <SwitchParameter>] [-ResetTestAccountCredentials <SwitchParameter>] [-Site <AdSiteIdParameter>] [-Timeout <UInt32>] [-TrustAnySSLCertificate <SwitchParameter>] [-UseAutodiscoverForClientAccessServer <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La cmdlet Test-WebServicesConnectivity vous permet de tester la fonctionnalité des services Web Exchange. En cas d'échec du test, un message s'affiche dans l'environnement de ligne de commande Exchange Management Shell.

Pour exécuter la cmdlet Test-WebServicesConnectivity, vous devez utiliser un compte auquel ont été délégués le rôle Administrateur Exchange et le 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 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

AllowUnsecureAccess

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre permet à la cmdlet Test-WebServicesConnectivity de continuer à s’exécuter sur un canal non sécurisé qui ne nécessite pas les services SSL (Secure Sockets Layer).

ClientAccessServer

Facultatif

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Ce paramètre spécifie le serveur d'accès au client à utiliser lorsque la cmdlet Test-WebServicesConnectivity est exécutée.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre suspend le traitement par la commande et vous demande de confirmer les actions que la commande va effectuer 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

Le paramètre DomainController spécifie le contrôleur de domaine à utiliser pour écrire cette modification de configuration dans le service d'annuaire Active Directory. Utilisez le nom de domaine complet (FQDN) du contrôleur de domaine que vous voulez utiliser.

LightMode

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre n'est pas implémenté pour l'exécution de la cmdlet de diagnostic Test-PopConnectivity. L'utilisation de ce paramètre ne modifie pas le comportement de la cmdlet.

Remarque   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 d'une cmdlet.

MailboxCredential

Facultatif

System.Management.Automation.PSCredential

Ce paramètre spécifie la boîte aux lettres à utiliser lorsque la cmdlet Test-WebServicesConnectivity est exécutée.

MailboxServer

Facultatif

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Ce paramètre spécifie l'identité du serveur de boîtes aux lettres Exchange 2007 sur lequel le test est exécuté.

MonitoringContext

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre spécifie si le résultat du test est transmis à Microsoft Operations Manager (MOM). Si ce paramètre est défini sur $true, le résultat du test est transmis à MOM. Si ce paramètre est défini sur $false, le résultat du test s'affiche uniquement dans la ligne de commande.

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.

Timeout

Facultatif

System.UInt32

Le paramètre Timeout spécifie le temps d'attente (en secondes), avant l'achèvement de l'opération de test. La valeur par défaut du paramètre Timeout est 300 secondes. Vous devez spécifier une valeur de délai d'expiration supérieure à 0 secondes. Il est recommandé de toujours configurer ce paramètre avec une valeur minimale de 5 secondes.

TrustAnySSLCertificate

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre permet au test d’utiliser n’importe quel certificat SSL disponible.

UseAutodiscoverForClientAccessServer

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre spécifie si le test doit utiliser le service de découverte automatique pour localiser le serveur d'accès au client.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre 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

L'exemple de code suivant teste les services Web Exchange sur le serveur local d'accès au client et permet d'exécuter une connexion non sécurisée ne requérant pas l'utilisation du protocole SSL dans le cadre du test. Un compte de test par défaut est utilisé.

Test-WebServicesConnectivity -AllowUnsecureAccess