Partager via


Get-Queue

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2007-08-29

La cmdlet Get-Queue permet d'afficher les informations de configuration de files d'attente sur un ordinateur sur lequel le rôle serveur de transport Edge ou de transport Hub est installé.

Syntaxe

Get-Queue [-BookmarkIndex <Int32>] [-BookmarkObject <QueueInfo>] [-Filter <String>] [-IncludeBookmark <$true | $false>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-Server <ServerIdParameter>] [-SortOrder <SortOrderEntry[]>]

Get-Queue [-Identity <QueueIdentity>] [-BookmarkIndex <Int32>] [-BookmarkObject <QueueInfo>] [-IncludeBookmark <$true | $false>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-SortOrder <SortOrderEntry[]>]

Description détaillée

La cmdlet Get-Queue affiche des informations sur les files d'attente existantes sur le serveur de transport Hub ou Edge. Si vous ne fournissez aucun paramètre, la commande interroge toutes les files d'attente du serveur local et renvoie une page de résultats. La taille de page par défaut est de 1000 objets. Vous pouvez afficher les files d'attente d'un serveur distant en incluant le nom de serveur dans le paramètre Identity ou en utilisant le paramètre Server avec une requête de filtre. Les jeux de paramètres Identity et Filter s'excluent mutuellement.

Pour exécuter la cmdlet Get-Queue, vous devez utiliser un compte auquel a été délégué :

  • Rôle Administrateurs de serveur Exchange

Pour exécuter la cmdlet Get-Queue sur un ordinateur sur lequel le rôle serveur de transport Edge est installé, vous devez ouvrir une session en utilisant un compte membre du groupe Administrateurs local sur cet ordinateur.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Microsoft Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

BookmarkIndex

Facultatif

System.Int32

Le paramètre BookmarkIndex permet de spécifier la position, dans le jeu de résultats, où l'affichage des résultats commence. La valeur de ce paramètre est un index basé sur 1 dans le jeu total des résultats. BookmarkIndex ne peut pas être utilisé avec le paramètre BookmarkObject.

BookmarkObject

Facultatif

Microsoft.Exchange.Data.QueueViewer.QueueInfo

Le paramètre BookmarkIndex permet de spécifier l'objet dans le jeu de résultats où l'affichage des résultats commence. BookmarkIndex ne peut pas être utilisé avec le paramètre BookmarkObject.

Filter

Facultatif

System.String

Le paramètre Filter requiert une expression qui spécifie le critère de valeur de propriété pour les files d'attente que vous voulez afficher. L'expression comprend un nom de propriété suivi d'un opérateur de comparaison et d'une valeur. Les propriétés de file d'attente suivantes sont des critères valides pour le paramètre Filter :

  • DeliveryType   Type de remise pour cette file d'attente, tel que défini par le transport. Le type de remise doit être l'une des valeurs suivantes :

    • DNSConnectorDelivery

    • NonSMTPGatewayDelivery

    • SmartHostConnectorDelivery

    • SmtpRelayWithinAdSitetoEdge

    • MapiDelivery

    • SmtpRelayWithinAdSite

    • SmtpRelaytoRemoteAdSite

    • SmtpRelaytoTiRg

    • Non défini

    • Inaccessible

  • Identity   Entrez l'identité de la file d'attente sous la forme Serveur\destination, où destination est un domaine distant, un serveur de boîtes aux lettres ou un nom de file d'attente persistante.

  • LastError   Chaîne de texte de la dernière erreur enregistrée pour une file d'attente.

  • LastRetryTime   Heure à laquelle la dernière tentative de connexion a été effectuée pour cette file d'attente.

  • MessageCount   Nombre d'éléments dans la file d'attente.

  • NextHopConnector   GUID du connecteur utilisé pour créer la file d'attente.

  • NextHopDomain   Domaine de saut suivant de la file d'attente, spécifié comme un domaine SMTP distant, un nom de serveur, le nom d'un site Active Directory ou un identificateur de base de données de messages (MBD).

  • NextRetryTime   Heure à laquelle la prochaine tentative de connexion sera effectuée pour cette file d'attente.

  • Status   État de la file d'attente. Les options d'état de la file d'attente sont Active, Ready, Retry ou Suspended.

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 permet de spécifier l'identité de la file d'attente contenant les messages que vous voulez afficher. Entrez l'identité de file d'attente sous la forme Serveur\destination, où destination est un domaine distant, un serveur de boîtes aux lettres ou un nom de file d'attente persistante.

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 de $true est utilisée.

ResultSize

Facultatif

Microsoft.Exchange.Data.Unlimited

Le paramètre ResultSize permet de spécifier le nombre total d'éléments à afficher dans le jeu de résultats. La valeur par défaut du paramètre ResultSize est définie sur 1000. ResultSize prend en charge un nombre illimité de résultats, mais Microsoft Exchange limite le jeu de résultats à 250 000.

ReturnPageInfo

Facultatif

System.Boolean

Le paramètre ReturnPageInfo est un paramètre caché. Utilisez-le pour retourner des informations sur le nombre total des 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 (avant ou arrière) de la recherche dans le jeu des 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 permet de spécifier le nom du serveur auquel se connecter à l'aide de l'appel de procédure distante (RPC) contenant les files d'attente dans lesquelles figurent les messages que vous voulez afficher. Entrez le nom du serveur comme un nom d'hôte ou un nom de domaine complet (FQDN). Si le paramètre Server n'est pas utilisé, le serveur local est interrogé.

SortOrder

Facultatif

Microsoft.Exchange.Configuration.Tasks.SortOrderEntry[]

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 + au début du nom de propriété pour afficher les résultats dans l'ordre croissant. Ajoutez un symbole - 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.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

 

Exemple

L'exemple suivant illustre trois commandes Get-Queue. La première commande montre la procédure d'affichage des informations de configuration de toutes les files d'attente sur le serveur de transport Hub ou Edge sur lequel la commande est exécutée. La commande est canalisée vers la commande Format-List pour disposer les résultats sous la forme d'une liste détaillée.

La deuxième commande montre la procédure d'affichage des informations de configuration uniquement pour les files d'attente qui contiennent plus de 100 messages.

La troisième commande montre la procédure d'affichage des informations de configuration d'une file d'attente qui existe sur un serveur distant.

Pour plus d'informations sur le traitement en pipeline, consultez la rubrique Traitement en pipeline.

Pour plus d'informations sur l'utilisation de la sortie d'une commande, consultez la rubrique Utilisation de la sortie d'une commande.

Pour plus d'informations sur l'utilisation d'Exchange Management Shell pour exécuter des tâches de l'Afficheur des files d'attente, consultez la rubrique Utilisation d'Exchange Management Shell pour la gestion des files d'attente.

Get-Queue | format-list
Get-Queue -Filter {MessageCount -gt 100}
Get-Queue -Identity Server1\contoso.com