New-MailboxExportRequest

Le commutateur AcceptLargeDataLoss spécifie que la demande doit continuer même si un grand nombre d’éléments dans la boîte aux lettres source ne peuvent pas être copiés dans la boîte aux lettres cible. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Dans Exchange 2013 ou version ultérieure, vous devez utiliser ce commutateur si vous définissez le paramètre LargeItemLimit sur une valeur de 51 ou supérieure. Sinon, la commande échoue.

Dans Exchange 2010, vous devez utiliser ce commutateur si vous définissez le paramètre BadItemLimit sur une valeur supérieure ou égale à 51. Sinon, la commande échoue.

Le paramètre AssociatedMessagesCopyOption spécifie s’il faut copier les messages associés lors du traitement de la demande. Des messages associés constituent des messages spéciaux qui contiennent des données masquées avec des informations sur les règles, les écrans et les formulaires. Par défaut, les messages associés sont copiés. Vous ne pouvez pas utiliser ce paramètre avec le paramètre IncludedRecipients ou l’un des paramètres Conditional.

• DoNotCopy : les messages associés ne sont pas copiés.
• MapByMessageClass : cette option recherche le message associé correspondant en recherchant l’attribut MessageClass du message source. S’il existe un message de cette classe associé dans les dossiers source et cible, le message associé est remplacé dans la cible. S’il n’existe aucun message associé dans la cible, une copie est créée dans la cible.
• Copier : cette option copie les messages associés de la source vers la cible. S’il existe le même type de message aux emplacements source et cible, ces messages associés sont dupliqués. Il s'agit de l'option par défaut.

Copy : cette option copie des messages associés à partir de la source vers la cible. S’il existe le même type de message aux emplacements source et cible, ces messages associés sont dupliqués. Il s’agit de l’option par défaut.

Le paramètre BadItemLimit spécifie le nombre maximal d’éléments incorrects autorisés avant l’échec de la demande. Un élément incorrect est un élément endommagé dans la boîte aux lettres source ne pouvant pas être copié vers la boîte aux lettres cible. Les éléments manquants sont également inclus dans la limite d’éléments incorrects. Les éléments manquants sont des éléments de la boîte aux lettres source qui ne figurent pas dans la boîte aux lettres cible lorsque la demande est prête à être exécutée.

L’entrée valide pour ce paramètre est un nombre entier ou la valeur unlimited. La valeur par défaut est 0, ce qui signifie que la demande échoue si des éléments incorrects sont détectés. Si l’abandon de quelques éléments incorrects ne vous pose pas de problème, vous pouvez définir ce paramètre sur une valeur raisonnable (recommandation : 10 ou moins) afin que la demande se poursuive. Si trop d’éléments incorrects sont détectés, envisagez d’utiliser la cmdlet New-MailboxRepairRequest pour tenter de réparer les éléments endommagés dans la boîte aux lettres source, puis réessayez la demande.

Dans Exchange 2010, si vous définissez cette valeur sur 51 ou plus, vous devez également utiliser le commutateur AcceptLargeDataLoss. Sinon, la commande échoue.

Le paramètre BatchName spécifie un nom descriptif pour l’exportation d’un lot de boîtes aux lettres. Vous pouvez utiliser le nom figurant dans le paramètre BatchName comme chaîne de recherche lorsque vous utilisez la cmdlet Get-MailboxExportRequest.

Le paramètre CompletedRequestAgeLimit spécifie la durée pendant laquelle la demande est conservée une fois terminée avant d’être automatiquement supprimée. Le paramètre CompletedRequestAgeLimit par défaut est 30 jours.

Ce paramètre est réservé à l’usage interne chez Microsoft.

Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

• Les applets de commande destructrices (par exemple, les applets de commande Remove-*) ont une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.
• La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.

Le paramètre ConflictResolutionOption spécifie ce qu’il faut faire s’il existe plusieurs messages correspondants dans la cible. Les valeurs valides sont les suivantes :

• ForceCopy
• KeepAll
• KeepLatestItem
• KeepLatestItem
• KeepTargetItem
• UpdateFromSource

Le paramètre ContentFilter utilise la syntaxe de filtre OPATH pour filtrer les résultats en fonction des propriétés et valeurs spécifiées. Seul le contenu qui correspond au paramètre ContentFilter sera exporté dans le fichier .pst. Les critères de recherche utilisent la syntaxe "Property -ComparisonOperator 'Value'".

