.png)
Suspend-Queue
S’applique à : Exchange Server 2013
Dernière rubrique modifiée : 2012-06-11
Utilisez la cmdlet Suspend-Queue pour arrêter le traitement d'une file d'attente sur un serveur de boîtes aux lettres ou sur un serveur de transport Edge.
Suspend-Queue -Identity <QueueIdentity> <COMMON PARAMETERS>
Suspend-Queue -Filter <String> [-Server <ServerIdParameter>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Cet exemple interrompt le traitement sur toutes les files d’attente contenant les messages à remettre au domaine contoso.com et dont l’état actuel est Retry.
Suspend-Queue -Filter {NextHopDomain -eq "contoso.com" -and Status -eq "Retry"}
Cet exemple interrompt le traitement sur toutes les files d’attente du serveur Server1.contoso.com ayant plus de 100 messages dans la file d’attente.
Suspend-Queue -Server Server1.contoso.com -Filter {MessageCount -gt 100}
La cmdlet Suspend-Queue arrête le traitement d’une file d’attente dont l’état est Active ou Retry. Les messages en cours de traitement sont remis, mais aucun message supplémentaire ne quitte la file d’attente. Lorsque vous utilisez le paramètre Identity, la file d’attente est interrompue uniquement si l’identité correspond à une seule file d’attente. Si l’identité correspond à plusieurs files d’attente, vous recevez un message d’erreur. Pour suspendre plusieurs files d’attente en une seule opération, vous devez utiliser le paramètre Filter.
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 |
|---|---|---|---|
| Filter | Obligatoire | System.String | Le paramètre Filter requiert une expression qui spécifie les critères de valeur de propriété pour les files d’attente que vous voulez suspendre. 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 : Le type de remise pour cette file d’attente, tel que défini par le transport. Identity : L'identité de la file d'attente sous la forme Serveur\destination, où destination est un groupe de remise ou une destination de routage. LastError : Chaîne de texte de la dernière erreur consigné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 : Le GUID du groupe de remise de saut suivant. NextHopDomain : Le domaine de saut suivant de la file d'attente, spécifié comme groupe de remise ou destination de routage NextRetryTime : Heure à laquelle la prochaine tentative de connexion sera effectuée pour cette file d’attente. Status : L'état de la file d'attente. Les options d’état de la file d’attente sont 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 | Obligatoire | 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 groupe de remise ou une destination de routage. |
| Confirm | Facultatif | System.Management.Automation.SwitchParameter | Le commutateur Confirm peut être utilisé pour supprimer la boîte de dialogue de confirmation qui s’affiche par défaut lorsque cette cmdlet est exécutée. Pour supprimer la boîte de dialogue de confirmation, utilisez la syntaxe de |
| 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 :
Si vous n’utilisez pas le paramètre Server, la commande est exécutée sur le serveur local. |
| WhatIf | Facultatif | System.Management.Automation.SwitchParameter | Le commutateur WhatIf donne pour instruction à la commande de simuler les actions qu’elle va appliquer à l’objet. Grâce au paramètre WhatIf, vous pouvez afficher des changements potentiels sans devoir les appliquer. Il n’est pas nécessaire de spécifier une valeur pour le commutateur WhatIf. |
Pour visualiser les types d’entrées acceptées par cette cmdlet, voir Types d’entrée et de sortie de la cmdlet. 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 retour, connus également en tant que types de sortie, acceptés par cette cmdlet, voir Types d’entrée et de sortie de la cmdlet. Si le champ Type de sortie est vide, la cmdlet ne retourne pas de données.
