Resume-Message

  • Article

 

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

Dernière rubrique modifiée : 2007-06-28

La cmdlet Resume-Message permet d'activer la remise d'un message précédemment suspendu dans une file d'attente sur un ordinateur sur lequel le rôle serveur de transport Edge ou de transport Hub est installé.

Syntaxe

Resume-Message -Identity <MessageIdentity> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Resume-Message -Filter <String> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La cmdlet Resume-Message active la remise d'un message précédemment suspendu figurant dans la file d'attente sur le serveur de transport Hub ou le serveur de transport Edge. Un message envoyé à plusieurs destinataires pourrait se trouver dans plusieurs files d'attente. Si vous spécifiez un paramètre Identity, le message est repris 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 reprendre 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 reprendre un message sur un serveur distant en incluant le nom de serveur dans le paramètre Identity ou en utilisant le serveur 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 Resume-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 Resume-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 reprendre. 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 de message Message-ID: situé dans l'en-tête du message. 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é SCL spécifie le contrôle d'accès 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 et 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. Il s'agit d'un nombre entier représentant 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 pour se connecter en utilisant l'appel de procédure distante (RPC) contenant les files d'attente qui comprennent les messages pour lesquels vous voulez reprendre. Entrez le paramètre 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 reprendre la remise de tous les messages dont l'état est suspendu et 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.

  • Les messages expirent avant 15h00 à la date spécifiée.

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.

Resume-Message -Filter {FromAddress -eq "sender@contoso.com" -and ExpirationTime -lt "yyyy-mm-dd 03:00:00 PM"}