Suspend-Queue
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2007-06-28
La cmdlet Suspend-Queue permet d'arrêter les activités sortantes d'une file d'attente sur un ordinateur sur lequel le rôle serveur de transport Edge ou de transport Hub est installé.
Syntaxe
Suspend-Queue -Identity <QueueIdentity> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Suspend-Queue -Filter <String> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
Description détaillée
La cmdlet Suspend-Queue arrête les activités sortantes d'une file d'attente dont l'état est Active ou Retry. Les messages en cours de remise via SMTP termineront les opérations. Aucun message supplémentaire ne quitte la file d'attente. Si vous spécifiez un paramètre Identity, la file d'attente est suspendue si l'identité ne correspond qu'à 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 un filtre.
Vous devez utiliser un paramètre Identity ou un paramètre Filter. Les jeux de paramètres Identity et Filter s'excluent mutuellement. Vous pouvez suspendre une file d'attente sur un serveur distant en incluant le nom du serveur dans le paramètre Identity ou en utilisant le paramètre Server avec une requête de filtre. Si vous ne spécifiez pas de serveur, la commande s'exécute uniquement sur le serveur local.
Pour exécuter la cmdlet Suspend-Queue, vous devez utiliser un compte auquel ont été délégués :
- le rôle Administrateur de serveur Exchange et le groupe Administrateurs local pour le serveur cible.
Pour exécuter la cmdlet Suspend-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 présent 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 |
|---|---|---|---|
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 :
Vous pouvez spécifiez 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 suspendre. 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. |
Confirm |
Facultatif |
System.Management.Automation.SwitchParameter |
Le paramètre Confirm suspend le traitement par la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Il n'est pas nécessaire de spécifier une valeur pour le paramètre Confirm. |
Server |
Facultatif |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Le paramètre Server permet de spécifier le nom du serveur auquel se connecter à l'aide d'un appel de procédure distante (RPC) incluant les files d'attente qui contiennent les messages que vous voulez suspendre. Entrez le nom du serveur comme un nom d'hôte ou un nom de domaine complet (FQDN). Si ce paramètre n'est pas utilisé, le serveur local est interrogé. |
WhatIf |
Facultatif |
System.Management.Automation.SwitchParameter |
Le paramètre 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 paramètre WhatIf. |
Types d'entrées
Types de retours
Erreurs
| Erreur | Description |
|---|---|
|
|
Exceptions
| Exceptions | Description |
|---|---|
|
|
Exemple
L'exemple suivant illustre deux commandes Suspend-Queue. La première commande suspend les activités sortantes de toutes les files d'attente contenant des messages à remettre au domaine spécifié et dont l'état est actuellement Retry.
La seconde commande établit une liaison avec un serveur distant en utilisant RPC, puis suspend toutes les files d'attente contenant plus de 100 messages.
Pour plus d'informations sur l'utilisation d'Exchange Management Shell pour exécuter des tâches d'Afficheur de file d'attente, consultez la rubrique Utilisation d'Exchange Management Shell pour la gestion des files d'attente.
Suspend-Queue -Filter {NextHopDomain -eq "contoso.com" -and Status -eq "retry"}
Suspend-Queue -Server ExchSrv1.contoso.com -Filter {MessageCount -gt 100}