New-MailboxRestoreRequest

Module:

ExchangePowerShell

S’applique à:

Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. Certains paramètres peuvent être propres à un environnement ou à un autre.

La cmdlet New-MailboxRestoreRequest permet de restaurer une boîte aux lettres supprimée (récupérable) ou déconnectée. Cette cmdlet lance le processus de déplacement du contenu de la boîte aux lettres supprimée (récupérable), de la boîte aux lettres désactivée ou de toute boîte aux lettres stockée dans une base de données de récupération vers une boîte aux lettres d’archivage ou principale qui est connectée.

Les propriétés utilisées pour rechercher des boîtes aux lettres déconnectées et restaurer une boîte aux lettres sont différentes dans Exchange Server et Exchange Online. Pour plus d’informations sur Exchange Online, consultez Restaurer une boîte aux lettres inactive.

Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.

Syntax

New-MailboxRestoreRequest
   -SourceDatabase <DatabaseIdParameter>
   -SourceStoreMailbox <StoreMailboxIdParameter>
   -TargetMailbox <MailboxOrMailUserIdParameter>
   [-AcceptLargeDataLoss]
   [-AllowLegacyDNMismatch]
   [-AssociatedMessagesCopyOption <FAICopyOption>]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-Confirm]
   [-ConflictResolutionOption <ConflictResolutionOption>]
   [-DomainController <Fqdn>]
   [-ExcludeDumpster]
   [-ExcludeFolders <String[]>]
   [-IncludeFolders <String[]>]
   [-MRSServer <Fqdn>]
   [-Name <String>]
   [-Priority <RequestPriority>]
   [-SourceRootFolder <String>]
   [-SuspendComment <String>]
   [-Suspend]
   [-TargetIsArchive]
   [-TargetRootFolder <String>]
   [-WhatIf]
   [<CommonParameters>]

New-MailboxRestoreRequest
   -SourceEndpoint <MigrationEndpointIdParameter>
   -SourceExchangeGuid <Guid>
   -SourceTenant <SmtpDomain>
   -TargetMailbox <MailboxLocationIdParameter>
   [-AcceptLargeDataLoss]
   [-AllowLegacyDNMismatch]
   [-AssociatedMessagesCopyOption <FAICopyOption>]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-ConflictResolutionOption <ConflictResolutionOption>]
   [-ContentFilter <String>]
   [-ContentFilterLanguage <CultureInfo>]
   [-CrossTenantRestore]
   [-DomainController <Fqdn>]
   [-ExcludeDumpster]
   [-ExcludeFolders <String[]>]
   [-IncludeFolders <String[]>]
   [-LargeItemLimit <Unlimited>]
   [-Name <String>]
   [-SkipMerging <SkippableMergeComponent[]>]
   [-SourceRootFolder <String>]
   [-SuspendComment <String>]
   [-Suspend]
   [-TargetIsArchive]
   [-TargetRootFolder <String>]
   [-TargetType <TargetTypeComponent>]
   [-WhatIf]
   [<CommonParameters>]

New-MailboxRestoreRequest
   -SourceDatabase <DatabaseIdParameter>
   -SourceStoreMailbox <StoreMailboxIdParameter>>
   [-AcceptLargeDataLoss]
   [-AllowLegacyDNMismatch]
   [-AssociatedMessagesCopyOption <FAICopyOption>]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-ConflictResolutionOption <ConflictResolutionOption>]
   [-ContentFilter <String>]
   [-ContentFilterLanguage <CultureInfo>]
   [-DomainController <Fqdn>]
   [-ExcludeDumpster]
   [-ExcludeFolders <String[]>]
   [-IncludeFolders <String[]>]
   [-InternalFlags <InternalMrsFlag[]>]
   [-LargeItemLimit <Unlimited>]
   [-Name <String>]
   [-Priority <RequestPriority>]
   [-RequestExpiryInterval <Unlimited>]
   [-SkipMerging <SkippableMergeComponent[]>]
   [-SourceRootFolder <String>]
   [-Suspend]
   [-SuspendComment <String>]
   [-TargetIsArchive]
   [-TargetRootFolder <String>]
   [-TargetType <TargetTypeComponent>]
   [-WhatIf]
   [-WorkloadType <RequestWorkloadType>]
   [<CommonParameters>]

New-MailboxRestoreRequest
   -SourceStoreMailbox <StoreMailboxIdParameter>
   -TargetMailbox <MailboxLocationIdParameter>
   [-AcceptLargeDataLoss]
   [-AllowLegacyDNMismatch]
   [-AssociatedMessagesCopyOption <FAICopyOption>]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-ConflictResolutionOption <ConflictResolutionOption>]
   [-ContentFilter <String>]
   [-ContentFilterLanguage <CultureInfo>]
   [-DomainController <Fqdn>]
   [-ExcludeDumpster]
   [-ExcludeFolders <String[]>]
   [-IncludeFolders <String[]>]
   [-InternalFlags <InternalMrsFlag[]>]
   [-LargeItemLimit <Unlimited>]
   [-Name <String>]
   [-Priority <RequestPriority>]
   [-RequestExpiryInterval <Unlimited>]
   [-SkipMerging <SkippableMergeComponent[]>]
   [-SourceRootFolder <String>]
   [-Suspend]
   [-SuspendComment <String>]
   [-TargetIsArchive]
   [-TargetRootFolder <String>]
   [-TargetType <TargetTypeComponent>]
   [-WhatIf]
   [-WorkloadType <RequestWorkloadType>]
   [<CommonParameters>]

New-MailboxRestoreRequest
   -SourceStoreMailbox <StoreMailboxIdParameter>
   -TargetMailbox <MailboxOrMailUserIdParameter>
   [-AcceptLargeDataLoss]
   [-AllowLegacyDNMismatch]
   [-AssociatedMessagesCopyOption <FAICopyOption>]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-ConflictResolutionOption <ConflictResolutionOption>]
   [-DomainController <Fqdn>]
   [-ExcludeDumpster]
   [-ExcludeFolders <String[]>]
   [-IncludeFolders <String[]>]
   [-InternalFlags <InternalMrsFlag[]>]
   [-LargeItemLimit <Unlimited>]
   [-Name <String>]
   [-Priority <RequestPriority>]
   [-SkipMerging <SkippableMergeComponent[]>]
   [-SourceRootFolder <String>]
   [-Suspend]
   [-SuspendComment <String>]
   [-TargetIsArchive]
   [-TargetRootFolder <String>]
   [-WhatIf]
   [-WorkloadType <RequestWorkloadType>]
   [<CommonParameters>]

New-MailboxRestoreRequest
   -RemoteDatabaseGuid <Guid>
   -RemoteHostName <Fqdn>
   -RemoteRestoreType <RemoteRestoreType>
   -RemoteCredential <PSCredential>
   -SourceMailbox <MailboxLocationIdParameter>
   -TargetMailbox <MailboxLocationIdParameter>
   [-AcceptLargeDataLoss]
   [-AllowLegacyDNMismatch]
   [-AssociatedMessagesCopyOption <FAICopyOption>]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-ConflictResolutionOption <ConflictResolutionOption>]
   [-ContentFilter <String>]
   [-ContentFilterLanguage <CultureInfo>]
   [-DomainController <Fqdn>]
   [-ExcludeDumpster]
   [-ExcludeFolders <String[]>]
   [-IncludeFolders <String[]>]
   [-InternalFlags <InternalMrsFlag[]>]
   [-LargeItemLimit <Unlimited>]
   [-Name <String>]
   [-Priority <RequestPriority>]
   [-RequestExpiryInterval <Unlimited>]
   [-SkipMerging <SkippableMergeComponent[]>]
   [-SourceIsArchive]
   [-SourceRootFolder <String>]
   [-Suspend]
   [-SuspendComment <String>]
   [-TargetIsArchive]
   [-TargetRootFolder <String>]
   [-TargetType <TargetTypeComponent>]
   [-WhatIf]
   [-WorkloadType <RequestWorkloadType>]
   [<CommonParameters>]

Description

Lorsque des boîtes aux lettres sont déplacées d’une base de données vers une autre, Exchange ne supprime pas entièrement la boîte aux lettres de la base de données source immédiatement après la fin du déplacement. En effet, la boîte aux lettres qui se trouve dans la base de données de boîtes aux lettres source bascule vers l’état supprimé (récupérable), ce qui permet aux données de la boîte aux lettres d’être accessibles lors d’une opération de restauration de boîte aux lettres, en utilisant la nouvelle cmdlet MailboxRestoreRequest. Les boîtes aux lettres supprimées (récupérables) sont conservées dans la base de données source tant que la période de rétention de la boîte aux lettres n’est pas terminée ou que vous n’utilisez pas la cmdlet Remove-StoreMailbox pour vider la boîte aux lettres.

