Partager via


Export-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 Export-Message permet de copier un message d'une file d'attente sur un ordinateur sur lequel le rôle serveur de transport Edge ou Hub est installé vers un chemin d'accès spécifié dans une organisation Microsoft Exchange Server 2007.

Syntaxe

Export-Message -Identity <MessageIdentity> -Path <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Description détaillée

La cmdlet Export-Message copie des messages de la file d'attente de remise, de la file d'attente inaccessible ou de la file d'attente des messages incohérents d'un serveur de transport Hub ou Edge vers le chemin de fichier spécifié. Avant d'exporter un message, vous devez le suspendre. Les messages dans la file d'attente des messages incohérents sont déjà suspendus. Vous pouvez utiliser la commande Export-Message pour copier des messages vers le répertoire de relecture d'un autre serveur de transport. Pour copier un message situé sur un serveur distant, indiquez le nom du serveur dans l'identité du message. L'identité est obligatoire et doit identifier de manière unique un message dans une file d'attente.

Pour exécuter la cmdlet Export-Message, vous devez utiliser un compte auquel ont été délégués :

  • le rôle Administrateur de serveur Exchange et le groupe Administrateurs local pour le serveur cible.

Pour exécuter la cmdlet Export-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 Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

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

  • Vous devez inclure QueueIdentity lorsque vous utilisez la commande Export-Message. Si aucun nom de serveur n'est utilisé, la tâche s'exécute sur le serveur local.

Path

Obligatoire

System.String

Le paramètre Path permet de spécifier le chemin d'accès du fichier dans lequel le message est exporté. La valeur du paramètre Path peut être un nom de fichier, un répertoire et un nom de fichier ou uniquement un répertoire. Le répertoire cible doit exister avant d’exporter les messages. Le répertoire n'est pas créé automatiquement. Si aucun chemin absolu n’est spécifié, le répertoire de travail en cours de la Exchange Management Shell est utilisé. Les répertoires utilisés dans le paramètre Path peuvent être locaux sur l’ordinateur Exchange 2007 ou il peut s’agir d’un chemin UNC (Universal Naming Convention) d’accès à une partie d’un serveur distant. Si vous spécifiez un répertoire existant sans nom de fichier dans la valeur du paramètre Path, les noms des fichiers de messages sont automatiquement définis sur InternalMessageID.eml. InternalMessageID est un identificateur de message affecté par le serveur Exchange 2007 qui est en train de traiter le message. Votre compte doit disposer d’une autorisation en écriture pour le répertoire cible.

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.

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

Les exemples suivants montrent comment exporter des messages d'une file d'attente vers un fichier. Le premier exemple montre comment exporter un message unique vers le chemin d'accès spécifié.

Le deuxième exemple montre comment utiliser la commande Get-Message pour récupérer tous les messages de la file d'attente spécifiée. Les résultats de la requête sont ensuite canalisés vers la commande Export-Message et tous les messages sont copiés dans des fichiers .eml nommés en fonction d'InternalMessageID.

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.

Export-Message -Identity ExchSrv1\contoso.com\1234 -Path "c:\exportfolder\filename.eml"
Get-Message -Queue "Server1\contoso.com" | Export-Message -Path "c:\exportfolder"