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