Get-Message

 

S’applique à :Exchange Server 2016

Dernière rubrique modifiée :2015-06-26

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

La cmdlet Get-Message permet d'afficher les détails d'un ou plusieurs messages en file d'attente sur les serveurs de boîte aux lettre ou les serveurs Edge.

Get-Message [-Filter <String>] [-Server <ServerIdParameter>] <COMMON PARAMETERS>
Get-Message [-Identity <MessageIdentity>] <COMMON PARAMETERS>
Get-Message [-Queue <QueueIdentity>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-BookmarkIndex <Int32>] [-BookmarkObject <ExtensibleMessageInfo>] [-IncludeBookmark <$true | $false>] [-IncludeComponentLatencyInfo <SwitchParameter>] [-IncludeRecipientInfo <SwitchParameter>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-SortOrder <QueueViewerSortOrderEntry[]>]

Cet exemple affiche des informations détaillées sur tous les messages en file d'attente sur le serveur local et provenant d'un expéditeur dans le domaine contoso.com.

Get-Message -Filter {FromAddress -like "*@contoso.com"} | Format-List

Cet exemple répertorie tous les messages en file d'attente sur le serveur local, provenant de n'importe quel expéditeur dans le domaine contoso.com et possédant une valeur SCL supérieure à 3.

Get-Message -Filter {FromAddress -like "*@contoso.com" -and SCL -gt 3}

Cet exemple affiche tous les messages en file d'attente sur le serveur Server01. Les résultats sont d'abord triés dans l'ordre croissant des adresses des expéditeurs, puis dans l'ordre décroissant de la taille.

Get-Message -Server Server01.contoso.com -SortOrder: +FromAddress,-Size

Vous pouvez afficher des messages en incluant le nom du serveur dans le paramètre Identity ou le paramètre Queue, ou en incluant le paramètre Server avec une requête de filtre. Les paramètres Identity, Queue et Filter s'excluent mutuellement.

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 « Files d'attente » dans la rubrique Autorisations de flux de messagerie.

 

Paramètre Obligatoire Type Description

BookmarkIndex

Facultatif

System.Int32

Le paramètre BookmarkIndex spécifie la position, dans le jeu de résultats, à partir de laquelle les résultats s’affichent. La valeur de ce paramètre est un index basé sur 1 dans le jeu total des résultats. Il n’est pas possible d’utiliser le paramètre BookmarkIndex avec le paramètre BookmarkObject.

BookmarkObject

Facultatif

Microsoft.Exchange.Data.QueueViewer.ExtensibleMessageInfo

Le paramètre BookmarkObject permet de spécifier l’objet du jeu de résultats où l’affichage dans le jeu de résultats commence. Il n’est pas possible d’utiliser le paramètre BookmarkObject avec le paramètre BookmarkIndex.

Filter

Facultatif

System.String

Le paramètre Filter spécifie un ou plusieurs messages à l'aide de la syntaxe de filtre OPath. Le filtre OPath comprend un nom de propriété de message suivi d'un opérateur de comparaison et d'une valeur, par exemple, {FromAddress -like "*@contoso.com"}. Pour plus d'informations sur les propriétés de message filtrables et les opérateurs de comparaison, consultez les rubriques Propriétés des messages dans les files d’attente et Rechercher des files d’attente et les messages dans les files d’attente dans Exchange Management Shell.

Vous pouvez spécifier plusieurs critères à l'aide de l'opérateur de comparaison and. Les valeurs de propriété qui ne sont pas exprimées sous la forme d'un nombre entier doivent être entrées entre guillemets (« »).

Identity

Facultatif

Microsoft.Exchange.Data.QueueViewer.MessageIdentity

Le paramètre Identity spécifie le message. Une entrée valide pour ce paramètre utilise la syntaxe Server\Queue\MessageInteger ou Queue\MessageInteger ou MessageInteger, par exemple Mailbox01\contoso.com\5 ou 10. Pour plus d’informations sur l’identité de message, consultez la section « Messages identité » dans Rechercher des files d’attente et les messages dans les files d’attente dans Exchange Management Shell.

IncludeBookmark

Facultatif

System.Boolean

Le paramètre IncludeBookmark permet de spécifier l’inclusion ou non d’un objet signet lorsque les résultats de la recherche s’affichent. Le paramètre IncludeBookmark est valide lorsqu’il est utilisé avec les paramètres BookmarkObject ou BookmarkIndex. Si vous ne spécifiez pas de valeur pour le paramètre IncludeBookmark, la valeur par défaut $true est utilisée.

