Resume-Message (RTM)
S’applique à : Exchange Server 2007
Dernière rubrique modifiée : 2007-06-08
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>
Resume-Message -Filter <String> [-Server <ServerIdParameter>]
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 :
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 |
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é. |
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"}