Pour afficher les boîtes aux lettres supprimées (récupérables), exécutez la cmdlet Get-MailboxStatistics sur une base de données et recherchez les résultats comportant un DisconnectReason dont la valeur est SoftDeleted. Pour plus d’informations, consultez l’exemple 1 plus loin dans cette rubrique.

Une boîte aux lettres est marquée Désactivée dès que la commande Disable-Mailbox ou Remove-Mailbox a été exécutée.

La boîte aux lettres n’est pas marquée comme désactivée tant que le service de la banque d’informations Microsoft Exchange n’a pas déterminé qu’Active Directory a été mis à jour avec les informations de la boîte aux lettres désactivées. Vous pouvez accélérer le processus en exécutant la cmdlet Update-StoreMailboxState sur cette base de données.

Exchange conserve les boîtes aux lettres désactivées dans la base de données de boîtes aux lettres en fonction des paramètres de rétention de boîte aux lettres supprimés configurés pour cette base de données de boîtes aux lettres. Après la période spécifiée, la boîte aux lettres est supprimée définitivement.

Pour afficher les boîtes aux lettres désactivées, exécutez la cmdlet Get-MailboxStatistics sur une base de données et recherchez les résultats comportant un DisconnectReason dont la valeur est Disabled. Pour plus d’informations, consultez Exemples 2 et 3 plus loin dans cette rubrique.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.

Remarque : Pour restaurer le contenu d’une boîte aux lettres principale dans une boîte aux lettres d’archivage, utilisez le paramètre TargetRootFolder pour spécifier les dossiers de boîte aux lettres d’archivage vers utilisant le contenu. Ce contenu sera visible après sa restauration. Si vous n’utilisez pas ce paramètre, le contenu restauré n’est pas visible, car il est mappé à des emplacements dans la boîte aux lettres d’archivage qui ne sont pas visibles par les utilisateurs.

Exemples

Exemple 1

Get-MailboxStatistics -Database MBD01 | Where {$_.DisconnectReason -eq "SoftDeleted" -or $_.DisconnectReason -eq "Disabled"} | Format-List LegacyExchangeDN,DisplayName,MailboxGUID, DisconnectReason

New-MailboxRestoreRequest -SourceDatabase "MBD01" -SourceStoreMailbox 1d20855f-fd54-4681-98e6-e249f7326ddd -TargetMailbox Ayla

Dans Exchange local, cet exemple utilise l’applet de commande Get-MailboxStatistics pour renvoyer les valeurs DisplayName, LegacyExchangeDN et MailboxGUID (valeurs d’identité de boîte aux lettres source valides) pour toutes les boîtes aux lettres de la base de données de boîtes aux lettres nommée MBD01 dont la raison de déconnexion est SoftDeleted ou Disabled.

À l’aide de ces informations, la boîte aux lettres source avec la valeur MailboxGUID 1d20855f-fd54-4681-98e6-e249f7326dddd est restaurée dans la boîte aux lettres cible qui a la valeur Alias Ayla.

Exemple 2

New-MailboxRestoreRequest -SourceDatabase "MBD01" -SourceStoreMailbox "Tony Smith" -TargetMailbox Tony@contoso.com -TargetIsArchive

Dans Exchange local, cet exemple montre comment restaurer le contenu de la boîte aux lettres source avec le DisplayName de Tony Smith sur la base de données de boîtes aux lettres MBD01 dans la boîte aux lettres d’archivage pour Tony@contoso.com.

Paramètres

-AcceptLargeDataLoss

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, une version ultérieure ou Exchange Online, vous devez utiliser ce commutateur si vous attribuez la valeur 51 ou une valeur supérieure au paramètre LargeItemLimit. 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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-AllowLegacyDNMismatch

Le commutateur AllowLegacyDNMismatch spécifie que l’opération doit se poursuivre si le LegacyExchangeDN de la boîte aux lettres physique source et la boîte aux lettres cible ne correspondent pas. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Par défaut, cette cmdlet vérifie que l’attribut LegacyExchangeDN de la boîte aux lettres physique source est présent sur l’utilisateur cible, sous la forme de LegacyExchangeDN ou d’une adresse proxy X500 qui correspond à LegacyExchangeDN. Cette vérification vous empêche de restaurer accidentellement une boîte aux lettres source vers une mauvaise boîte aux lettres cible.

Remarque : ce paramètre est disponible uniquement dans le service basé sur le cloud. Pour effectuer une demande de restauration de boîte aux lettres pour les boîtes aux lettres avec un LegacyExchangeDN qui ne correspond pas, vous devez obtenir la valeur LegacyExchangeDN de la boîte aux lettres source et l’ajouter à la boîte aux lettres cible en tant qu’adresse proxy X500. Pour obtenir des instructions détaillées, consultez Restaurer une boîte aux lettres inactive.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-AssociatedMessagesCopyOption

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. Les valeurs valides sont les suivantes :

• DoNotCopy : les messages associés ne sont pas copiés.
• MapByMessageClass : recherchez le message associé 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 : copiez 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 la valeur 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.

Type:	FAICopyOption
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-BadItemLimit

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.

Remarque : ce paramètre est disponible uniquement dans le service basé sur le cloud. À l’avenir, si vous n’utilisez pas ce paramètre, les sémantiques d’approbation des éléments ignorés seront utilisées à la place.

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-BatchName

Le paramètre BatchName spécifie un nom descriptif pour la restauration 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-MailboxRestoreRequest.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-CompletedRequestAgeLimit

Le paramètre CompletedRequestAgeLimit spécifie la durée de définition de l’état d’une demande de restauration terminée sur Completed. Si ce paramètre est défini sur une valeur de 0, l’état est immédiatement effacé au lieu d’être changé en Completed.

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Confirm

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.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ConflictResolutionOption

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

Type:	ConflictResolutionOption
Position:	Named
Default value:	KeepSourceItem
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ContentFilter

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

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. Seuls les contenus qui correspondent au paramètre ContentFilter sont restaurés. 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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ContentFilterLanguage

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

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 de Microsoft .NET Framework. Par exemple, da-DK pour le danois ou ja-JP pour le japonais. Pour plus d’informations, consultez CultureInfo, classe.

Type:	CultureInfo
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-CrossTenantRestore

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-DomainController

Ce paramètre est fonctionnel uniquement dans Exchange local.

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

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ExcludeDumpster

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ExcludeFolders

Le paramètre ExcludeFolders spécifie la liste des dossiers à exclure lors de la demande de restauration.

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
• Notes
• 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\#.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludeFolders

Le paramètre IncludeFolders spécifie la liste des dossiers à inclure lors de la demande de restauration.

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
• Notes
• Courrier indésirable
• CommunicationHistory
• 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\#.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-InternalFlags

Ce paramètre est disponible uniquement dans Exchange sur site.

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

Type:	InternalMrsFlag[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-LargeItemLimit

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.

Remarque : ce paramètre est disponible uniquement dans le service basé sur le cloud. À l’avenir, si vous n’utilisez pas ce paramètre, les sémantiques d’approbation des éléments ignorés seront utilisées à la place.

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-MRSServer

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.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Name

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 de restauration 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 RestoreFailedMoves à ce paramètre, l’identité de cette demande d’exportation est Kweku\RestoreFailedMoves.

Si vous n’avez pas spécifié de nom pour la demande de restauration lors de sa création, Exchange génère automatiquement le nom par défaut MailboxRestore. Exchange génère jusqu’à 10 noms, en commençant par MailboxRestore, puis MailboxRestoreX (où X = 1-9).

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Priority

Ce paramètre est disponible uniquement dans Exchange sur site.

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 :

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

Type:	RequestPriority
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-RemoteCredential

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

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

Type:	PSCredential
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-RemoteDatabaseGuid

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

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

Type:	Guid
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-RemoteHostName

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

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

Type:	Fqdn
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-RemoteRestoreType

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

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

Type:	RemoteRestoreType
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-RequestExpiryInterval

Ce paramètre est disponible uniquement dans Exchange sur site.

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.

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-SkipMerging

Le paramètre SkipMerging spécifie les éléments relatifs aux dossiers à ignorer lors de la restauration de la boîte aux lettres. Utilisez l'une des valeurs suivantes :

• FolderACLs
• FolderProperties
• FolderRules
• InitialConnectionValidation

Utilisez ce paramètre uniquement si la demande de restauration échoue à cause des règles du dossier, des listes de contrôle d’accès aux dossiers (ACL) ou de la validation de connexion initiale.

Type:	SkippableMergeComponent[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SourceDatabase

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre SourceDatabase spécifie l’identité de la base de données à partir de laquelle vous restaurez la boîte aux lettres supprimée (récupérable) ou déconnectée. Vous pouvez utiliser n’importe quelle valeur qui identifie la base de données de manière unique. Par exemple :

• Nom
• Nom unique (DN)
• GUID

Type:	DatabaseIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SourceEndpoint

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

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

Type:	MigrationEndpointIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-SourceExchangeGuid

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

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

Type:	Guid
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-SourceIsArchive

Le commutateur SourceIsArchive spécifie que la boîte aux lettres source est une boîte aux lettres d’archivage. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Vous pouvez utiliser ce commutateur uniquement avec le paramètre SourceMailbox.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online

-SourceMailbox

Le paramètre SourceMailbox spécifie la boîte aux lettres supprimée (récupérable) que vous souhaitez restaurer. La meilleure façon d’identifier la boîte aux lettres supprimée de manière réversible est par sa valeur GUID. Vous pouvez trouver cette valeur en exécutant la commande suivante : Get-Mailbox -SoftDeletedMailbox.

Type:	SourceMailbox
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online

-SourceRootFolder

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SourceStoreMailbox

Ce paramètre est fonctionnel uniquement dans Exchange local.

Le paramètre SourceStoreMailbox spécifie le MailboxGUID de la boîte aux lettres source à partir de laquelle vous souhaitez restaurer le contenu.

Vous pouvez trouver l’objet MailboxGUID en exécutant l’applet de commande Get-MailboxStatistics.

Type:	StoreMailboxIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SourceTenant

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

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

Type:	SmtpDomain
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-Suspend

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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SuspendComment

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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-TargetIsArchive

Le commutateur TargetIsArchive spécifie que le contenu est restauré dans l’archive de la boîte aux lettres cible spécifiée. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-TargetMailbox

Le paramètre TargetMailbox spécifie le GUID de la boîte aux lettres ou de l’utilisateur de messagerie cible dans lequel vous souhaitez restaurer le contenu. La boîte aux lettres ou l’utilisateur de messagerie cible doit être présent pour pouvoir exécuter cette commande avec succès.

Vous pouvez trouver la valeur GUID pour l’utilisateur de boîte aux lettres ou de messagerie en exécutant les applets de commande Get-Mailbox ou Get-MailUser.

Dans Exchange 2016 ou version ultérieure et Exchange Online, ce paramètre est de type MailboxLocationIdParameter.

Dans Exchange 2013 ou une version antérieure, ce paramètre est de type MailboxOrMailUserIdParameter.

Type:	MailboxLocationIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online

-TargetRootFolder

Le paramètre TargetRootFolder spécifie le dossier de niveau supérieur dans lequel vous souhaitez restaurer les données. Si vous ne spécifiez pas ce paramètre, la commande restaure les dossiers vers le niveau supérieur de la structure de dossiers dans l’archive ou la boîte aux lettres 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.

Remarque : Pour restaurer le contenu d’une boîte aux lettres principale dans une boîte aux lettres d’archivage, utilisez ce paramètre pour spécifier les dossiers de boîtes aux lettres d’archivage vers utilisant la migration du contenu. Ce contenu sera visible après sa restauration. Si vous n’utilisez pas ce paramètre, le contenu restauré n’est pas visible, car il est mappé à des emplacements dans la boîte aux lettres d’archivage qui ne sont pas visibles par les utilisateurs.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-TargetType

Le paramètre TargetType spécifie le type de boîte aux lettres cible de l’opération de restauration. Les valeurs valides sont les suivantes :

• Archiver
• MailboxLocation
• Principal (il s’agit de la valeur par défaut)

Type:	TargetTypeComponent
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online

-WhatIf

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.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-WorkloadType

Ce paramètre est disponible uniquement dans Exchange sur site.

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

Type:	RequestWorkloadType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Entrées

Input types

Pour visualiser les types d'entrées acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type d'entrée pour une cmdlet est vide, la cmdlet n'accepte pas les données d'entrée.

Sorties

Output types

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.