Test-MAPIConnectivity
Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. Certains paramètres peuvent être propres à un environnement ou à un autre.
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.
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-MAPIConnectivity
-Database <DatabaseIdParameter>
[-ActiveDirectoryTimeout <Int32>]
[-AllConnectionsTimeout <Int32>]
[-Confirm]
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-MonitoringContext <Boolean>]
[-PerConnectionTimeout <Int32>]
[-WhatIf]
[<CommonParameters>]Test-MAPIConnectivity
[-Identity] <MailboxIdParameter>
[-ActiveDirectoryTimeout <Int32>]
[-AllConnectionsTimeout <Int32>]
[-Archive]
[-Confirm]
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-MonitoringContext <Boolean>]
[-PerConnectionTimeout <Int32>]
[-WhatIf]
[<CommonParameters>]Test-MAPIConnectivity
[-Server <ServerIdParameter>]
[-ActiveDirectoryTimeout <Int32>]
[-AllConnectionsTimeout <Int32>]
[-Confirm]
[-DomainController <Fqdn>]
[-IncludePassive]
[-MonitoringContext <Boolean>]
[-PerConnectionTimeout <Int32>]
[-WhatIf]
[<CommonParameters>]Description
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 à la boîte aux lettres système 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 les deux protocoles critiques utilisés lors de la connexion d'un client à un serveur de boîtes aux lettres : MAPI et LDAP. Lors de l’authentification, l’applet de commande Test-MapiConnectivity vérifie indirectement que le serveur MAPI, le magasin Exchange et l’accès au service d’annuaire (DSAccess) 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.
Il existe trois paramètres distincts que vous pouvez utiliser avec la commande : Base de données, Identité et Serveur :
- 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é.
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-MapiConnectivity -Server "Server01"Le premier exemple teste la connectivité au serveur Server01.
Exemple 2
Test-MapiConnectivity -Identity "midwest\john"Le deuxième exemple teste la connectivité à une boîte aux lettres, spécifiée par un nom de domaine et un nom d'utilisateur.
Paramètres
-ActiveDirectoryTimeout
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre ActiveDirectoryTimeout spécifie la durée, en secondes, autorisée pour chaque opération Active Directory avant l’expiration de l’opération. La valeur par défaut est 15 secondes.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-AllConnectionsTimeout
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre AllConnectionsTimeout spécifie la durée, en secondes, autorisée pour toutes les connexions avant l’expiration de l’applet de commande. Le compte à rebours du délai d’attente ne commence pas tant que toutes les informations nécessaires à l’exécution des connexions n’ont pas été collectées à partir d’Active Directory. La valeur par défaut est de 90 secondes.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Archive
Le commutateur Archive spécifie s’il faut tester la connectivité MAPI de l’archive personnelle associée à la boîte aux lettres spécifiée. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Si vous n’utilisez pas ce commutateur, seule la boîte aux lettres principale est testée.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-CopyOnServer
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre CopyOnServer spécifie le serveur de boîtes aux lettres qui contient la copie de base de données spécifique à tester. Vous pouvez utiliser n’importe quelle valeur qui identifie uniquement le serveur. Par exemple :
- Nom
- FQDN
- Nom unique
- DN Exchange hérité
Vous ne pouvez utiliser ce paramètre qu’avec le paramètre Serveur, et non avec les paramètres Identifier ou Base de données.
| Type: | ServerIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Database
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre Database spécifie la base de données sur laquelle tester la connectivité à la boîte aux lettres système. Vous pouvez utiliser n’importe quelle valeur qui identifie la base de données de manière unique. Par exemple :
- Nom
- Nom unique (DN)
- GUID
Si vous n’utilisez pas ce paramètre ou le paramètre Identity, la commande teste systemMailbox sur chaque base de données active sur le serveur Exchange (le serveur Exchange local ou le serveur que vous spécifiez avec le paramètre Server).
Vous ne pouvez pas utiliser les paramètres Identity, Database ou Server dans la même commande.
| Type: | DatabaseIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
Ce paramètre est disponible uniquement dans Exchange sur site.
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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Le paramètre Identity spécifie une boîte aux lettres à tester. Vous pouvez utiliser n’importe quelle valeur qui identifie la boîte aux lettres de manière unique. Par exemple :
- Nom
- Alias
- Nom unique
- Nom unique
- Domaine\Nom d’utilisateur
- Adresse e-mail
- GUID
- LegacyExchangeDN
- SamAccountName
- Identifiant utilisateur ou nom d’utilisateur principal (UPN)
Cette applet de commande accepte l’entrée de pipeline à partir de l’applet de commande Get-Mailbox ou Get-Recipient. Si vous dirigez l’identification à partir des applets de commande Get-Mailbox ou Get-Recipient, vous n’avez pas besoin d’utiliser ce paramètre.
Si vous n’utilisez pas ce paramètre, l’applet de commande teste systemMailbox sur la base de données que vous spécifiez.
Vous ne pouvez pas utiliser les paramètres Identity, Database ou Server dans la même commande.
| Type: | MailboxIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-IncludePassive
Ce paramètre est disponible uniquement dans Exchange sur site.
Le commutateur IncludePassive teste la connectivité MAPI à partir de toutes les copies de base de données actives et passives. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Si vous n’utilisez pas ce commutateur, la commande teste uniquement la connectivité MAPI à partir de copies de base de données actives.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MonitoringContext
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre MonitoringContext spécifie s’il faut inclure les événements de contrôle associés et les compteurs de performance dans les résultats. Les valeurs valides sont les suivantes :
- $true : les événements de surveillance et les compteurs de performances sont inclus dans les résultats de la commande. 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).
- $false : les événements de surveillance et les compteurs de performances ne sont pas inclus dans les résultats de la commande. Il s’agit de la valeur par défaut.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-PerConnectionTimeout
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre PerConnectionTimeout spécifie la durée, en secondes, autorisée pour l'exécution de chaque connexion avant l'expiration de la connexion. La valeur par défaut est 10 secondes.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Server
Ce paramètre est disponible uniquement dans Exchange sur site.
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 hébergée dans les bases de données actives du serveur spécifié. Vous pouvez utiliser n’importe quelle valeur qui identifie uniquement le serveur. Par exemple :
- Nom
- FQDN
- Nom unique
- DN Exchange hérité
Si vous ne spécifiez pas ce paramètre, la commande teste la boîte aux lettres sur le serveur local.
Vous ne pouvez pas utiliser les paramètres Identity, Database ou Server dans la même commande.
| Type: | ServerIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
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.