IncludeComponentLatencyInfo

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur IncludeComponentLatencyInfo spécifie si les informations de latence de composant sont incluses dans les propriétés du message. Si vous incluez ce commutateur, les objets de message renvoyés contiendront des mesures de latence pour chaque composant Transport qui a contribué à la latence du serveur local pour chaque message en file d'attente.

IncludeRecipientInfo

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre IncludeRecipientInfo spécifie si les destinataires du message doivent apparaître dans le champ Destinataires. Si vous n'incluez pas le commutateur IncludeRecipientInfo, le champ Destinataires est vide.

Le stockage des résultats d'une commande Get-Message -IncludeRecipientInfo dans une variable vous permet d'afficher des propriétés supplémentaires pour les destinataires du message. La liste suivante décrit les propriétés de destinataires disponibles :

  • Adresse : L'adresse de messagerie électronique du destinataire.

  • Type  Le type du destinataire peut être Externe, Boîte aux lettres ou Groupe de distribution. Le Groupe de distribution est utilisé lorsque la destination est un serveur d'expansion.

  • FinalDestination: DN (nom unique) de l'objet utilisé pour router le message.

  • Status : L'état du destinataire peut être Complete, Ready ou Retry.

  • LastError : Réponse SMTP suite à la dernière tentative de remise ou à un message d'erreur localisé si le message est placé dans une file d'attente inaccessible.

Par exemple, pour stocker les informations du destinataire d'un message dans la file d'attente de remise distante contoso.com dont la valeur MessageIdentity est 1234 dans une variable nommée $x, utilisez la commande suivante :

$x=Get-Message -Identity "contoso.com\1234" -IncludeRecipientInfo

Pour afficher les propriétés étendues des destinataires qui sont dorénavant stockées dans la variable $x, utilisez la commande suivante :

$x.Recipients

Queue

Facultatif

Microsoft.Exchange.Data.QueueViewer.QueueIdentity

Le paramètre Queue permet de spécifier l'identité de la file d'attente contenant les messages que vous voulez afficher. Ce paramètre utilise la syntaxe <Server>\<Queue> ou <Queue>, par exemple, Mailbox01\contoso.com ou Unreachable. Pour plus d'informations sur l'identité de la file d'attente, consultez la section « Identité de file d'attente » de la rubrique Rechercher des files d’attente et les messages dans les files d’attente dans Exchange Management Shell.

Si vous utilisez le paramètre Queue, vous ne pouvez pas utiliser les paramètres Identity, Filter ouServer.

ResultSize

Facultatif

Microsoft.Exchange.Data.Unlimited

Le paramètre ResultSize spécifie le nombre maximal de résultats à renvoyer. Pour retourner toutes les demandes correspondant à la requête, utilisez unlimited comme valeur pour ce paramètre. La valeur par défaut est 1000.

ReturnPageInfo

Facultatif

System.Boolean

Le paramètre ReturnPageInfo est un paramètre masqué. Utilisez-le pour renvoyer des informations sur le nombre total de résultats et l'index du premier objet de la page actuelle. La valeur par défaut est $false.

SearchForward

Facultatif

System.Boolean

Le paramètre SearchForward permet de spécifier le sens de la recherche dans le jeu de résultats. La valeur par défaut est $true. Cette valeur implique que la page des résultats est calculée à partir du début du jeu des résultats ou à partir d'un signet spécifié.

Server

Facultatif

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Le paramètre Server définit le serveur Exchange sur lequel vous souhaitez exécuter cette commande. Vous pouvez utiliser n’importe quelle valeur qui identifie uniquement le serveur. Par exemple :

  • Nom

  • FQDN

  • Nom unique

  • DN Exchange hérité

Si vous n’utilisez pas ce paramètre, la commande est exécutée sur le serveur local.

Vous pouvez utiliser les paramètres Server et Filter dans la même commande. Vous ne pouvez pas utiliser les paramètres Server et Identity dans la même commande.

SortOrder

Facultatif

Microsoft.Exchange.Data.QueueViewerSortOrderEntry[]

Le paramètre SortOrder permet de spécifier un tableau des propriétés de message qui sont utilisées pour contrôler l’ordre de tri du jeu de résultats. Séparez les propriétés par des virgules. Ajoutez un symbole plus (+) au début du nom de propriété pour afficher les résultats dans l’ordre croissant. Ajoutez un symbole moins (-) au début du nom de propriété pour afficher les résultats dans l’ordre décroissant.

Si vous ne spécifiez aucun ordre de tri, le jeu de résultats s'affiche dans l'ordre croissant des valeurs (nombres entiers) de MessageIdentity.

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: