Test-AssistantHealth

 

S’applique à :Exchange Server 2016

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

Cette cmdlet est disponible uniquement dans Exchange Server 2016 sur site.

Utilisez la cmdlet Test-AssistantHealth pour vérifier l’intégrité du service Assistants de boîte aux lettres Microsoft Exchange (MSExchangeMailboxAssistants), résoudre les problèmes d’intégrité et connaître l’état de l’action de diagnostic ou de récupération.

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

Test-AssistantHealth [-IncludeCrashDump <SwitchParameter>] [-MaxProcessingTimeInMinutes <UInt32>] [-MonitoringContext <SwitchParameter>] [-ResolveProblems <SwitchParameter>] [-ServerName <ServerIdParameter>] [-WatermarkBehindWarningThreholdInMinutes <UInt32>] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Cet exemple détecte et répare l’intégrité de l’Assistant de boîte aux lettres sur MBXSVR01, inclut les informations d’erreur et met en forme la sortie vers une liste.

Test-AssistantHealth -ServerName MBXSVR01 -IncludeCrashDump -ResolveProblems | Format-List

Cet exemple détecte l’intégrité de l’assistant de boîte aux lettres sur le serveur de boîtes aux lettres local. Le paramètre MaxProcessingTimeInMinutes spécifie 30 minutes comme durée maximale pendant laquelle le service est autorisé à traiter un événement sans répondre, puis met en forme la sortie vers une liste.

Test-AssistantHealth -MaxProcessingTimeInMinutes 30 | Format-List

Le service Assistants de boîte aux lettres s’exécute sur tous les serveurs sur lesquels le rôle serveur de boîtes aux lettres est installé. Ce service est responsable de la planification et de la répartition des différents assistants qui s’assurent que les boîtes aux lettres fonctionnent correctement.

Par défaut, lorsque vous exécutez cette cmdlet, elle renvoie l’RunspaceId, les événements et les compteurs de performance dans un format tableau.

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 entrée « Assistants de boîte aux lettres » dans la rubrique Autorisations des destinataires.

 

Paramètre Obligatoire Type Description

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.

IncludeCrashDump

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre IncludeCrashDump indique que la commande doit prendre un rapport d’erreurs avant de prendre n’importe quelle action de récupération. Ce paramètre doit être uniquement utilisé s’il est exécuté à partir d’un ordinateur local. Si vous utilisez le paramètre lorsque vous êtes connecté à distance, la commande échoue.

La valeur par défaut de ce paramètre est $false.

Vous n’avez pas besoin de spécifier une valeur avec ce paramètre.

MaxProcessingTimeInMinutes

Facultatif

System.UInt32

Le paramètre MaxProcessingTimeInMinutes spécifie la durée maximale pendant laquelle le service MSExchangeMailboxAssistants est autorisé à traiter un événement sans répondre. Vous pouvez spécifier une valeur comprise entre 1 et 3 600 minutes. La valeur par défaut est 15 minutes.

MonitoringContext

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur MonitoringContext inclut les événements de contrôle associés et les compteurs de performance dans les résultats. En règle générale, vous incluez 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). Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

ResolveProblems

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre ResolveProblems indique que si la commande détecte un problème, elle doit tenter de le résoudre. Cette commande tente de résoudre les problèmes suivants :

  • Démarre le service Assistants de boîte aux lettres s’il n’est pas en cours d’exécution.

  • Redémarre le service Assistants de boîte aux lettres s’il détecte que le service est interrompu ou bloqué pendant plus de 15 minutes.

Vous n’avez pas besoin de spécifier une valeur avec ce paramètre.

ServerName

Facultatif

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Le paramètre ServerName spécifie l’identité du serveur de boîtes aux lettres sur lequel réside l’assistant de boîte aux lettres qui est testé.

Si ce paramètre n’est pas spécifié, la commande s’exécute sur le serveur local. Si le serveur local n’est pas un serveur de boîtes aux lettres, la commande échoue.

WatermarkBehindWarningThreholdInMinutes

Facultatif

System.UInt32

Le paramètre WatermarkBehindWarningThreholdInMinutes indique le seuil à ne pas dépasser pour l’âge de filigrane. Les filigranes d’événements indiquent l’heure du dernier événement correctement traité par un assistant. Un filigrane d’événement qui n’a pas été mis à jour depuis longtemps peut indiquer un problème. Pour chaque assistant de boîte aux lettres, la cmdlet Test-AssistantHealth compare l’heure actuelle à l’horodatage du dernier filigrane d’événement pour déterminer son âge. Si l’âge excède la valeur définie par le paramètre WatermarkBehindWarningThreholdInMinutes, un avertissement est généré.

Vous pouvez spécifier une valeur comprise entre 1 et 10 080 minutes. La valeur par défaut est 60 minutes.

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: