Suspend-Message
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-Message permet d'empêcher la remise d'un message particulier dans une file d'attente sur un ordinateur sur lequel le rôle serveur de transport Hub ou Edge est installé.
Syntaxe
Suspend-Message -Identity <MessageIdentity> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Suspend-Message -Filter <String> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
Description détaillée
La cmdlet Suspend-Message empêche la remise d'un ou plusieurs messages figurant dans la file d'attente sur le serveur de transport Hub ou Edge. Un message déjà en cours de remise n'est pas suspendu. La remise se poursuit et l'état du message est PendingSuspend. En cas d'échec de la remise, le message retourne dans la file d'attente, puis est suspendu. Vous ne pouvez pas suspendre un message figurant dans la file d'attente de soumission ou la file d'attente des messages incohérents.
Un message envoyé à plusieurs destinataires pourrait se trouver dans plusieurs files d'attente. Si vous spécifiez un paramètre Identity, le message est suspendu dans une seule file d'attente si cette identité ne correspond qu'à un seul message. Si l'identité correspond à plusieurs messages, vous recevez un message d'erreur. Pour suspendre un message dans 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. Ces deux jeux de paramètres s'excluent mutuellement.
Vous pouvez suspendre un message sur un serveur distant en incluant le nom de serveur dans le paramètre Identity ou en utilisant le paramètre Server avec le paramètre Filter. Si vous ne spécifiez pas de serveur, la commande s'exécute uniquement sur le serveur local.
Pour exécuter la cmdlet Suspend-Message, vous devez utiliser un compte auquel le rôle Administrateur de serveur Exchange et le groupe Administrateurs local ont été délégués pour le serveur cible.
Pour exécuter la cmdlet Suspend-Message 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 exige une expression qui spécifie les critères de valeur de propriété pour les messages 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 message suivantes sont des critères valides pour le paramètre Filter :
Vous pouvez spécifier plusieurs critères de filtrage à 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 unique doivent être entre guillemets. |
Identity |
Obligatoire |
Microsoft.Exchange.Data.QueueViewer.MessageIdentity |
Le paramètre Identity permet de spécifier le nombre entier MessageIdentity qui représente un message particulier et une identité de serveur et de file d'attente facultative. La syntaxe de ce paramètre est la suivante :
|
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 server sous la forme d'un nom d'hôte ou d'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 montre comment empêcher la remise de tous les messages pour lesquels les conditions suivantes sont vraies :
Les messages sont envoyés depuis l'adresse SMTP de l'expéditeur spécifié.
Les messages sont mis en file d'attente sur le serveur de transport Hub ou le serveur de transport Edge sur lequel la commande est exécutée.
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-Message -Filter {FromAddress -eq "sender@contoso.com"}