Test-MapiConnectivity

  • Article

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2007-07-05

La cmdlet Test-MapiConnectivity permet de vérifier les fonctionnalités du serveur en se connectant à la boîte aux lettres que vous spécifiez. Si vous ne spécifiez aucune boîte aux lettres, la cmdlet se connecte à la boîte aux lettres système de la base de données spécifiée.

Syntaxe

Test-MAPIConnectivity [-ActiveDirectoryTimeout <Int32>] [-AllConnectionsTimeout <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-PerConnectionTimeout <Int32>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Test-MAPIConnectivity -Database <DatabaseIdParameter> [-ActiveDirectoryTimeout <Int32>] [-AllConnectionsTimeout <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-PerConnectionTimeout <Int32>] [-WhatIf [<SwitchParameter>]]

Test-MAPIConnectivity -Identity <MailboxIdParameter> [-ActiveDirectoryTimeout <Int32>] [-AllConnectionsTimeout <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-PerConnectionTimeout <Int32>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Pour exécuter la cmdlet Test-MapiConnectivity, 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 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.

La cmdlet Test-MapiConnectivity permet de vérifier les fonctionnalités du serveur. Cette cmdlet se connecte à la boîte aux lettres que vous spécifiez ou à SystemMailbox si vous ne spécifiez pas le paramètre Identity et extrait la liste des éléments figurant dans la boîte de réception. Une ouverture de session sur la boîte aux lettres teste deux protocoles critiques utilisés lors de la connexion d'un client à un serveur de boîtes aux lettres : MAPI et LDAP. Pendant l'authentification, la cmdlet Test-MapiConnectivity vérifie de façon indirecte que le serveur MAPI, la banque d'informations Exchange et DSAccess (Directory Service Access) fonctionnent.

La cmdlet se connecte à la boîte aux lettres spécifiée à l’aide des informations d'identification du compte avec lequel vous êtes connecté sur l'ordinateur local. Une fois l'authentification réussie, la cmdlet Test-MapiConnectivity accède à la boîte aux lettres afin de vérifier que la base de données fonctionne. En cas de connexion effective à une boîte aux lettres, la cmdlet détermine également le délai requis par la tentative de connexion.

Vous pouvez utiliser trois paramètres distincts avec la commande : Database, Identity et Server.

  • Le paramètre Database prend l'identité d'une base de données et teste la capacité de connexion à la boîte aux lettres système sur la base de données spécifiée.

  • Le paramètre Identity prend l'identité d'une boîte aux lettres et teste la capacité de connexion à une boîte aux lettres spécifique.

  • Le paramètre Server prend l'identité d'un serveur et teste la capacité de connexion à chaque boîte aux lettres système sur le serveur spécifié.

Paramètres

Paramètre Obligatoire Type Description

Database

Obligatoire

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

Le paramètre Database spécifie la base de données sur laquelle tester la connectivité à la boîte aux lettres système. Si vous ne spécifiez pas ce paramètre ou le paramètre Identity, la commande teste la boîte aux lettres système dans chaque base de données du serveur spécifié ou sur le serveur local si vous ne spécifiez pas le paramètre Server.

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Le paramètre Identity spécifie une boîte aux lettres à tester. Vous pouvez utiliser les valeurs suivantes :

  • GUID

  • Nom unique

  • Domaine\Compte

  • Nom d'utilisateur principal (UPN)

  • Nom unique Exchange hérité

  • Adresse SMTP (Simple Mail Transfer Protocol)

  • Alias

  • Ce paramètre accepte l'entrée en pipeline à partir de la cmdlet Get-Mailbox ou Get-Recipient. Si un objet est canalisé à partir de la cmdlet Get-Mailbox ou Get-Recipient, ce paramètre n'est pas requis.

  • Si vous ne spécifiez pas ce paramètre, la cmdlet teste la boîte aux lettres système dans la base de données que vous spécifiez.

ActiveDirectoryTimeout

Facultatif

System.Int32

Le paramètre ActiveDirectoryTimeout spécifie la durée, en secondes, autorisée pour l'exécution de chaque opération Active Directory avant l'interruption de l'opération. La valeur par défaut est 15 secondes.

AllConnectionsTimeout

Facultatif

System.Int32

Le paramètre AllConnectionTimeout spécifie la durée, en secondes, autorisée pour l'achèvement de toutes les connexions avant l'interruption de la cmdlet. Le décompte du délai d’attente ne commence pas tant que toutes les informations nécessaires à l’exécution des connexions ne sont pas collectées à partir d’Active Directory. La valeur par défaut est 90 secondes.

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

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

MonitoringContext

Facultatif

System.Boolean

Le paramètre MonitoringContext indique si les résultats de la commande doivent inclure la surveillance des événements et des compteurs de performance. Les valeurs possibles pour ce paramètre sont $true et $false. Si vous spécifiez $true, les résultats incluent la surveillance des événements et des compteurs de performance en plus des informations sur la transaction MAPI.

PerConnectionTimeout

Facultatif

System.Int32

Le paramètre PerConnectionTimeout spécifie la durée, en secondes, autorisée pour l'exécution de chaque connexion avant que la connexion ne soit expirée. La valeur par défaut est 10 secondes.

Server

Facultatif

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Le paramètre Server spécifie le serveur sur lequel vous allez tester la connectivité MAPI. La commande teste la connectivité MAPI vers chaque boîte aux lettres système sur le serveur spécifié.

Si vous ne spécifiez pas ce paramètre, la cmdlet teste la boîte aux lettres sur le serveur local.

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 teste la connectivité vers le serveur Server01.

Le deuxième exemple teste la connectivité à une boîte aux lettres, spécifiée à l'aide d'un nom de domaine et un d'un nom d'utilisateur.

Test-MapiConnectivity -Server "Server01"
Test-MapiConnectivity -Identity "midwest\john"