Test-MapiConnectivity

 

S’applique à :Exchange Online, Exchange Server 2016

Dernière rubrique modifiée :2016-03-31

Cette cmdlet est disponible dans Exchange Server 2016 sur site et dans le service en nuage. 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 SyntaxeSyntaxe de cmdlet Exchange.

Test-MAPIConnectivity [-IncludePassive <SwitchParameter>] [-Server <ServerIdParameter>] <COMMON PARAMETERS>

Test-MAPIConnectivity -Database <DatabaseIdParameter> [-CopyOnServer <ServerIdParameter>] <COMMON PARAMETERS>

Test-MAPIConnectivity -Identity <GeneralMailboxOrMailUserIdParameter> [-Archive <SwitchParameter>] [-CopyOnServer <ServerIdParameter>] <COMMON PARAMETERS>

COMMON PARAMETERS: [-ActiveDirectoryTimeout <Int32>] [-AllConnectionsTimeout <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-PerConnectionTimeout <Int32>] [-WhatIf [<SwitchParameter>]]

Le premier exemple teste la connectivité au serveur Server01.

Test-MapiConnectivity -Server "Server01"

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.

Test-MapiConnectivity -Identity "midwest\john"

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

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, 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 voir les autorisations qui vous sont nécessaires, voir l'entrée « Connectivité MAPI » dans la rubrique Autorisations des destinataires.

 

Paramètre Obligatoire Type Description

Database

Obligatoire

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

Ce paramètre est disponible uniquement dans Exchange 2016 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. 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.GeneralMailboxOrMailUserIdParameter

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

  • 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

Ce paramètre est disponible uniquement dans Exchange 2016 sur site.

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

Ce paramètre est disponible uniquement dans Exchange 2016 sur site.

Le paramètre AllConnectionsTimeout 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.

Archive

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Archive indique si le test de la connectivité MAPI est effectué sur l'archive personnelle associée à la boîte aux lettres spécifiée. Si vous ne spécifiez pas ce paramètre, seule la boîte aux lettres principale est testée.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Confirm 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 cmdlets destructives (par exemple, les cmdlets Remove-*) ont une pause intégrée qui vous oblige à confirmer la commande avant de poursuivre. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.

  • La plupart des autres cmdlets (par exemple, les cmdlets 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.

CopyOnServer

Facultatif

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Ce paramètre est disponible uniquement dans Exchange 2016 sur site.

Le paramètre CopyOnServer est utilisé pour tester la connectivité MAPI à une copie de base de données spécifique sur les serveurs spécifiés à l’aide du paramètre Server.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre est disponible uniquement dans Exchange 2016 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.

IncludePassive

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre est disponible uniquement dans Exchange 2016 sur site.

Sans le paramètre IncludePassive, la cmdlet teste la connectivité MAPI à partir de copies de bases de données actives uniquement. L’utilisation du paramètre IncludePassive vous permet de faire en sorte que la cmdlet teste la connectivité MAPI à partir de toutes les copies de bases de données actives et passives.

MonitoringContext

Facultatif

System.Boolean

Ce paramètre est disponible uniquement dans Exchange 2016 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 pour ce paramètre sont $true ou $false. La valeur par défaut est $false. Si vous spécifiez la valeur $true, les événements de contrôle et les compteurs de performance sont inclus dans les résultats de commande. En général, vous devez inclure les événements de contrôle et les compteurs de performance dans les résultats lorsque la sortie est transmise à MicrosoftSystem Center Operations Manager (SCOM).

PerConnectionTimeout

Facultatif

System.Int32

Ce paramètre est disponible uniquement dans Exchange 2016 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.

Server

Facultatif

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Ce paramètre est disponible uniquement dans Exchange 2016 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é.

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

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

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.

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.

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.

 
Afficher: