Partager via


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 :

  • DateReceived   Date de réception du message.

  • ExpirationTime   Heure d'expiration du message.

  • FromAddress   Adresse SMTP (Simple Mail Transfer Protocol) de l'expéditeur d'un message. Cette valeur est extraite de MAIL FROM: dans l'enveloppe du message.

  • Identity   Nombre entier représentant un message particulier et une identité de serveur et de file d'attente particulière.

  • InternetMessageId   Valeur du champ d'en-tête MessageID:. Cette propriété est exprimée comme un GUID suivi de l'adresse SMTP du serveur d'envoi, comme dans l'exemple suivant : 67D7543D6103DC4FBEBA6BC7205DACABA61231@exchange.contoso.com.

  • LastError   Chaîne de texte de la dernière erreur enregistrée pour un message.

  • MessageSourceName   Chaîne de texte du nom du composant ayant soumis ce message à la file d'attente.

  • Queue   Spécifie l'identité de la file d'attente contenant le message. 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.

  • RetryCount   Nombre de fois que la remise d'un message à une destination a été tentée.

  • SCL   La propriété de contrôle d'accès (SCL) spécifie le niveau SCL du message. Les entrées SCL valides sont des entiers compris entre 0 et 9. Une valeur de propriété SCL vide indique que le message n'a pas été traité par l'agent de filtrage de contenu.

  • Size   Taille d'un message.

  • SourceIP   Adresse IP du serveur externe ayant soumis le message à l'organisation Exchange.

  • Status   État du message actuel. Les options d'état de message sont Active, Retry, Suspended, PendingSuspend ou PendingRemove.

  • Subject   Chaîne de texte représentant l'objet du message électronique. La valeur est extraite du champ d'en-tête Subject:.

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 :

  • Server\QueueIdentity\MessageIdentity

  • QueueIdentity\MessageIdentity

  • Server\*\MessageIdentity

  • MessageIdentity

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"}