Rechercher des files d’attente et des messages dans les files d’attente dans Exchange Management ShellFind queues and messages in queues in the Exchange Management Shell

Résumé: en savoir plus sur l’identité, le filtrage et la sortie de la commande de files d’attente et les messages en files d’attente dans Exchange Management Shell dans Exchange 2016.Summary: Learn about identity, filtering, and command output for queues and messages in queues in the Exchange Management Shell in Exchange 2016.

Comme dans les versions précédentes d’Exchange, vous pouvez utiliser l’environnement Exchange Management Shell dans Exchange Server 2016 pour afficher des informations sur les files d’attente et les messages et utiliser ces informations pour effectuer une action sur les messages et les files d’attente. En règle générale, un échange actif contienne un grand nombre de files d’attente et de messages, il est important de comprendre comment identifier les files d’attente ou les messages que vous souhaitez gérer.As in previous versions of Exchange, you can use the Exchange Management Shell in Exchange Server 2016 to view information about queues and messages, and use that information to take action on queues and messages. Typically, an active Exchange contains a large number of queues and messages to be delivered, so it's important to understand how to identify the queues or messages that you want to manage.

Notez que vous pouvez également utiliser la visionneuse de file d’attente dans la boîte à outils Exchange pour gérer les files d’attente et les messages en files d’attente. Toutefois, la file d’attente et le message Affichage des applets de commande dans Exchange Management Shell prend en charge plusieurs propriétés filtrables et des options de filtrage à l’Afficheur des files d’attente. Pour plus d’informations sur l’utilisation de la visionneuse de file d’attente, voir Afficheur des files d’attente.Note that you can also use Queue Viewer in the Exchange Toolbox to manage queues and messages in queues. However, the queue and message viewing cmdlets in the Exchange Management Shell support more filterable properties and filter options than Queue Viewer. For more information about using Queue Viewer, see Queue Viewer.

N’oubliez pas également que les files d’attente existent 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 en files d’attente, voir files d’attente et les messages en files d’attente.Also remember that queues exist on Mailbox servers and Edge Transport servers (the Transport service). For more information about queues and messages in queues, see Queues and messages in queues.

Paramètres de filtrage de file d'attenteQueue filtering parameters

Le tableau suivant récapitule les paramètres de filtrage sont disponibles sur les applets de commande de gestion de file d’attente.The following table summarizes the filtering parameters that are available on the queue management cmdlets.

CmdletCmdlet Paramètres de filtrageFiltering parameters CommentaireComments
Get-QueueGet-Queue
ExcludeExclude
FilterFilter
IdentitéIdentity
IncludeInclude
ServeurServer
Vous pouvez utiliser les paramètres Include et Exclude avec les autres paramètres de filtrage dans la même commande.You can use the Include and Exclude parameters with the other filtering parameters in the same command.
Vous ne pouvez pas utiliser les paramètres Identity et Filter dans la même commande.You can't use the Identity and Filter parameters in the same command.
Le paramètre Server Spécifie le serveur où 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.The Server parameter specifies the server where you want to run the command. You can't use the Server and Identity parameters in the same command, but you can use the Server parameter with the other filtering parameters in the same command.
Resume-QueueResume-Queue
Retry-QueueRetry-Queue
Suspend-QueueSuspend-Queue
IdentityIdentity
FilterFilter
ServeurServer
Vous ne pouvez pas utiliser le paramètre Identity avec les autres paramètres de filtrage dans la même commande.You can't use the Identity parameter with the other filtering parameters in the same command.
Le paramètre Server Spécifie le serveur où vous souhaitez exécuter la commande. Vous pouvez utiliser les paramètres de serveur et de filtre dans la même commande.The Server parameter specifies the server where you want to run the command. You can use the Server and Filter parameters in the same command.
Get-QueueDigestGet-QueueDigest
DagDag
FilterFilter
ForestForest
ServeurServer
SiteSite
Vous devez utiliser le Dag, Site, Server, ou paramètres de la forêt , mais vous ne pouvez pas l’utiliser un d’eux ensemble dans la même commande.You need to use one of the Dag, Site, Server, or Forest parameters, but you can't use any of them together in the same command.
Vous pouvez utiliser le paramètre Filter avec un des autres les paramètres de filtrage.You can use the Filter parameter with any of the other filtering parameters.

Identité de file d'attenteQueue identity

Le paramètre Identity utilise la syntaxe de base <Server>\ <file d’attente>. En règle générale, cette valeur identifie la file d’attente, vous ne pouvez pas utiliser les 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 .The Identity parameter uses the basic syntax <Server>\ <Queue>. Typically, this value uniquely identifies the queue, so you can't use other filtering parameters with the Identity parameter. The exception is the Get-Queue cmdlet, where you can use the Include and Exclude parameters with the Identity parameter.

Le tableau suivant explique la syntaxe de paramètre Identity sur les applets de commande de gestion de file d’attente.The following table explains the Identity parameter syntax on the queue management cmdlets.

Valeur de paramètre d'identitéIdentity parameter value DescriptionDescription
<Server>\<PersistentQueueName>ou<PersistentQueueName><Server>\<PersistentQueueName> or <PersistentQueueName>
Une file d’attente permanente sur le serveur local ou spécifié.A persistent queue on the specified or local server.
<PersistentQueueName>est Submission, Unreachable, ou Poison.<PersistentQueueName> is Submission, Unreachable, or Poison.
Pour plus d’informations sur les files d’attente permanentes, voir Types de files d’attente.For more information about persistent queues, see Types of queues.
<Server>\<NextHopDomain>ou<NextHopDomain><Server>\<NextHopDomain> or <NextHopDomain>
Une file d’attente de remise sur le serveur local ou spécifié.A delivery queue on the specified or local server.
<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, voir NextHopSolutionKey.<NextHopDomain> is the name of the queue from the value of the NextHopDomain property of the queue. For example, the address space of a Send connector, the name of an Active Directory site, or the name of a DAG. For more information, see NextHopSolutionKey.
<Server>\<QueueInteger>ou<QueueInteger><Server>\<QueueInteger> or <QueueInteger>
Une file d’attente de remise sur le serveur local ou spécifié.A delivery queue on the specified or local server.
<QueueInteger>est la valeur entière unique qui est affectée à une file d’attente de remise ou d’une file d’attente de clichés instantanés dans la base de données de file d’attente. Toutefois, vous devez exécuter l’applet de commande Get-Queue pour rechercher cette valeur dans les propriétés Identity ou QueueIdentity .<QueueInteger> is the unique integer value that's assigned to a delivery queue or a shadow queue in the queue database. However, you need to run the Get-Queue cmdlet to find this value in the Identity or QueueIdentity properties.
<Server>\Shadow\<QueueInteger>ouShadow\<QueueInteger><Server>\Shadow\<QueueInteger> or Shadow\<QueueInteger>
Une file d’attente de clichés instantanés sur le serveur local ou spécifié. Pour plus d’informations sur les files d’attente de clichés instantanés et de redondance des clichés instantanés, voir l’ombre de la redondance 2016 dans Exchange.A shadow queue on the specified or local server. For more information about shadow queues and shadow redundancy, see Shadow redundancy in Exchange 2016.
<Server>\*ou*<Server>\* or *
Toutes les files d’attente sur le serveur local ou spécifié.All queues on the specified or local server.
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 :Note: Identity is a positional parameter, which means you can specify the value without specifying the -Identity qualifier. For example, the following commands produce the same result:
Get-Queue -Identity *
Get-Queue *
Get-Queue

Paramètre de filtre sur les applets de commande de file d’attenteFilter parameter on queue cmdlets

Vous pouvez utiliser le paramètre Filter sur toutes les applets de commande de gestion de file d’attente pour identifier une ou plusieurs files d’attente basées sur les propriétés des files d’attente. Le paramètre de filtre crée un filtre OPath avec les opérateurs de comparaison pour restreindre la commande qui répondent aux critères de filtrage des files d’attente. Vous pouvez utiliser l’opérateur logique -and pour spécifier plusieurs conditions pour la correspondance. Voici un exemple générique de la syntaxe :You can use the Filter parameter on all of the queue management cmdlets to identify one or more queues based on the properties of the queues. The Filter parameter creates an OPath filter with comparison operators to restrict the command to queues that meet the filter criteria. You can use the logical operator -and to specify multiple conditions for the match. Here's a generic example of the syntax:

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

Pour obtenir une liste complète des propriétés de file d’attente que vous pouvez utiliser avec le paramètre Filter , voir Propriétés de file d’attente.For a complete list of queue properties you can use with the Filter parameter, see Queue properties.

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 de files d’attente ou des messages dans cette rubrique.For a list of comparison operators you can use with the Filter parameter, see the Comparison operators to use when filtering queues or messages section in this topic.

Pour obtenir des exemples de procédures utilisant le paramètre Filter pour afficher et gérer des files d’attente, voir procédures de files d’attente.For examples of procedures that use the Filter parameter to view and manage queues, see Procedures for queues.

Paramètres de file d’attente de Get Include et ExcludeInclude and Exclude parameters on Get-Queue

Vous pouvez utiliser les paramètres Include et Exclude sur l’applet de commande Get-Queue par eux-mêmes avec chaque autre ou les autres paramètres de filtrage pour affiner les résultats. Par exemple, vous pouvez :You can use the Include and Exclude parameters on the Get-Queue cmdlet by themselves, with each othe , or with the other filtering parameters to fine-tune your results. For example, you can:

  • Exclut les files d’attente vides.Exclude empty queues.

  • Exclut les files d’attente vers des destinations externes.Exclude queues to external destinations.

  • Inclure des files d’attente dont le paramètre deliveryType aune valeur spécifique.Include queues that have a specific value of DeliveryType.

Les paramètres Include et Exclude utilisent les propriétés suivantes de la file d’attente des files d’attente filtre :The Include and Exclude parameters use the following queue properties to filter queues:

ValeurValue DescriptionDescription ExempleExample
DeliveryType
Inclut ou exclut les files d’attente en fonction de la propriété DeliveryType qui définit la façon dont le message est transmis au saut suivant. Les valeurs valides sont décrits dans NextHopSolutionKey.Includes or excludes queues based on the DeliveryType property that defines how the message will be transmitted to the next hop. The valid values are described in NextHopSolutionKey.
Vous pouvez spécifier plusieurs valeurs séparées par des virgules.You can specify multiple values separated by commas.
Renvoie toutes les files d’attente de remise sur le serveur local où le tronçon suivant est un connecteur d’envoi est hébergé sur le serveur local et est configuré pour le routage d’hôte actif.Returns all delivery queues on the local server where the next hop is a Send connector that's hosted on the local server and is configured for smart host routing.
Get-Queue -Include SmartHostConnectorDelivery
Empty
Inclut ou exclut les files d’attente vides. Files d’attente vides ont la valeur 0 dans la propriété MessageCount .Includes or excludes empty queues. Empty queues have the value 0 in the MessageCount property.
Renvoie toutes les files d’attente sur le serveur local qui contiennent des messages.Returns all queues on the local server that contain messages.
Get-Queue -Exclude Empty
External
Inclut ou exclut les files d’attente dont la valeur External dans la propriété NextHopCategory .Includes or excludes queues that have the value External in the NextHopCategory property.
Dans les files d'attente externes, le paramètre DeliveryType a toujours l'une des valeurs suivantes :External queues always have one of the following values for DeliveryType:
DeliveryAgent
DnsConnectorDelivery
NonSmtpGatewayDelivery
SmartHostConnectorDelivery
Pour plus d'informations, consultez la section NextHopSolutionKey.For more information, see NextHopSolutionKey.
Renvoie toutes les files d’attente internes sur le serveur local.Returns all internal queues on the local server.
Get-Queue -Exclude External
Internal
Cette valeur inclut ou exclut les files d’attente dont 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.This value includes or excludes queues that have the value Internal in the NextHopCategory property. Note that a message for an external recipient may require multiple internal hops before it reaches a gateway server where it's delivered externally.
Renvoie toutes les files d’attente internes sur le serveur local.Returns all internal queues on the local server.
Get-Queue -Include Internal

Notez que vous pouvez dupliquer la fonctionnalité des paramètres Include et Exclude en utilisant le paramètre de filtre . Par exemple, les commandes suivantes produisent le même résultat :Note that you can duplicate the functionality of the Include and Exclude parameters by using the Filter parameter. For example, the following commands produce the same result:

  • Get-Queue -Exclude Empty

  • Get-Queue -Filter {MessageCount -gt 0}

Toutefois, comme vous pouvez le constater, la syntaxe des paramètres Include et Exclude est simple et facile à mémoriser.However, as you can see, the syntax of the Include and Exclude parameters is simpler and easier to remember.

Get-QueueDigestGet-QueueDigest

L’applet de commande Get-QueueDigest permet d’afficher des informations sur certaines ou toutes les files d’attente de votre organisation à l’aide d’une seule commande. Spécifiquement, l’applet de commande Get-QueueDigest permet de vous permet d’afficher des informations sur les files d’attente en fonction de leur emplacement sur les serveurs, dans le DAG, sites Active Directory ou dans la forêt Active Directory entière.The Get-QueueDigest cmdlet allows you to view information about some or all of the queues in your organization by using a single command. Specifically, the Get-QueueDigest cmdlet allows you to view information about queues based on their location on servers, in DAGs, in Active Directory sites, or in the whole Active Directory forest.

Notez que les files d’attente sur un serveur de Transport Edge abonné ne sont pas inclus 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.Note that queues on a subscribed Edge Transport server aren't included in the results. Also, Get-QueueDigest is available on an Edge Transport server, but the results are restricted to local queues on the Edge Transport server.

Note

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.By default, the Get-QueueDigest cmdlet displays delivery queues that contain ten or more messages, and the results are between one and two minutes old. For instructions on how to change these default values, see Configure Get-QueueDigest.

Le tableau suivant décrit les paramètres de filtrage et de tri qui sont disponibles sur l’applet de commande Get-QueueDigest .The following table describes the filtering and sorting parameters that are available on the Get-QueueDigest cmdlet.

