Rechercher des files d’attente et des messages dans des files d’attente dans l’environnement de ligne de commande Exchange Management Shell

Comme dans les versions précédentes d’Exchange, vous pouvez utiliser Exchange Management Shell dans Exchange Server pour afficher des informations sur les files d’attente et les messages, et utiliser ces informations pour prendre des mesures sur les files d’attente et les messages. En règle générale, un Exchange actif contient un grand nombre de files d’attente et de messages à remettre. Il est donc important de comprendre comment identifier les files d’attente ou les messages que vous souhaitez gérer.

Notez que, pour gérer les files d'attente et les messages qu'elles contiennent, vous pouvez également utiliser l'Afficheur des files d'attente disponible dans la boîte à outils Exchange. Toutefois, les applets de commande d’affichage de file d’attente et de message dans Exchange Management Shell prennent en charge davantage de propriétés filtrables et d’options de filtre que la Visionneuse de file d’attente. Pour plus d'informations sur l'Afficheur des files d'attente, consultez la rubrique Afficheur des files d'attente.

N’oubliez pas également qu’il existe des files d’attente sur les serveurs de boîtes aux lettres et les serveurs de transport Edge (le service de transport). Pour plus d’informations sur les files d’attente et les messages dans les files d’attente, consultez Files d’attente et messages dans les files d’attente.

Paramètres de filtrage de file d'attente

Le tableau suivant récapitule les paramètres de filtrage disponibles sur les applets de commande de gestion des files d’attente.

Cmdlet Paramètres de filtrage Comments
Get-Queue Exclude
Filtre
Identity
Include
Server
Vous pouvez utiliser les paramètres Include et Exclude avec les autres paramètres de filtrage dans la même commande.
Vous ne pouvez pas utiliser les paramètres Identity et Filter dans la même commande.
Le paramètre Server spécifie le serveur sur lequel vous souhaitez exécuter la commande. Vous ne pouvez pas utiliser les paramètres Server et Identity dans la même commande, mais vous pouvez utiliser le paramètre Server avec les autres paramètres de filtrage dans la même commande.
Resume-Queue
Retry-Queue
Suspend-Queue
Identity
Filtre
Server
Vous ne pouvez pas utiliser le paramètre Identity avec les autres paramètres de filtrage dans la même commande.
Le paramètre Server spécifie le serveur sur lequel vous souhaitez exécuter la commande. Vous pouvez utiliser les paramètres Serveur et Filtre dans la même commande.
Get-QueueDigest Dag
Filtre
Forest
Server
Site
Vous devez utiliser l’un des paramètres Dag, Site, Serveur ou Forêt , mais vous ne pouvez pas les utiliser ensemble dans la même commande.
Vous pouvez utiliser le paramètre Filter avec n’importe lequel des autres paramètres de filtrage.

Identité de file d'attente

Le paramètre Identity utilise la syntaxede base File d’attente> du serveur<\ ><. En règle générale, cette valeur identifie de manière unique la file d’attente, de sorte que vous ne pouvez pas utiliser d’autres paramètres de filtrage avec le paramètre Identity . L’exception est l’applet de commande Get-Queue , où vous pouvez utiliser les paramètres Include et Exclude avec le paramètre Identity .

Le tableau suivant décrit la syntaxe des paramètres Identity sur les applets de commande de gestion des files d’attente.

Valeur de paramètre d'identité Description
<Server>\<PersistentQueueName> ou <PersistentQueueName> Une file d’attente persistante sur le serveur spécifié ou local.
<PersistentQueueName> est Submission, Unreachableou Poison.
Pour plus d’informations sur les files d’attente persistantes, consultez Types de files d’attente.
<Server>\<NextHopDomain> ou <NextHopDomain> File d’attente de remise sur le serveur spécifié ou local.
<NextHopDomain> est le nom de la file d’attente à partir de la valeur de la propriété NextHopDomain de la file d’attente. Par exemple, l’espace d’adressage d’un connecteur d’envoi, le nom d’un site Active Directory ou le nom d’un DAG. Pour plus d'informations, reportez-vous à NextHopSolutionKey.
<Server>\<QueueInteger> ou <QueueInteger> File d’attente de remise sur le serveur spécifié ou local.
<QueueInteger> est la valeur entière unique affectée à une file d’attente de remise ou à une file d’attente fantôme dans la base de données de file d’attente. Toutefois, vous devez exécuter l’applet de commande Get-Queue pour trouver cette valeur dans les propriétés Identity ou QueueIdentity .
<Server>\Shadow\<QueueInteger> ou Shadow\<QueueInteger> Une file d’attente d’ombre sur le serveur local ou spécifié. Pour plus d’informations sur les files d’attente d’ombre et la redondance des ombres, consultez Redondance des ombres dans Exchange Server.
<Server>\* ou * Toutes les files d’attente sur le serveur spécifié ou local.
Remarque : Identity est un paramètre positionnel, ce qui signifie que vous pouvez spécifier la valeur sans spécifier le -Identity qualificateur. Par exemple, les commandes suivantes produisent le même résultat :
Get-Queue -Identity *
Get-Queue *
Get-Queue

Paramètre de filtre sur les applets de commande de file d’attente

Vous pouvez utiliser le paramètre Filter sur toutes les applets de commande de gestion des files d’attente pour identifier une ou plusieurs files d’attente en fonction des propriétés des files d’attente. Le paramètre Filter crée un filtre OPath avec des opérateurs de comparaison pour limiter la commande aux files d’attente qui répondent aux critères de filtre. Vous pouvez utiliser l’opérateur -and logique pour spécifier plusieurs conditions pour la correspondance. Voici un exemple générique de la syntaxe :

Get-Queue -Filter "<Property1> -<ComparisonOperator> '<Value1>' -and <Property2> -<ComparisonOperator> '<Value2>'..."

Pour obtenir la liste complète des propriétés de file d’attente que vous pouvez utiliser avec le paramètre Filter , consultez Propriétés de la file d’attente.

Pour obtenir la liste des opérateurs de comparaison que vous pouvez utiliser avec le paramètre Filter , consultez la section Opérateurs de comparaison à utiliser lors du filtrage des files d’attente ou des messages dans cette rubrique.

Pour obtenir des exemples de procédures qui utilisent le paramètre Filter pour afficher et gérer les files d’attente, consultez Procédures pour les files d’attente.

Inclure et exclure des paramètres sur Get-Queue

Vous pouvez utiliser les paramètres Include et Exclude sur l’applet de commande Get-Queue par eux-mêmes , avec chaque othe , ou avec les autres paramètres de filtrage pour affiner vos résultats. Par exemple, vous pouvez :

  • Excluez les files d’attente vides.

  • Excluez les files d’attente vers des destinations externes.

  • Incluez les files d’attente qui ont une valeur spécifique DeliveryType.

Les paramètres Include et Exclude utilisent les propriétés de file d’attente suivantes pour filtrer les files d’attente :

Valeur Description Exemple
DeliveryType Inclut ou exclut les files d’attente basées sur la propriété DeliveryType qui définit la façon dont le message sera transmis au tronçon suivant. Les valeurs valides sont décrites dans NextHopSolutionKey.
Vous pouvez spécifier plusieurs valeurs séparées par des virgules.
Retourne toutes les files d’attente de remise sur le serveur local où le tronçon suivant est un connecteur d’envoi hébergé sur le serveur local et configuré pour le routage de l’hôte intelligent.
Get-Queue -Include SmartHostConnectorDelivery
Empty Inclut ou exclut les files d’attente vides. Les files d’attente vides ont la valeur 0 dans la propriété MessageCount . Retourne toutes les files d’attente sur le serveur local qui contiennent des messages.
Get-Queue -Exclude Empty
External Inclut ou exclut les files d’attente qui ont la valeur External dans la propriété NextHopCategory .

Dans les files d'attente externes, le paramètre DeliveryType a toujours l'une des valeurs suivantes :

  • DeliveryAgent
  • DnsConnectorDelivery
  • NonSmtpGatewayDelivery
  • SmartHostConnectorDelivery

Pour plus d'informations, reportez-vous à NextHopSolutionKey.

Retourne toutes les files d’attente internes sur le serveur local.
Get-Queue -Exclude External
Internal Cette valeur inclut ou exclut les files d’attente qui ont la valeur Internal dans la propriété NextHopCategory . Notez qu’un message pour un destinataire externe peut nécessiter plusieurs tronçons internes avant d’atteindre un serveur de passerelle où il est remis en externe. Retourne toutes les files d’attente internes sur le serveur local.
Get-Queue -Include Internal

Notez que vous pouvez dupliquer les fonctionnalités des paramètres Include et Exclude à l’aide du paramètre Filter . Par exemple, les commandes suivantes produisent le même résultat :

  • Get-Queue -Exclude Empty

  • Get-Queue -Filter "MessageCount -gt 0"

Toutefois, comme vous pouvez le voir, la syntaxe des paramètres Include et Exclude est plus simple et plus facile à mémoriser.

Get-QueueDigest

L’applet de commande Get-QueueDigest vous permet d’afficher des informations sur une partie ou la totalité des files d’attente de votre organisation à l’aide d’une seule commande. Plus particulièrement, la cmdlet Get-QueueDigest vous permet d'afficher des informations sur les files d'attente, en fonction de leur emplacement sur des serveurs, dans des DAG, dans des sites Active Directory ou dans la forêt Active Directory toute entière.

Notez que les files d’attente sur un serveur de transport Edge abonné ne sont pas incluses dans les résultats. En outre, Get-QueueDigest est disponible sur un serveur de transport Edge, mais les résultats sont limités aux files d’attente locales sur le serveur de transport Edge.

Remarque

Par défaut, la cmdlet Get-QueueDigest affiche les files d’attente de remise contenant au moins dix messages, et les résultats peuvent dater d’une à deux minutes. Pour obtenir des instructions sur la modification de ces valeurs par défaut, consultez la rubrique Configurer Get-QueueDigest Configurer Get-QueueDigest.

Le tableau suivant décrit les paramètres de filtrage et de tri disponibles sur l’applet de commande Get-QueueDigest .

Paramètre Description
Dag, serveur ou site Ces paramètres s’excluent mutuellement (ne peuvent pas être utilisés dans la même commande) et définissent l’étendue de l’applet de commande. Vous devez spécifier l’un de ces paramètres ou le commutateur De forêt . Généralement, vous utiliserez le nom du serveur, du DAG ou du site Active Directory, mais vous pouvez également utiliser toute valeur identifiant de façon unique le serveur, le DAG ou le site. Vous pouvez spécifier plusieurs serveurs, DAG ou sites séparés par des virgules.
Forest Ce commutateur est requis si vous n’utilisez pas les paramètres Dag, Server ou Site . Avec ce commutateur, vous ne spécifiez aucune valeur. En utilisant ce commutateur, vous obtenez des files d’attente à partir de tous les serveurs de boîtes aux lettres Exchange dans la forêt Active Directory locale. Vous ne pouvez pas utiliser ce commutateur pour afficher les files d’attente dans les forêts Active Directory distantes.
DetailsLevel Normal est la valeur par défaut. Les propriétés suivantes sont retournées dans les résultats :
  • QueueIdentity
  • ServerIdentity
  • MessageCount

Verbose retourne les propriétés supplémentaires suivantes dans les résultats :

  • DeferredMessageCount
  • LockedMessageCount*
  • IncomingRate
  • Taux de sortie
  • Velocity
  • NextHopDomain
  • NextHopCategory
  • NextHopConnector
  • DeliveryType*
  • État
  • RiskLevel*
  • OutboundIPPool*
  • LastError
  • TlsDomain

None omet le nom de la file d’attente dans la colonne Détails dans les résultats.

* Ces propriétés sont réservées à une utilisation interne de Microsoft et ne sont pas utilisées dans les organisations Exchange locales. Pour plus d’informations sur toutes les propriétés de cette liste, consultez Propriétés de la file d’attente.

Filtre Filtrez les files d’attente en fonction des propriétés de file d’attente, comme décrit dans la section Paramètre de filtre sur les applets de commande de file d’attente . Vous pouvez utiliser l’une des propriétés de file d’attente filtrables comme décrit dans la rubrique Propriétés de la file d’attente .
GroupBy Regroupe les résultats de la file d’attente. Vous pouvez grouper les résultats pour l'une des propriétés suivantes :
  • DeliveryType
  • LastError
  • NextHopCategory
  • NextHopDomain
  • NextHopKey
  • État
  • Servername

Par défaut, les résultats sont regroupés par NextHopDomain. Pour plus d’informations sur ces propriétés de file d’attente, consultez Propriétés de la file d’attente.

ResultSize Limite les résultats de la file d’attente à la valeur que vous spécifiez. Les files d’attente sont triées dans l’ordre décroissant en fonction du nombre de messages dans la file d’attente et regroupées par la valeur spécifiée par le paramètre GroupBy . La valeur par défaut est 1000. Cela signifie que, par défaut, la commande affiche les 1 000 premières files d'attente groupées par NextHopDomain, et triées dans l'ordre décroissant du nombre de messages qu'elles contiennent.
Timeout Le paramètre spécifie le nombre de secondes avant l’expiration de l’opération. La valeur par défaut est 00:00:10 ou 10 secondes.

Cet exemple retourne toutes les files d’attente externes non vides sur les serveurs nommés Mailbox01, Mailbox02 et Mailbox03.

Get-QueueDigest -Server Mailbox01,Mailbox02,Mailbox03 -Include External -Exclude Empty

Paramètres de filtrage de message

Le tableau suivant récapitule les paramètres de filtrage disponibles sur les applets de commande de gestion des messages.

Cmdlet Paramètres de filtrage Comments
Get-Message Filtre
Identity
Queue
Server
Vous ne pouvez pas utiliser les paramètres Filtre, Identité ou File d’attente dans la même commande.
Le paramètre Server spécifie le serveur sur lequel vous souhaitez exécuter la commande. Vous pouvez utiliser les paramètres Serveur et Filtre dans la même commande.
Remove-Message
Resume-Message
Suspend-Message
Filtre
Identity
Server
Vous devez utiliser le paramètre Identity ou le paramètre Filter , mais vous ne pouvez pas les utiliser tous les deux dans la même commande.
Le paramètre Server spécifie le serveur sur lequel vous souhaitez exécuter la commande. Vous pouvez utiliser les paramètres Serveur et Filtre dans la même commande.
Redirect-Message Server Cette applet de commande draine les messages actifs de toutes les files d’attente de remise sur le serveur spécifié. Serveur est donc le seul paramètre de filtrage disponible. Pour plus d’informations, consultez Rediriger les messages dans les files d’attente.
Export-Message Identity Ce paramètre n’est pas vraiment un filtre, car il identifie le message de manière unique. Pour identifier plusieurs messages pour cette applet de commande, utilisez Get-Message et dirigez les résultats vers Export-Message. Pour plus d’informations et d’exemples, consultez Exporter des messages à partir de files d’attente.

Identité de message

Le paramètre Identity sur les applets de commande de gestion des messages identifie de façon unique un message dans une ou plusieurs files d’attente, de sorte que vous ne pouvez pas utiliser d’autres paramètres de filtrage de messages. Le paramètre Identity utilise la syntaxe <Server>\<Queue>\<MessageInteger>de base .

Le tableau suivant décrit la syntaxe que vous pouvez utiliser avec le paramètre Identity sur les applets de commande de gestion des messages.

**Valeur du paramètre d’identité Description**
<Server>\<Queue>\<MessageInteger> ou <Queue>\<MessageInteger> Message dans une file d’attente spécifique sur le serveur spécifié ou local.

<Queue> est l’identité de la file d’attente, comme décrit dans la section Identité de la file d’attente :

  • Nom de la file d’attente persistante
  • Nom de la file d’attente de remise
  • Entier de file d’attente
  • Identité de file d’attente d’ombre

<MessageInteger> est la valeur entière unique affectée au message lorsqu’il entre pour la première fois dans la base de données de file d’attente sur le serveur. Si le message est envoyé à plusieurs destinataires nécessitant plusieurs files d'attente, toutes ses copies dans toutes les files d'attente reprises dans la base de données de files d'attente ont la même valeur entière. Toutefois, vous devez exécuter l’applet de commande Get-Message pour trouver cette valeur dans les propriétés Identity ou MessageIdentity .

<Server>\*\<MessageInteger>ou ou *\<MessageInteger><MessageInteger> Toutes les copies du message dans toutes les files d’attente de la base de données de file d’attente sur le serveur spécifié ou local.

Paramètre de filtre sur les applets de commande de message

Vous pouvez utiliser le paramètre Filter avec les applets de commande Get-Message, Remove-Message, Resume-Message et Suspend-Message pour identifier un ou plusieurs messages en fonction des propriétés des messages. Le paramètre Filter crée un filtre OPath avec des opérateurs de comparaison pour limiter la commande aux messages qui répondent aux critères de filtre. Vous pouvez utiliser l’opérateur -and logique pour spécifier plusieurs conditions pour la correspondance. Voici un exemple générique de la syntaxe :

Get-Message -Filter "<Property1> -<ComparisonOperator> '<Value1>' -and <Property2> -<ComparisonOperator> '<Value2>'..."

Pour obtenir la liste complète des propriétés de message que vous pouvez utiliser avec le paramètre Filter , consultez Propriétés du message).

Pour obtenir la liste des opérateurs de comparaison que vous pouvez utiliser avec le paramètre Filter , consultez la section Opérateurs de comparaison à utiliser lors du filtrage des files d’attente ou des messages dans cette rubrique.

Pour obtenir des exemples de procédures qui utilisent le paramètre Filter pour afficher et gérer les messages, consultez Procédures pour les messages dans les files d’attente.

Paramètre de file d'attente

Le paramètre Queue est disponible uniquement sur l’applet de commande Get-Message . Vous pouvez utiliser ce paramètre pour obtenir tous les messages d’une file d’attente spécifique ou tous les messages de plusieurs files d’attente à l’aide du caractère générique (*). Lorsque vous utilisez le paramètre File d’attente , utilisez le format <Server>\<Queue> d’identité de file d’attente comme décrit dans la section Identité de file d’attente de cette rubrique.

Opérations de comparaison à utiliser lors du filtrage de files d'attente ou de messages

Lorsque vous créez une expression de filtre de file d’attente ou de message à l’aide du paramètre Filter , vous devez inclure un opérateur de comparaison pour que la valeur de la propriété corresponde. Les opérateurs de comparaison que vous pouvez utiliser et la façon dont chaque opérateur fonctionne sont décrits dans le tableau suivant. Quel que soit l'opérateur, les valeur comparées ne sont pas sensibles à la casse.

Opérateur Fonction Exemple de code
-eq Correspondance exacte de la valeur spécifiée. Afficher toutes les files d’attente dont l’état est Réessayer :
Get-Queue -Filter "Status -eq 'Retry'"
Afficher tous les messages dont l’état est Réessayer :
Get-Message -Filter "Status -eq 'Retry'"
-ne Ne correspond pas à la valeur spécifiée. Afficher toutes les files d’attente qui n’ont pas l’état Actif :
Get-Queue -Filter "Status -ne 'Active'"
Afficher tous les messages qui n’ont pas l’état Actif :
Get-Message -Filter "Status -ne 'Active'"
-gt Supérieur à l’entier ou à la valeur de date/heure spécifié. Afficher les files d’attente qui contiennent actuellement plus de 1 000 messages :
Get-Queue -Filter "MessageCount -gt 1000"
Afficher les messages dont le nombre de nouvelles tentatives est supérieur à 3 :
Get-Message -Filter "RetryCount -gt 3"
-ge Supérieur ou égal à l’entier ou à la valeur de date/heure spécifiée. Afficher les files d’attente qui contiennent actuellement 1 000 messages ou plus :
Get-Queue -Filter "MessageCount -ge 1000"
Afficher les messages dont le nombre de nouvelles tentatives est de 3 ou plus :
Get-Message -Filter "RetryCount -ge 3"
-lt Inférieur à l’entier ou à la valeur de date/heure spécifié. Afficher les files d’attente qui contiennent actuellement moins de 1 000 messages :
Get-Queue -Filter "MessageCount -lt 1000"
Afficher les messages dont la liste de contrôle de contrôle d’accès est inférieure à 6 :
Get-Message -Filter "SCL -lt 6"
-le Inférieur ou égal à l’entier ou à la valeur de date/heure spécifié. Afficher les files d’attente qui contiennent actuellement 1 000 messages ou moins :
Get-Queue -Filter "MessageCount -le 1000"
Afficher les messages dont la liste de contrôle de contrôle de sécurité est inférieure ou inférieure à 6 :
Get-Message -Filter "SCL -le 6"
-like Contient le texte spécifié. Vous devez inclure le caractère générique (*) dans la chaîne de texte. Afficher les files d’attente qui ont une destination vers n’importe quel domaine SMTP qui se termine par Contoso.com :
Get-Queue -Filter "Identity -like '*contoso.com'"
Afficher les messages dont l’objet contient le texte « prêt sur salaire » :
Get-Message -Filter "Subject -like '*payday loan*'"

Vous pouvez spécifier un filtre qui évalue plusieurs expressions à l’aide de l’opérateur -andlogique . Les files d’attente ou les messages doivent correspondre à toutes les conditions de filtre à inclure dans les résultats.

Cet exemple affiche la liste des files d'attente dont la destination est un domaine SMTP dont le nom de termine par Contoso.com et contenant actuellement plus de 500 messages.

Get-Queue -Filter "Identity -like '*contoso.com*' -and MessageCount -gt 500"

Cet exemple montre comment afficher la liste des messages envoyés à partir d’une adresse e-mail du domaine contoso.com dont la valeur SCL est supérieure à 5.

Get-Message -Filter "FromAddress -like '*Contoso.com*' -and SCL -gt 5"

Paramètres de pagination avancée

Lorsque vous utilisez Exchange Management Shell pour afficher les files d’attente et les messages dans les files d’attente, votre requête récupère une page d’informations à la fois. Les paramètres de pagination avancée contrôlent la taille des résultats et l’ordre dans lequel les résultats sont affichés. Tous les paramètres de pagination avancés sont facultatifs et peuvent être utilisés avec ou sans autres paramètres de filtrage sur les applets de commande Get-Queue et Get-Message . Si vous ne spécifiez aucun paramètre de pagination avancée, la requête renvoie les résultats dans l'ordre d'identité croissant.

Par défaut, lorsque vous spécifiez un ordre de tri, la propriété Identity est toujours incluse et triée dans l’ordre croissant, car les autres propriétés de file d’attente ou de message disponibles ne sont pas uniques.

Vous pouvez utiliser les paramètres BookmarkIndex et BookmarkObject pour marquer une position dans les résultats triés. Si l’objet bookmark n’existe plus lorsque vous récupérez la page de résultats suivante, les résultats commencent par l’élément le plus proche du signet, qui dépend de l’ordre de tri que vous spécifiez.

Les paramètres de pagination avancés sont décrits dans le tableau suivant.

Paramètre Description
BookmarkIndex Spécifie la position dans les résultats où les résultats affichés commencent. La valeur de ce paramètre est un index de base 1 dans le total des résultats. Si la valeur est inférieure ou égale à zéro, la première page de résultats complète est retournée. Si la valeur est définie sur Int.MaxValue, la dernière page complète des résultats est retournée.
Vous ne pouvez pas utiliser ce paramètre avec le paramètre BookmarkObject .
BookmarkObject Spécifie l’objet dans les résultats où les résultats affichés commencent. Si vous spécifiez un objet signet, il est utilisé comme point de départ de la recherche. Les lignes avant ou après cet objet (en fonction de la valeur du paramètre SearchForward ) sont récupérées.
Vous ne pouvez pas utiliser ce paramètre avec le paramètre BookmarkIndex .
IncludeBookmark Spécifie s’il faut inclure l’objet bookmark dans les résultats. Les valeurs valides sont les suivantes :
$true: l’objet bookmark est inclus dans les résultats. Il s’agit de la valeur par défaut.
$false: l’objet bookmark n’est pas inclus dans les résultats. Utilisez cette valeur lorsque vous exécutez une requête pour une taille de résultat limitée, puis spécifiez le dernier élément comme signet pour la requête suivante. Cela empêche l’objet bookmark d’être inclus dans les deux résultats.
ResultSize Spécifie le nombre de résultats à afficher par page. Si aucune valeur n'est indiquée, la taille du résultat par défaut est de 1 000 objets. Exchange limite les résultats à 250 000.
ReturnPageInfo Il s’agit d’un paramètre masqué. Il renvoie 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 Spécifie le sens de la recherche.
Signet spécifié : effectuez une recherche vers l’avant ou vers l’arrière dans les résultats relatifs à l’index ou à l’objet de signet.
Aucun signet spécifié : effectuez une recherche vers l’avant ou vers l’arrière dans les résultats du premier ou du dernier élément des résultats.
Les valeurs valides sont les suivantes :
$true: recherche vers l’avant à partir du premier élément des résultats ou à partir du signet spécifié. S’il n’y a pas de résultats au-delà du signet, la requête retourne la dernière page complète des résultats. Il s’agit de la valeur par défaut.
$false: effectuez une recherche à partir du dernier élément dans les résultats ou à partir du signet spécifié. S’il y a moins d’une page entière de résultats au-delà du signet, la requête retourne la première page complète des résultats.
SortOrder Spécifie les propriétés de message qui contrôlent l’ordre de tri des résultats. L’ordre dans lequel les propriétés sont spécifiées indique un ordre décroissant de précédence (les résultats sont triés par la première propriété, puis ces résultats sont triés par la deuxième propriété et fils activé).
Ce paramètre utilise la syntaxe : <+|-><Property1>,<+|-><Property2>..., où + trie la propriété dans l’ordre croissant et - trie la propriété dans l’ordre décroissant.
Si vous n’utilisez pas ce paramètre, les résultats sont triés par la propriété Identity dans l’ordre croissant.

Cet exemple montre comment utiliser les paramètres de pagination avancés dans une requête. La commande retourne les 500 premiers messages sur le serveur spécifié. Les résultats sont triés d’abord dans l’ordre croissant par adresse de l’expéditeur, puis dans l’ordre décroissant par taille de message.

Get-Message -Server mailbox01.contoso.com -ResultSize 500 -SortOrder +FromAddress,-Size

Cet exemple montre comment renvoyer les 500 premiers messages sur le serveur spécifié dans l’ordre de tri spécifié, définir un objet bookmark, exclure l’objet bookmark des résultats et récupérer les 500 messages suivants dans le même ordre de tri.

  1. Exécutez la commande suivante pour récupérer la première page de résultats.

    $Results=Get-Message -Server mailbox01.contoso.com -ResultSize 500 -SortOrder +FromAddress,-Size
    
  2. Pour définir l’objet bookmark, exécutez la commande suivante pour enregistrer le dernier élément de la première page dans une variable.

    $Temp=$Results[$results.length-1]
    
  3. Pour récupérer les 500 objets suivants sur le serveur spécifié et exclure l’objet bookmark, exécutez la commande suivante.

    Get-Message -Server mailbox01.contoso.com -BookmarkObject:$Temp -IncludeBookmark $false -ResultSize 500 -SortOrder +FromAddress,-Size