Get-Queue

La cmdlet est disponible uniquement dans Exchange en local.

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.

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

Syntax

Get-Queue
   [[-Identity] <QueueIdentity>]
   [-BookmarkIndex <Int32>]
   [-BookmarkObject <ExtensibleQueueInfo>]
   [-Exclude <QueueViewerIncludesAndExcludes>]
   [-Include <QueueViewerIncludesAndExcludes>]
   [-IncludeBookmark <Boolean>]
   [-ResultSize <Unlimited>]
   [-ReturnPageInfo <Boolean>]
   [-SearchForward <Boolean>]
   [-SortOrder <QueueViewerSortOrderEntry[]>]
   [<CommonParameters>]
Get-Queue
   [-Server <ServerIdParameter>]
   [-Filter <String>]
   [-BookmarkIndex <Int32>]
   [-BookmarkObject <ExtensibleQueueInfo>]
   [-Exclude <QueueViewerIncludesAndExcludes>]
   [-Include <QueueViewerIncludesAndExcludes>]
   [-IncludeBookmark <Boolean>]
   [-ResultSize <Unlimited>]
   [-ReturnPageInfo <Boolean>]
   [-SearchForward <Boolean>]
   [-SortOrder <QueueViewerSortOrderEntry[]>]
   [<CommonParameters>]

Description

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, 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 rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.

Exemples

Exemple 1

Get-Queue | Format-List

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.

Exemple 2

Get-Queue -Filter "MessageCount -gt 100"

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

Exemple 3

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

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

Exemple 4

Get-Queue -Exclude Internal

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

Paramètres

-BookmarkIndex

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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-BookmarkObject

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.

Type:ExtensibleQueueInfo
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Exclude

Le paramètre Exclude spécifie le type de files d'attente que vous désirez exclure des résultats. Le paramètre PasswordQuality indique le niveau de qualité minimal imposé aux mots de passe des appareils. La qualité des mots de passe est une échelle numérique qui indique le niveau de sécurité et de complexité du mot de passe. Plus la valeur de qualité est élevée, plus le mot de passe est sécurisé.

  • Interne
  • Externe
  • Une valeur de file d'attente valide DeliveryType. Pour plus d’informations, consultez la section NextHopSolutionKey dans Files d’attente et messages dans les files d’attente.
Type:QueueViewerIncludesAndExcludes
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Filter

Le paramètre Filter spécifie une ou plusieurs files d’attente à l’aide de la syntaxe de filtre OPATH. Le filtre OPATH inclut 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 Propriétés de file d’attente dans Exchange Server et Rechercher des files d’attente et des messages dans des files d’attente dans l’environnement de ligne de commande Exchange Management Shell.

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Le paramètre Identity spécifie la file d’attente. Une entrée valide pour ce paramètre utilise la syntaxe Server\Queue\Queue, par exemple, Mailbox01\contoso.com ou Unreachable. Pour plus d’informations sur l’identité de file d’attente, consultez Identité de file d’attente.

Type:QueueIdentity
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Include

Le paramètre Include spécifie le type de files d'attente dont vous désirez inclure les résultats. Le paramètre PasswordQuality indique le niveau de qualité minimal imposé aux mots de passe des appareils. La qualité des mots de passe est une échelle numérique qui indique le niveau de sécurité et de complexité du mot de passe. Plus la valeur de qualité est élevée, plus le mot de passe est sécurisé.

  • Interne
  • Externe
  • Une valeur de file d'attente valide DeliveryType. Pour plus d’informations, consultez la section NextHopSolutionKey dans Files d’attente et messages dans les files d’attente.
Type:QueueViewerIncludesAndExcludes
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IncludeBookmark

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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ResultSize

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.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ReturnPageInfo

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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SearchForward

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é.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Server

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é

DN Exchange hérité

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.

Type:ServerIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SortOrder

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.

Type:QueueViewerSortOrderEntry[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Entrées

Input types

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.

Sorties

Output types

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.