Test-OwaConnectivity

Référence

Module:: ExchangePowerShell

S’applique à:: Exchange Server 2010

Cette applet de commande est disponible uniquement dans Exchange Server 2010.

Utilisez l’applet de commande Test-OwaConnectivity pour vérifier que Microsoft Office Outlook Web App s’exécute comme prévu. L’applet de commande Test-OwaConnectivity peut être utilisée pour tester la connectivité d’Outlook Web App pour tous les répertoires virtuels Microsoft Exchange Server 2010 sur un serveur d’accès au client spécifié pour toutes les boîtes aux lettres sur les serveurs exécutant Exchange qui se trouvent dans le même site Active Directory. L’applet de commande Test-OwaConnectivity peut également être utilisée pour tester la connectivité d’une URL Exchange Outlook Web App individuelle.

Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.

Syntax

Test-OwaConnectivity
    [-URL] <String>
    -MailboxCredential <PSCredential>
    [-AllowUnsecureAccess]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-LightMode]
    [-ResetTestAccountCredentials]
    [-Timeout <UInt32>]
    [-TrustAnySSLCertificate]
    [-WhatIf]
    [<CommonParameters>]

Test-OwaConnectivity
    [[-ClientAccessServer] <ServerIdParameter>]
    [-MailboxServer <ServerIdParameter>]
    [-MonitoringContext]
    [-RSTEndpoint <String>]
    [-TestType <OwaConnectivityTestType>]
    [-VirtualDirectoryName <String>]
    [-AllowUnsecureAccess]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-LightMode]
    [-ResetTestAccountCredentials]
    [-Timeout <UInt32>]
    [-TrustAnySSLCertificate]
    [-WhatIf]
    [<CommonParameters>]

Description

L’applet de commande Test-OwaConnectivity teste la connectivité de tous les répertoires virtuels Exchange Outlook Web App sur un serveur d’accès au client ou teste la connectivité d’une URL Exchange Outlook Web App unique.

Pour tester tous les répertoires virtuels Exchange Outlook Web App sur un serveur d’accès au client, il doit y avoir un compte Active Directory de test. Il doit également y avoir une boîte aux lettres de test dans chaque site Active Directory qui héberge des boîtes aux lettres accessibles via les répertoires virtuels testés. Si l’environnement de test n’a pas été créé pendant 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 teste les utilisateurs lorsque vous exécutez l’applet de commande Test-OwaConnectivity.

Si le serveur hébergeant la boîte aux lettres de test n’est pas disponible, l’applet de commande Test-OwaConnectivity retourne une erreur qui peut ne pas identifier clairement le problème. Pour éviter cela, vérifiez que le serveur qui héberge 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 l’applet de commande Test-OwaConnectivity. Pour ce faire, vous pouvez utiliser l’applet de commande Test-MapiConnectivity.

Si vous exécutez l’applet de commande Test-OwaConnectivity sur un serveur d’accès au client sans utiliser le paramètre ClientAccessServer ou le paramètre URL, l’applet de commande teste le serveur sur lequel vous exécutez l’applet de commande. Pour tester un serveur d’accès au client spécifique, utilisez le paramètre ClientAccessServer.

Pour tester une URL unique, exécutez l’applet de commande Test-OwaConnectivity avec le paramètre URL et les informations d’identification d’une boîte aux lettres Exchange existante. Si l’URL se trouve derrière un équilibreur de charge, vous ne pouvez pas prédire quel serveur d’accès au client la commande va tester. Étant donné que les informations d’identification sont requises dans le cadre des paramètres lorsque vous utilisez le paramètre URL, vous pouvez utiliser n’importe quel compte pour exécuter l’applet de commande Test-OwaConnectivity lorsque vous utilisez le paramètre URL.

Si la commande rencontre un répertoire virtuel qui ne nécessite pas ssl (Secure Sockets Layer), la commande ignore ce répertoire, sauf si le paramètre AllowUnsecureAccess est utilisé. Si le paramètre AllowUnsecureAccess est utilisé, les communications entre les serveurs sont envoyées en texte clair aux fins du test.

L’applet de commande Test-OwaConnectivity peut être exécutée en tant que tâche interactive unique ou en tant que tâche planifiée sous Microsoft contrôle System Center Operations Manager 2007. Pour exécuter l’applet de commande Test-OwaConnectivity en tant que tâche System Center Operations Manager 2007, la boîte aux lettres de test d’accès au client doit être disponible sur les serveurs de boîtes aux lettres que l’applet de commande teste.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.

Exemples

Exemple 1

Test-OwaConnectivity -URL:https://mail.contoso.com/owa -MailboxCredential:(get-credential contoso\kweku)

Cet exemple teste la connectivité de l’URL https://mail.contoso.com/owa à l’aide des informations d’identification de l’utilisateur contoso\kweku.

Exemple 2

Test-OwaConnectivity -ClientAccessServer:Contoso12 -AllowUnsecureAccess

Cet exemple teste la connectivité d’un serveur d’accès au client Contoso12 spécifique et teste tous les répertoires virtuels Exchange Outlook Web App qui prennent en charge les boîtes aux lettres Exchange. Il s’agit notamment des répertoires virtuels qui ne nécessitent pas SSL.

Paramètres

-AllowUnsecureAccess

Le commutateur AllowUnsecureAccess spécifie si les répertoires virtuels qui ne nécessitent pas SSL sont testés. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Si vous n’utilisez pas ce commutateur, la commande ignore les répertoires virtuels qui ne nécessitent pas SSL et une erreur est générée.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-ClientAccessServer

Ce paramètre est disponible uniquement dans Exchange Server 2010

Le paramètre ClientAccessServer spécifie le nom du serveur d’accès au client à tester. Si ce paramètre est inclus, tous les répertoires virtuels Exchange Outlook Web App sur le serveur d’accès au client sont testés par rapport à tous les serveurs de boîtes aux lettres Exchange dans le site Active Directory local.

N’utilisez pas ce paramètre avec le paramètre URL.

Type:	ServerIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Confirm

Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

Les applets de commande destructrices (par exemple, les applets de commande Remove-*) ont une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.
La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-DomainController

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : « dc01.contoso.com ».

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-LightMode

Le paramètre LightMode n’est pas implémenté pour cette commande de diagnostic. L’utilisation de ce paramètre ne modifie pas le comportement de la commande.

Ce paramètre est implémenté pour d’autres commandes de diagnostic Exchange où il est utilisé pour exécuter une version moins intensive d’une commande.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MailboxCredential

Le paramètre MailboxCredential spécifie les informations d’identification de boîte aux lettres pour un test d’URL unique.

Une valeur pour ce paramètre nécessite l’applet de commande Get-Credential. Pour interrompre la commande et recevoir une invite à entrer les informations d’identification, utilisez la valeur (Get-Credential). Sinon, avant d’exécuter cette commande, stockez les informations d’identification dans une variable (par exemple, $cred = Get-Credential), puis utilisez le nom de cette variable name ($cred) pour ce paramètre. Pour plus d’informations, voir Get-Credential.

Le paramètre MailboxCredential est requis uniquement lors de l’utilisation du paramètre URL.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MailboxServer

Le paramètre MailboxServer 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 du site Active Directory local sont testés.

Type:	ServerIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MonitoringContext

Le commutateur MonitoringContext inclut les événements de contrôle associés et les compteurs de performance dans les résultats. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

En règle générale, vous incluez les événements de surveillance et les compteurs de performances dans les résultats lorsque la sortie est passée à Microsoft System Center Operations Manager (SCOM).

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-ResetTestAccountCredentials

Le commutateur ResetTestAccountCredentials réinitialise le mot de passe du compte de test utilisé pour exécuter cette commande. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Le mot de passe du compte de test est généralement redéfini tous les sept jours. Ce commutateur permet de forcer une réinitialisation du mot de passe à chaque fois que cela est nécessaire pour des raisons de sécurité.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RSTEndpoint

Ce paramètre est réservé à l’usage interne chez Microsoft.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-TestType

Le paramètre TestType spécifie si la commande doit vérifier les URL internes ou externes. Les valeurs sont Internal et External. Vous ne pouvez pas utiliser ce paramètre avec le paramètre URL. Lorsque ni le paramètre TestType ni le paramètre URL n’est spécifié, la valeur par défaut est TestType:Internal.

Type:	OwaConnectivityTestType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Timeout

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 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.

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-TrustAnySSLCertificate

Le commutateur TrustAnySSLCertificate permet à Exchange d’accepter des certificats provenant d’autorités de certification non approuvées. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Le commutateur TrustAnySSLCertificate spécifie s’il faut ignorer les échecs de validation de certificat SSL (Secure Sockets Layers). Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-URL

Le paramètre URL spécifie l’URL à tester. Ce paramètre est requis uniquement lorsque vous souhaitez tester une URL Outlook Web App unique.

Si ce paramètre est utilisé, le paramètre MailboxCredential est également requis.

Vous ne pouvez pas utiliser le paramètre URL avec les paramètres TestType ou ClientAccessServer.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-VirtualDirectoryName

Le paramètre VirtualDirectoryName 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 Exchange Outlook Web App qui prennent en charge les boîtes aux lettres Exchange sont testés.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-WhatIf

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

Entrées

Input types

Pour visualiser les types d'entrées acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type d'entrée pour une cmdlet est vide, la cmdlet n'accepte pas les données d'entrée.

Sorties

Output types

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.