Get-Queue

 

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-Queue permet d'afficher lles informations de la configuration des files d'attente sur les serveurs de bipite aux lettres ou les serveurs de transport Edge.

Get-Queue [-Filter <String>] [-Server <ServerIdParameter>] <COMMON PARAMETERS>
Get-Queue [-Identity <QueueIdentity>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-BookmarkIndex <Int32>] [-BookmarkObject <ExtensibleQueueInfo>] [-Exclude <QueueViewerIncludesAndExcludes>] [-Include <QueueViewerIncludesAndExcludes>] [-IncludeBookmark <$true | $false>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-SortOrder <QueueViewerSortOrderEntry[]>]

Cet exemple affiche des informations détaillées pour toutes les files d'attente sur le serveur de boîte aux lettres sur lequel la commande est exécutée.

Get-Queue | Format-List

Cet exemple répertorie les files d'attente qui contiennent plus de 100 messages.

Get-Queue -Filter {MessageCount -gt 100}

Cet exemple affiche des informations détaillées sur une file d'attente spécifique qui existe sur le serveur Server1.

Get-Queue Server1\contoso.com | Format-List

Cet exemple répertorie uniquement les files d’attente externes.

Get-Queue -Exclude Internal

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 « 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.ExtensibleQueueInfo

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.

Exclude

Facultatif

Microsoft.Exchange.Data.QueueViewerIncludesAndExcludes

Le paramètre Exclude spécifie le type de files d'attente que vous désirez exclure des résultats. Les valeurs valides pour ce paramètre sont les suivantes :

Filter

Facultatif

System.String

Le paramètre Filter spécifie une ou plusieurs files d'attente à l'aide de la syntaxe de filtre OPath. Le filtre OPath comprend un nom de propriété de file d'attente suivi d'un opérateur de comparaison et d'une valeur, par exemple, {NextHopDomain -eq "contoso.com"}. Pour plus d'informations sur les propriétés de file d'attente filtrables et les opérateurs de comparaison, consultez les rubriques Propriétés de file 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.QueueIdentity

Le paramètre Identity spécifie la file d’attente. Les entrées valides pour ce paramètre utilisent 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 » dans Rechercher des files d’attente et les messages dans les files d’attente dans Exchange Management Shell.

Include

Facultatif

Microsoft.Exchange.Data.QueueViewerIncludesAndExcludes

Le paramètre Include spécifie le type de files d'attente dont vous désirez inclure les résultats. Les valeurs valides pour ce paramètre sont les suivantes :

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.

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)

  • 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 est affiché dans l'ordre croissant des valeurs de QueueIdentity.

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: