Partager via


Remove-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 Remove-Message permet de supprimer un message d'une file d'attente sur un ordinateur sur lequel le rôle serveur de transport Edge ou Hub est installé.

Syntaxe

Remove-Message -Identity <MessageIdentity> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [-WithNDR <$true | $false>]

Remove-Message -Filter <String> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]] [-WithNDR <$true | $false>]

Description détaillée

La cmdlet Remove-Message supprime un ou plusieurs messages en file d'attente sur un serveur de transport Hub ou Edge. Un message transmis à plusieurs destinataires pourrait se trouver dans plusieurs files d'attente. Si vous spécifiez un paramètre Identity, le message est supprimé d'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 supprimer un message de plusieurs files d'attente en une seule opération, vous devez utiliser un filtre. Si vous tentez de supprimer un message en cours de remise, l'état du message devient PendingDelete. La remise du message n'est pas interrompue mais, si elle échoue et entraîne le renvoi du message dans la file d'attente, celui-ci est supprimé.

Vous devez utiliser un paramètre Identity ou un paramètre Filter. Ces deux jeux de paramètres s'excluent mutuellement.

Pour exécuter la cmdlet Remove-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 Remove-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 supprimer. 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 Message-ID:. 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 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 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 supprimer. 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.

WithNDR

Facultatif

System.Boolean

Le paramètre WithNDR permet de spécifier si une notification d'échec de remise (NDR) est retournée à l'expéditeur d'un message. Le comportement par défaut de ce paramètre est $true. Ce paramètre peut être utilisé avec les jeux de paramètres Identity et Filter.

Types d'entrées

Types de retours

Erreurs

Erreur Description

Exceptions

Exceptions Description

Exemple

L'exemple suivant montre comment supprimer tous les messages répondant aux critères suivants :

  • 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.

L'exemple suivant montre également comment supprimer le NDR.

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.

Remove-Message -Filter {FromAddress -eq "sender@contoso.com"} -withNDR $false