ParamètreParameter DescriptionDescription
DAG, Server_ou _SiteDag, Server, or Site
Ces paramètres s’excluent mutuellement (ne peut pas être utilisé dans la même commande) et définir l’étendue de l’applet de commande. Vous devez spécifier une de ces paramètres ou le commutateur de la forêt . En règle générale, vous utilisez le nom du serveur, le site DAG ou Active Directory, mais vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique le serveur, DAG ou site. Vous pouvez spécifier plusieurs serveurs, DAG ou sites séparés par des virgules.These parameters are mutually exclusive (can't be used in the same command), and set the scope for the cmdlet. You need to specify one of these parameters or the Forest switch. Typically, you would use the name of the server, DAG or Active Directory site, but you can use any value that uniquely identifies the server, DAG, or site. You can specify multiple servers, DAGs, or sites separated by commas.
ForestForest
Ce commutateur est requis si vous n’utilisez pas les paramètres Dag, Server_ou _Site . Vous ne spécifiez aucune valeur avec ce commutateur. À l’aide de ce commutateur, vous obtenez les files d’attente de 2016 Exchange ou boîtes aux lettres de Exchange 2013 tous les serveurs de la forêt Active Directory locale. Vous ne pouvez pas utiliser ce commutateur pour afficher les files d’attente dans des forêts Active Directory à distance.This switch is required if you aren't using the Dag, Server, or Site parameters. You don't specify a value with this switch. By using this switch, you get queues from all Exchange 2016 or Exchange 2013 Mailbox servers in the local Active Directory forest. You can't use this switch to view queues in remote Active Directory forests.
DetailsLevelDetailsLevel
Normalest la valeur par défaut. Les propriétés suivantes sont retournées dans les résultats :Normal is the default value. The following properties are returned in the results:
QueueIdentityQueueIdentity
ServerIdentityServerIdentity
MessageCountMessageCount
VerboseRenvoie les propriétés supplémentaires suivantes dans les résultats :Verbose returns the following additional properties in the results:
DeferredMessageCountDeferredMessageCount
• **LockedMessageCount* **LockedMessageCount\
• **IncomingRate• **IncomingRate
• **OutgoingRate• **OutgoingRate
• **Velocity• **Velocity
• **NextHopDomain• **NextHopDomain
• **NextHopCategory• **NextHopCategory
• **NextHopConnector• **NextHopConnector
• **DeliveryType• **DeliveryType
• **État• **Status*
• **RiskLevel* **RiskLevel\*
• **OutboundIPPool* **OutboundIPPool\
• **LastError• **LastError
• **TlsDomain• **TlsDomain
Noneomet le nom de la file d’attente de la colonne de **Détails* dans les résultats.None omits the queue name from the Details column in the results.
*Ces propriétés sont réservés à un usage interne Microsoft et ne sont pas utilisées dans des organisations Exchange sur site. Pour plus d’informations sur toutes les propriétés dans cette liste, voir Propriétés de file d’attente.* These properties are reserved for internal Microsoft use, and aren't used in on-premises Exchange organizations. For more information about all properties in this list, see Queue properties.
FilterFilter
Filtrer les files d’attente basées sur les propriétés de file d’attente comme décrit dans la section filtre paramètre sur les applets de commande de file d’attente . Vous pouvez utiliser les propriétés filtrables file d’attente comme décrit dans la rubrique Propriétés de file d’attente .Filter queues based on the queue properties as described in the Filter parameter on queue cmdlets section. You can use any of the filterable queue properties as described in the Queue properties topic.
GroupByGroupBy
Regroupe les résultats de la file d’attente. Vous pouvez regrouper les résultats par une des propriétés suivantes :Groups the queue results. You can group the results by one of the following properties:
DeliveryTypeDeliveryType
LastErrorLastError
NextHopCategoryNextHopCategory
NextHopDomainNextHopDomain
NextHopKeyNextHopKey
ÉtatStatus
Nom_serveurServerName
Par défaut, les résultats sont regroupés par NextHopDomain. Pour plus d’informations sur ces propriétés de file d’attente, voir Propriétés de file d’attente.By default, the results are grouped by NextHopDomain. For information about these queue properties, see Queue properties.
ResultSizeResultSize
Limite les résultats de la file d’attente à la valeur que vous spécifiez. Les files d’attente sont triés dans l’ordre en fonction du nombre de messages de la file d’attente et regroupés par la valeur spécifiée par le paramètre GroupBy décroissant. La valeur par défaut est 1000. Cela signifie que par défaut, la commande affiche les files d’attente 1000 supérieur regroupés par NextHopDomainet triés par les files d’attente contenant le plus de messages pour les files d’attente contenant les messages de moins.Limits the queue results to the value you specify. The queues are sorted in descending order based on the number of messages in the queue, and grouped by the value specified by the GroupBy parameter. The default value is 1000. This means that by default, the command displays the top 1000 queues grouped by NextHopDomain, and sorted by the queues containing the most messages to the queues containing the least messages.
TimeoutTimeout
Le paramètre spécifie le nombre de secondes avant l’opération arrive à expiration. La valeur par défaut est 00:00:10 ou 10 secondes.The parameter specifies the number of seconds before the operation times out. The default value is 00:00:10 or 10 seconds.

Cet exemple renvoie toutes les files d’attente externes non vides sur les serveurs nommés Mailbox01, Mailbox02 et Mailbox03.This example returns all non-empty external queues on the servers named Mailbox01, Mailbox02, and Mailbox03.

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

Paramètres de filtrage de messageMessage filtering parameters

Le tableau suivant récapitule les paramètres de filtrage sont disponibles sur les applets de commande de gestion de message.The following table summarizes the filtering parameters that are available on the message management cmdlets.

CmdletCmdlet Paramètres de filtrageFiltering parameters CommentaireComments
Get-MessageGet-Message
FilterFilter
IdentitéIdentity
QueueQueue
ServeurServer
Vous ne pouvez pas utiliser les paramètres de file d’attente , Identity_ou _Filter_dans la même commande.You can't use the _Filter, Identity, or Queue parameters in the same command.
Le paramètre Server Spécifie le serveur où vous souhaitez exécuter la commande. Vous pouvez utiliser les paramètres de serveur et de filtre dans la même commande.The Server parameter specifies the server where you want to run the command. You can use the Server and Filter parameters in the same command.
Remove-MessageRemove-Message
Resume-MessageResume-Message
Suspend-MessageSuspend-Message
FilterFilter
IdentitéIdentity
ServeurServer
Vous devez utiliser le paramètre Identity ou le paramètre Filter , mais vous ne pouvez pas utiliser les deux dans la même commande.You need to use either the Identity parameter or the Filter parameter, but you can't use them both in the same command.
Le paramètre Server Spécifie le serveur où vous souhaitez exécuter la commande. Vous pouvez utiliser les paramètres de serveur et de filtre dans la même commande.The Server parameter specifies the server where you want to run the command. You can use the Server and Filter parameters in the same command.
Redirect-MessageRedirect-Message
ServeurServer
Cette applet de commande draine les messages actifs depuis toutes les files d’attente de remise sur le serveur spécifié, afin que le serveur est le seul paramètre de filtrage n’est disponible. Pour plus d’informations, voir Rediriger les messages en files d’attente.This cmdlet drains active messages from all delivery queues on the specified server, so Server is the only filtering parameter that's available. For more information, see Redirect messages in queues.
Export-MessageExport-Message
IdentityIdentity
Ce paramètre n’est pas réellement un filtre, car il identifie de manière unique le message. Pour identifier plusieurs messages pour cette applet de commande, utilisez Get-Message et rediriger les résultats à Export-Message. Pour plus d’informations et des exemples, voir exporter des messages des files d’attente.This parameter isn't really a filter, because it uniquely identifies the message. To identify multiple messages for this cmdlet, use Get-Message and pipe the results to Export-Message. For more information and examples, see Export messages from queues.

Identité de messageMessage identity

Le paramètre Identity sur les applets de commande de gestion de message identifie de manière unique un message dans une ou plusieurs files d’attente, vous ne pouvez pas utiliser les autres paramètres de filtrage des messages. Le paramètre Identity utilise la syntaxe de base <Server>\<Queue>\<MessageInteger>.The Identity parameter on the message management cmdlets uniquely identifies a message in one or more queues, so you can't use any other message filtering parameters. The Identity parameter uses the basic syntax <Server>\<Queue>\<MessageInteger>.

Le tableau suivant décrit la syntaxe que vous pouvez utiliser avec le paramètre Identity sur les applets de commande de gestion de message.The following table describes the syntax you can use with Identity parameter on the message management cmdlets.

Valeur de paramètre d'identitéIdentity parameter value DescriptionDescription
<Server>\<Queue>\<MessageInteger>ou<Queue>\<MessageInteger><Server>\<Queue>\<MessageInteger> or <Queue>\<MessageInteger>
Un message dans une file d’attente spécifique sur le serveur local ou spécifié.A message in a specific queue on the specified or local server.
<Queue>est l’identité de la file d’attente comme décrit dans la section identité de file d’attente :<Queue> is the identity of the queue as described in the Queue identity section:
Nom de la file d’attente permanentePersistent queue name
Nom de file d’attente de remiseDelivery queue name
Entier de file d’attenteQueue integer
Identité de file d’attente de clichés instantanésShadow queue identity
<MessageInteger>est la valeur entière unique affecté au message lors de la première fois la base de données de file d’attente sur le serveur. Si le message est envoyé à plusieurs destinataires qui nécessitent plusieurs files d’attente, toutes les copies du message dans toutes les files d’attente dans la base de données de file d’attente ont la même valeur entière. Toutefois, vous devez exécuter l’applet de commande Get-Message pour trouver la valeur dans les propriétés Identity ou messageidentity est .<MessageInteger> is the unique integer value that's assigned to the message when it first enters the queue database on the server. If the message is sent to multiple recipients that require multiple queues, all copies of the message in all queues in the queue database have the same integer value. However, you need to run the Get-Message cmdlet to find this value in the Identity or MessageIdentity properties.
<Server>\*\<MessageInteger>ou *\<MessageInteger> ou<MessageInteger><Server>\*\<MessageInteger> or *\<MessageInteger> or <MessageInteger>
Toutes les copies du message dans toutes les files d’attente dans la base de données de file d’attente sur le serveur local ou spécifié.All copies of the message in all queues in the queue database on the specified or local server.

Paramètre de filtre sur les applets de commande de messageFilter parameter on message cmdlets

Vous pouvez utiliser le paramètre Filter avec les applets de commande Get-Message, Remove-Message, Resume-Messageet Suspend-Message pour identifier un ou plusieurs messages basées sur les propriétés des messages. Le paramètre de filtre crée un filtre OPath avec les opérateurs de comparaison pour restreindre la commande aux messages qui répondent aux critères de filtre. Vous pouvez utiliser l’opérateur logique -and pour spécifier plusieurs conditions pour la correspondance. Voici un exemple générique de la syntaxe :You can use the Filter parameter with the Get-Message, Remove-Message, Resume-Message, and Suspend-Message cmdlets to identify one or more messages based on the properties of the messages. The Filter parameter creates an OPath filter with comparison operators to restrict the command to messages that meet the filter criteria. You can use the logical operator -and to specify multiple conditions for the match. Here's a generic example of the syntax:

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

Pour obtenir une liste complète des propriétés de message que vous pouvez utiliser avec le paramètre Filter , voir Propriétés de Message).For a complete list of message properties you can use with the Filter parameter, see Message properties).

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 de files d’attente ou des messages dans cette rubrique.For a list of comparison operators you can use with the Filter parameter, see the Comparison operators to use when filtering queues or messages section in this topic.

Pour obtenir des exemples de procédures utilisant le paramètre Filter pour afficher et gérer des messages, consultez les procédures pour les messages en files d’attente.For examples of procedures that use the Filter parameter to view and manage messages, see Procedures for messages in queues.

Paramètre de file d'attenteQueue parameter

Le paramètre de file d’attente est disponible uniquement sur l’applet de commande Get-Message . Vous pouvez utiliser ce paramètre pour obtenir tous les messages dans 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 de file d’attente , utilisez le format d’identité de file d’attente <Server>\<Queue> comme décrit dans la section d’identité de file d’attente dans cette rubrique.The Queue parameter is available only on the Get-Message cmdlet. You can use this parameter to get all messages in a specific queue, or all messages from multiple queues by using the wildcard character (*). When you use the Queue parameter, use the queue identity format <Server>\<Queue> as described in the Queue identity section in this topic.

Opérations de comparaison à utiliser lors du filtrage de files d'attente ou de messagesComparison operators to use when filtering queues or messages

Lorsque vous créez une expression de filtre de message ou de file d’attente en utilisant le paramètre de filtre , vous devez inclure un opérateur de comparaison pour la valeur de propriété pour faire correspondre. Les opérateurs de comparaison que vous pouvez utiliser et comment les fonctions de chaque opérateur sont décrits dans le tableau suivant. Pour tous les opérateurs, les valeurs comparées ne sont pas respectant la casse.When you create a queue or message filter expression by using the Filter parameter, you need to include an comparison operator for the property value to match. The comparison operators that you can use, and how each operator functions are described in the following table. For all operators, the values compared aren't case sensitive.

OpérateurOperator FonctionFunction Exemple de codeCode example
-eq
Correspondance exacte de la valeur spécifiée.Exact match of the specified value.
Afficher toutes les files d’attente dont l’état est nouvelle tentative :Show all queues that have a status of Retry:
Get-Queue -Filter {Status -eq "Retry"}
Afficher tous les messages dont l’état est nouvelle tentative :Show all messages that have a status of Retry:
Get-Message -Filter {Status -eq "Retry"}
-ne
Ne correspond pas à la valeur spécifiée.Does not match the specified value.
Afficher toutes les files d’attente qui n’ont pas un état est actif :Show all queues that don't have a status of Active:
Get-Queue -Filter {Status -ne "Active"}
Afficher tous les messages qui n’ont pas un état est actif :Show all messages that don't have a status of Active:
Get-Message -Filter {Status -ne "Active"}
-gt
Supérieur à la valeur d’entier ou de date/heure spécifiée.Greater than the specified integer or date/time value.
Afficher les files d’attente contenant actuellement plus de 1 000 messages :Show queues that currently contain more than 1,000 messages:
Get-Queue -Filter {MessageCount -gt 1000}
Afficher les messages qui possèdent un nombre de tentatives est supérieur à 3 :Show messages that currently have a retry count that's more than 3:
Get-Message -Filter {RetryCount -gt 3}
-ge
Supérieure ou égale à la valeur d’entier ou de date/heure spécifiée.Greater than or equal to the specified integer or date/time value.
Afficher les files d’attente contenant actuellement moins de 1 000 messages :Show queues that currently contain 1,000 or more messages:
Get-Queue -Filter {MessageCount -ge 1000}
Afficher les messages qui possèdent un nombre de tentatives est au moins 3 :Show messages that currently have a retry count that's 3 or more:
Get-Message -Filter {RetryCount -ge 3}
-lt
Inférieur à la valeur d’entier ou de date/heure spécifiée.Less than the specified integer or date/time value.
Afficher les files d’attente contenant actuellement moins de 1 000 messages :Show queues that currently contain less than 1,000 messages:
Get-Queue -Filter {MessageCount -lt 1000}
Afficher les messages dont le SCL est inférieur à 6 :Show messages that have an SCL that's less than 6:
Get-Message -Filter {SCL -lt 6}
-le
Inférieur ou égal à la valeur d’entier ou de date/heure spécifiée.Less than or equal to the specified integer or date/time value.
Afficher les files d’attente contenant actuellement moins de 1 000 messages :Show queues that currently contain 1,000 or fewer messages:
Get-Queue -Filter {MessageCount -le 1000}
Afficher les messages dont le SCL est inférieur ou égal à 6 :Show messages that have an SCL that's 6 or less:
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.Contains the specified text. You need to include the wildcard character (*) in the text string.
Afficher les files d’attente dont une destination à n’importe quel domaine SMTP se termine par Contoso.com :Show queues that have a destination to any SMTP domain that ends in Contoso.com:
Get-Queue -Filter {Identity -like "*contoso.com"}
Afficher les messages dont l’objet qui contient le texte « payday loan » :Show messages that have a subject that contains the text "payday loan":
Get-Message -Filter {Subject -like "*payday loan*"}

Vous pouvez spécifier un filtre qui évalue les expressions multiples à l’aide de l’opérateur logique -and. Les files d’attente ou les messages doivent correspondre à toutes les conditions du filtre pour être inclus dans les résultats.You can specify a filter that evaluates multiple expressions by using the logical operator -and. The queues or messages must match all of the filter conditions to be included in the results.

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.This example displays a list of queues that have a destination to any SMTP domain name that ends in Contoso.com and that currently contain more than 500 messages.

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

Cet exemple montre comment afficher une liste de messages envoyés à partir d’une adresse de messagerie dans le domaine contoso.com et possédant une valeur SCL est supérieure à 5.This example displays a list of messages that are sent from any email address in the contoso.com domain that have an SCL value that's greater than 5.

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

Paramètres de pagination avancéeAdvanced paging parameters

Lorsque vous utilisez Exchange Management Shell pour afficher les files d’attente et les messages en 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 les résultats sont affichés dans l’ordre indiqué. Tous les paramètres de pagination avancée sont facultatives 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 pas les paramètres de pagination avancée, la requête renvoie les résultats dans l’ordre croissant d’identité.When you use the Exchange Management Shell to view queues and messages in queues, your query retrieves one page of information at a time. The advanced paging parameters control the size of the results, and the order that the results are displayed in. All advanced paging parameters are optional and can be used with or without other filtering parameters on the Get-Queue and Get-Message cmdlets. If you don't specify any advanced paging parameters, the query returns the results in ascending order of identity.

Par défaut, lorsque vous spécifiez un ordre de tri, la propriété Identity est toujours incluse et triée par ordre croissant, parce que les autres file d’attente ou un message propriétés disponibles ne sont pas uniques.By default, when you specify a sort order, the Identity property is always included and sorted in ascending order, because the other available queue or message properties aren't unique.

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 de la démarrer avec l’élément le plus proche au signet, qui dépend de l’ordre de tri que vous spécifiez.You can use the BookmarkIndex and BookmarkObject parameters to mark a position in the sorted results. If the bookmark object no longer exists when you retrieve the next page of results, the results start with the closest item to the bookmark, which depends on the sort order that you specify.

Les paramètres de pagination avancée sont décrits dans le tableau suivant.The advanced paging parameters are described in the following table.

Paramètres de pagination avancéeAdvanced paging parameters

ParamètreParameter DescriptionDescription
BookmarkIndexBookmarkIndex
Spécifie la position dans les résultats dans laquelle les résultats affichés lancée. La valeur de ce paramètre est un index à base 1 dans les résultats. Si la valeur est inférieure ou égale à zéro, la première page complète de résultats est renvoyée. Si la valeur est définie sur Int.MaxValue, la dernière page complète de résultats est renvoyée.Specifies the position in the results where the displayed results start. The value of this parameter is a 1-based index in the total results. If the value is less than or equal to zero, the first complete page of results is returned. If the value is set to Int.MaxValue, the last complete page of results is returned.
Vous ne pouvez pas utiliser ce paramètre avec le paramètre BookmarkObject .You can't use this parameter with the BookmarkObject parameter.
BookmarkObjectBookmarkObject
Spécifie l’objet dans les résultats dans laquelle les résultats affichés lancée. Si vous spécifiez un objet bookmark, cet objet est utilisé comme point de départ de la recherche. Les lignes avant ou après cet objet (selon la valeur du paramètre SearchForward ) sont récupérées.Specifies the object in the results where the displayed results start. If you specify a bookmark object, that object is used as the point to start the search. The rows before or after that object (depending on the value of the SearchForward parameter) are retrieved.
Vous ne pouvez pas utiliser ce paramètre avec le paramètre BookmarkIndex .You can't use this parameter with the BookmarkIndex parameter.
IncludeBookmarkIncludeBookmark
Spécifie s’il faut inclure l’objet bookmark dans les résultats. Les valeurs valides sont :Specifies whether to include the bookmark object in the results. Valid values are:
$true: L’objet bookmark est inclus dans les résultats. Il s’agit de la valeur par défaut.$true: The bookmark object is included in the results. This is the default value.
$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 des résultats limités, puis spécifiez le dernier élément en tant que le signet de la requête suivante. Ainsi, l’objet bookmark est incluse dans les résultats.$false: The bookmark object isn't included in the results. Use this value when you run a query for a limited result size, and then specify the last item as the bookmark for the next query. This prevents the bookmark object from being included in both results.
ResultSizeResultSize
Spécifie le nombre de résultats à afficher par page. Si vous ne spécifiez aucune valeur, la taille des résultats par défaut de 1 000 objets est utilisée. Exchange limite les résultats à 250 000.Specifies the number of results to display per page. If you don't specify a value, the default result size of 1,000 objects is used. Exchange limits the results to 250,000.
ReturnPageInfoReturnPageInfo
Il s’agit d’un paramètre masqué. Il retourne 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.This is a hidden parameter. It returns information about the total number of results and the index of the first object of the current page. The default value is $false.
SearchForwardSearchForward
Définit le sens de la recherche.Specifies the direction of the search.
Signet spécifié: recherche vers l’avant ou vers l’arrière dans les résultats par rapport à l’index de signet ou l’objet.Bookmark specified: Search forward or backward in the results relative to the bookmark index or object.
Aucun signet ne spécifié: recherche dans les résultats de l’élément première ou dernière dans les résultats.No bookmark specified: Search forward or backward in the results from the first or last item in the results.
Les valeurs valides sont les suivantes :Valid values are:
$true: Rechercher l’occurrence à partir du premier élément dans les résultats ou le signet spécifié. S’il n’y a aucun résultat au-delà du signet, la requête renvoie la dernière page complète des résultats. Il s’agit de la valeur par défaut.$true: Search forward from the first item in the results, or from the specified bookmark. If there are no results beyond the bookmark, the query returns the last full page of results. This is the default value.
$false: Recherche en arrière à partir du dernier élément dans les résultats ou le signet spécifié. Si est inférieure à une page de résultats au-delà du signet complète, la requête renvoie la première page complète des résultats.$false: Search backward from the last item in the results, or from the specified bookmark. If there is less than a full page of results beyond the bookmark, the query returns the first full page of results.
SortOrderSortOrder
Spécifie les propriétés de message qui contrôlent l’ordre de tri des résultats. L’ordre que les propriétés sont spécifiées indique un ordre décroissant de priorité (les résultats sont triés par la propriété premier, puis les résultats sont triés par la propriété deuxième et fils sur).Specifies the message properties that control the sort order of the results. The order that the properties are specified indicates a descending order of precedence (the results are sorted by the first property, then those results are sorted by the second property, and son on).
Ce paramètre utilise la syntaxe : « < +This parameter uses the syntax: `<+

Cet exemple montre comment utiliser les paramètres de pagination avancée dans une requête. La commande retourne les 500 premières messages sur le serveur spécifié. Les résultats sont triés d’abord par ordre croissant en adresse de l’expéditeur, puis, dans l’ordre décroissant par taille de message.This example shows how to use the advanced paging parameters in a query. The command returns the first 500 messages on the specified server. The results are sorted first in ascending order by sender address, and then in descending order by message size.

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

Cet exemple renvoie les 500 premières messages sur le serveur spécifié dans l’ordre de tri spécifié, définit un objet bookmark, exclut les résultats de l’objet bookmark et récupère les 500 messages dans le même ordre de tri.This example returns the first 500 messages on the specified server in the specified sort order, sets a bookmark object, excludes the bookmark object from the results, and retrieves the next 500 messages in the same sort order.

  1. Exécutez la commande suivante pour récupérer la première page de résultats.Run the following command to retrieve the first page of results.

    $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.To set the bookmark object, run the following command to save the last element of the first page to a variable.

    $Temp=$Results[$results.length-1]
    
  3. Pour récupérer les 500 objets sur le serveur spécifié et à exclure de l’objet bookmark, exécutez la commande suivante.To retrieve the next 500 objects on the specified server, and to exclude the bookmark object, run the following command.

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