• Placez l’ensemble du filtre OPATH entre guillemets doubles « ». Si le filtre contient des valeurs système (par exemple, $true, $falseou $null), utilisez plutôt des guillemets simples « ». Bien que ce paramètre soit une chaîne (et non un bloc système), vous pouvez également utiliser des accolades { }, mais uniquement si le filtre ne contient pas de variables.
• Property est une propriété filtrable. Pour les propriétés filtrables, consultez Propriétés filtrables pour le paramètre ContentFilter.
• ComparisonOperator est un opérateur de comparaison OPATH (par exemple -eq pour des valeurs égales et -like pour la comparaison de chaînes). Pour plus d'informations sur les opérateurs de comparaison, reportez-vous à la rubrique about_Comparison_Operators.
• Value est la valeur de propriété à rechercher. Placez les valeurs de texte et les variables entre guillemets simples ('Value' ou '$Variable'). Si une valeur de variable contient des guillemets simples, vous devez identifier (échappement) les guillemets simples pour développer la variable correctement. Par exemple, au lieu de '$User', utilisez '$($User -Replace "'","''")'. Ne placez pas entre guillemets les entiers ou les valeurs système (par exemple, utilisez 500, $true, $falseou $null à la place).

Vous pouvez chaîner plusieurs critères de recherche à l’aide des opérateurs logiques -and et -or. Par exemple : "Criteria1 -and Criteria2" ou "(Criteria1 -and Criteria2) -or Criteria3".

Pour plus d’informations sur les filtres OPATH dans Exchange, consultez Informations supplémentaires sur la syntaxe OPATH.

Le paramètre ContentFilterLanguage spécifie la langue en cours d’utilisation dans le paramètre ContentFilter pour les recherches de chaînes.

L’entrée valide pour ce paramètre est une valeur de code de culture prise en charge à partir de la classe CultureInfo Microsoft .NET Framework. Par exemple, da-DK pour le danois ou ja-JP pour le japonais. Pour plus d’informations, consultez CultureInfo, classe.

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : « dc01.contoso.com ».

Le commutateur ExcludeDumpster spécifie s’il faut exclure le dossier Éléments récupérables. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Si vous n’utilisez pas ce commutateur, le dossier Éléments récupérables est copié avec les sous-dossiers suivants :

• Suppressions
• Versions
• Purges

Le paramètre ExcludeFolders spécifie la liste de dossiers à exclure durant l’exportation.

Vous devez définir le paramètre ImmutableId si vous déployez les services de fédération exADNoMk (AD FS) pour autoriser l’authentification unique dans une boîte aux lettres hors site et si les services AD FS sont configurés pour l’utilisation d’un attribut autre que l’attribut ExchangeGUID pour les demandes de jetons d’authentification. exExchangeNoVersion et les services AD FS doivent demander le même jeton pour le même utilisateur afin de garantir un fonctionnement correct dans un scénario de déploiement exExchangeNoVersion entre différents locaux.

<FolderName>/*: utilisez cette syntaxe pour désigner un dossier personnel sous le dossier spécifié dans le paramètre SourceRootFolder, par exemple, « MyProjects » ou « MyProjects/FY2010 ».

#<FolderName>#/*: utilisez cette syntaxe pour indiquer un dossier connu, quel que soit le nom du dossier dans une autre langue. Par exemple, #Inbox# désigne le dossier Boîte de réception, même si la boîte de réception est traduite en turc par Gelen Kutusu. Voici quelques types de dossiers connus :

• Boîte de réception
• SentItems
• DeletedItems
• Calendrier
• Contacts
• Brouillons
• Journal
• Tâches
• Remarques
• Courrier indésirable
• CommunicatorHistory
• Messagerie vocale
• Fax
• Conflicts
• SyncIssues
• LocalFailures
• ServerFailures

Si l’utilisateur crée un dossier personnel portant le même nom qu’un dossier connu et le symbole # qui l’entoure, vous pouvez utiliser une barre oblique inverse (\) comme caractère d’échappement pour spécifier ce dossier. Par exemple, si un utilisateur crée un dossier nommé #Notes# et que vous souhaitez spécifier ce dossier au lieu du dossier Notes bien connu, utilisez la syntaxe suivante : \#Notes\#.

Si l’utilisateur crée un dossier personnel portant le même nom qu’un dossier connu et entouré par le symbole #, vous pouvez utiliser une barre oblique inverse (\) comme caractère d’échappement pour désigner ce dossier. Par exemple, si un utilisateur crée un dossier appelé #Notes# et que vous souhaitez désigner ce dossier et non le dossier connu Notes, utilisez la syntaxe suivante : \#Notes\#.

Pour exclure le dossier Éléments récupérables, vous devez utiliser le paramètre ExcludeDumpster.

Le paramètre FilePath indique le chemin du partage réseau du fichier .pst vers lequel les données sont exportées. Par exemple, \\SERVEUR01\Fichiers PST\exportés.pst.

Vous devez accorder l’autorisation suivante au groupe du sous-système approuvé Exchange (Exchange Trusted Subsystem) sur le partage réseau où vous exporterez ou importerez des fichiers PST :

• Pour importer des fichiers PST à partir du partage, procédez comme suit : Autorisation de lecture
• Pour enregistrer les fichiers PST exportés dans le partage, procédez comme suit : Autorisation de lecture/écriture.

Si vous n’accordez pas cette autorisation, vous recevez un message d’erreur indiquant qu’Exchange ne parvient pas à se connecter au fichier PST sur le partage réseau.

Le paramètre IncludeFolders spécifie la liste de dossiers à inclure durant l’exportation.

Vous devez définir le paramètre ImmutableId si vous déployez les services de fédération exADNoMk (AD FS) pour autoriser l’authentification unique dans une boîte aux lettres hors site et si les services AD FS sont configurés pour l’utilisation d’un attribut autre que l’attribut ExchangeGUID pour les demandes de jetons d’authentification. exExchangeNoVersion et les services AD FS doivent demander le même jeton pour le même utilisateur afin de garantir un fonctionnement correct dans un scénario de déploiement exExchangeNoVersion entre différents locaux.

<FolderName>/*: utilisez cette syntaxe pour désigner un dossier personnel sous le dossier spécifié dans le paramètre SourceRootFolder, par exemple, « MyProjects » ou « MyProjects/FY2010 ».

#<FolderName>#/*: utilisez cette syntaxe pour indiquer un dossier connu, quel que soit le nom du dossier dans une autre langue. Par exemple, #Inbox# désigne le dossier Boîte de réception, même si la boîte de réception est traduite en turc par Gelen Kutusu. Voici quelques types de dossiers connus :

• Boîte de réception
• SentItems
• DeletedItems
• Calendrier
• Contacts
• Brouillons
• Journal
• Tâches
• Remarques
• Courrier indésirable
• CommunicatorHistory
• Messagerie vocale
• Fax
• Conflicts
• SyncIssues
• LocalFailures
• ServerFailures

Si l’utilisateur crée un dossier personnel portant le même nom qu’un dossier connu et le symbole # qui l’entoure, vous pouvez utiliser une barre oblique inverse (\) comme caractère d’échappement pour spécifier ce dossier. Par exemple, si un utilisateur crée un dossier nommé #Notes# et que vous souhaitez spécifier ce dossier au lieu du dossier Notes bien connu, utilisez la syntaxe suivante : \#Notes\#.

Si l’utilisateur crée un dossier personnel portant le même nom qu’un dossier connu et entouré par le symbole #, vous pouvez utiliser une barre oblique inverse (\) comme caractère d’échappement pour désigner ce dossier. Par exemple, si un utilisateur crée un dossier appelé #Notes# et que vous souhaitez désigner ce dossier et non le dossier connu Notes, utilisez la syntaxe suivante : \#Notes\#.

Le dossier Éléments récupérables est toujours inclus si vous n’utilisez pas le paramètre ExcludeDumpster, quelle que soit la liste de dossiers que vous fournissez.

Le paramètre InternalFlags spécifie les étapes facultatives de la demande. Ce paramètre sert principalement à des fins de débogage.

Le commutateur IsArchive spécifie que vous exportez à partir de l’archive de l’utilisateur. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Le paramètre LargeItemLimit spécifie le nombre maximal d’éléments volumineux autorisés avant l’échec de la demande. Un élément volumineux est un message dans la boîte aux lettres source qui dépasse la taille de message maximale autorisée dans la boîte aux lettres cible. Si aucune valeur de taille de message maximale n’est spécifiquement configurée pour la boîte aux lettres cible, la valeur à l’échelle de l’organisation est utilisée.

Pour plus d’informations sur les valeurs de taille de message maximale, consultez les rubriques suivantes :

• Exchange 2016 : Limites de taille des messages dans Exchange Server
• Exchange Online : Limites d’Exchange Online

L’entrée valide pour ce paramètre est un nombre entier ou la valeur unlimited. La valeur par défaut est 0, ce qui signifie que la demande échoue si des éléments volumineux sont détectés. Si l’abandon de quelques éléments volumineux ne vous pose pas de problème, vous pouvez définir ce paramètre sur une valeur raisonnable (recommandation : 10 ou moins) afin que la demande se poursuive.

Si vous définissez cette valeur sur 51 ou plus, vous devez également utiliser le commutateur AcceptLargeDataLoss. Sinon, la commande échoue.

Le paramètre Mailbox spécifie la boîte aux lettres source à partir de laquelle le contenu est exporté.

Dans Exchange 2016 CU7 ou version ultérieure, ce paramètre est de type MailboxLocationIdParameter. Par conséquent, la valeur la plus simple que vous pouvez utiliser pour identifier la boîte aux lettres est la valeur Alias.

Dans Exchange 2016 CU6 ou version antérieure, ce paramètre est de type MailboxOrMailUserIdParameter. Vous pouvez donc utiliser n’importe quelle valeur qui identifie la boîte aux lettres de façon unique. Par exemple :

• Nom
• Alias
• Nom unique
• Nom unique
• Domaine\Nom d’utilisateur
• Adresse e-mail
• GUID
• LegacyExchangeDN
• SamAccountName
• Identifiant utilisateur ou nom d’utilisateur principal (UPN)

Ce paramètre n'est disponible que dans Exchange Server 2010.

Le paramètre MRSServer spécifie le nom de domaine complet (FQDN) du serveur d’accès au client sur lequel l’instance du service de réplication de boîte aux lettres Microsoft Exchange est exécutée. Ce paramètre sert uniquement à des fins de débogage. Utilisez ce paramètre uniquement si le personnel du support technique vous y invite.

Le paramètre Name spécifie le nom de la demande spécifique à des fins de suivi et d’affichage. Étant donné que vous pouvez avoir plusieurs demandes d’exportation par boîte aux lettres, Exchange précède le nom par l’alias de la boîte aux lettres. Par exemple, si vous créez une demande d’exportation pour la boîte aux lettres d’un utilisateur dont l’alias est Kweku et que vous attribuez la valeur PC1toArchive à ce paramètre, l’identité de cette demande d’exportation est Kweku\PC1toArchive.

Si vous ne spécifiez pas de nom à l’aide de ce paramètre, Exchange génère jusqu’à 10 noms de demande par boîte aux lettres, à savoir MailboxExportX (où X = 0-9). L’identité de la demande s’affiche et peut faire l’objet d’une recherche en tant que <alias>\MailboxExportX.

Ce paramètre est réservé à l’usage interne chez Microsoft.

Le paramètre Priority spécifie l'ordre selon lequel la demande doit être traitée dans la file d'attente des demandes. Les demandes sont traitées dans un ordre basé sur l'intégrité, l'état, la priorité et la dernière durée de mise à jour du serveur. Les valeurs de priorité valides sont les suivantes :

• Inférieure
• Faible
• Normal (il s’agit de la valeur par défaut.)
• Importante
• Plus élevée
• La plus élevée
• Urgence

Ce paramètre est réservé à l’usage interne chez Microsoft.

Ce paramètre est réservé à l’usage interne chez Microsoft.

Le paramètre RequestExpiryInterval spécifie une limite d’âge pour les demandes terminées ou en échec. Lorsque vous utilisez ce paramètre, la demande terminée ou en échec est supprimée automatiquement après l’expiration de l’intervalle spécifié. Si vous n’utilisez pas ce paramètre :

• La demande terminée est automatiquement supprimée en fonction de la valeur du paramètre CompletedRequestAgeLimit.
• Si la demande échoue, vous devez la supprimer manuellement à l’aide de l’applet de commande Remove-*Request correspondante.

Pour spécifier une valeur, entrez-la sous forme d’une période : dd.hh:mm:ss où dd = jours, hh = heures, mm = minutes et ss = secondes.

Lorsque vous utilisez la valeur Unlimited, la demande terminée n’est pas automatiquement supprimée.

Le paramètre SkipMerging spécifie les étapes de l’exportation à ignorer. Ce paramètre sert principalement à des fins de débogage.

Le paramètre SourceRootFolder spécifie le dossier racine de la boîte aux lettres à partir de laquelle les données sont exportées. Si ce paramètre n’est pas spécifié, la commande exporte tous les dossiers.

Le commutateur Suspend spécifie si la demande doit être suspendue. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Si vous utilisez ce commutateur, la demande est placée dans la file d’attente, mais n’atteint l’état InProgress que lorsqu’elle est reprise à l’aide de la cmdlet de reprise appropriée.

Le paramètre SuspendComment fournit une description expliquant pourquoi la demande a été suspendue. Vous pouvez uniquement recourir à ce paramètre si vous spécifiez le paramètre Suspend.

Le paramètre TargetRootFolder spécifie le dossier de niveau supérieur dans lequel exporter des données. Si vous ne spécifiez pas ce paramètre, la commande exporte des dossiers vers le niveau supérieur de la structure de dossiers dans le fichier .pst cible. Le contenu est fusionné sous des dossiers existants et de nouveaux dossiers sont créés s’ils n’existaient pas déjà dans la structure de dossiers cible.

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Ce paramètre est réservé à l’usage interne chez Microsoft.