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-ListCet 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-ListCet 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 InternalCet 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.
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour