Restore-RecoverableItems
Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. Certains paramètres peuvent être propres à un environnement ou à un autre.
Utilisez l’applet de commande Restore-RecoverableItems items pour restaurer les éléments supprimés dans les boîtes aux lettres. Utilisez la cmdlet Get-RecoverableItems pour trouver les éléments supprimés à restaurer.
Cette applet de commande est disponible uniquement dans le rôle Importation d’exportation de boîte aux lettres et, par défaut, le rôle n’est attribué à aucun groupe de rôles. Pour utiliser cette cmdlet, vous devez ajouter le rôle d’importation et d’exportation de boîte aux lettres à un groupe de rôles (par exemple, au groupe de rôles Gestion de l’organisation). Pour plus d'informations, consultez la section relative à l'Ajouter un rôle à un groupe de rôles.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntax
Restore-RecoverableItems
-Identity <GeneralMailboxOrMailUserIdParameter>
[-EntryID <String>]
[-FilterEndTime <DateTime>]
[-FilterItemType <String>]
[-FilterStartTime <DateTime>]
[-LastParentFolderID <String>]
[-ResultSize <Unlimited>]
[-SourceFolder <RecoverableItemsFolderType>]
[-SubjectContains <String>]
[<CommonParameters>] Restore-RecoverableItems
-Identity <GeneralMailboxOrMailUserIdParameter[]>
[-EntryID <String>]
[-FilterEndTime <DateTime>]
[-FilterItemType <String>]
[-FilterStartTime <DateTime>]
[-LastParentFolderID <String>]
[-MaxParallelSize <Int32>]
[-NoOutput]
[-PolicyTag <String[]>]
[-RestoreTargetFolder <String>]
[-ResultSize <Unlimited>]
[-SourceFolder <RecoverableItemsFolderType>]
[-SubjectContains <String>]
[<CommonParameters>] Description
Les éléments sont restaurés dans l’emplacement du dossier d’origine si les informations sont disponibles pour l’élément. Si les informations sont introuvables, l’élément est restauré dans le dossier par défaut pour le type d’élément (Boîte de réception pour les messages, Calendrier pour les réunions et les rendez-vous, etc.).
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.
Exemples
Exemple 1
Restore-RecoverableItems -Identity laura@contoso.com -FilterItemType IPM.Note -SubjectContains "FY18 Accounting" -FilterStartTime "2/1/2018 12:00:00 AM" -FilterEndTime "2/5/2018 11:59:59 PM"Une fois que la cmdlet Get-RecoverableItems a vérifié l’existence de l’élément, cet exemple restaure l’élément supprimé spécifié à partir de la boîte aux lettres spécifiée :
- Boîte aux lettres: laura@contoso.com
- Type d’élément : Message électronique
- Objet du message : FY18 Accounting
- Emplacement : Éléments récupérables\Suppressions
- Plage de dates : 01/02/2018 à 05/02/2018
Exemple 2
$mailboxes = Import-CSV "C:\My Documents\RestoreMessage.csv"
$mailboxes | foreach {Restore-RecoverableItems -Identity $_.SMTPAddress -SubjectContains "Project X" -SourceFolder DeletedItems -FilterItemType IPM.Note}Dans Exchange Server, cet exemple montre comment restaurer le message électronique supprimé « Project X » pour les boîtes aux lettres spécifiées dans le fichier de valeurs séparées par des virgules (CSV) C:\My Documents\RestoreMessage.csv. Le fichier CSV utilise la valeur d’en-tête SMTPAddress et contient l’adresse e-mail de chaque boîte aux lettres sur une ligne distincte comme suit :
SMTPAddress
chris@contoso.com
michelle@contoso.com
laura@contoso.com
julia@contoso.com
La première commande lit le fichier CSV dans la variable nommée $mailboxes. La deuxième commande restaure le message spécifié à partir du dossier Éléments supprimés dans ces boîtes aux lettres.
Exemple 3
Restore-RecoverableItems -Identity "malik@contoso.com","lillian@contoso.com" -FilterItemType IPM.Note -SubjectContains "COGS FY17 Review" -FilterStartTime "3/15/2019 12:00:00 AM" -FilterEndTime "3/25/2019 11:59:59 PM" -MaxParallelSize 2Dans Exchange Online, après avoir utilisé l’applet de commande Get-RecoverableItems pour vérifier l’existence de l’élément, cet exemple montre comment restaurer les éléments supprimés spécifiés dans les boîtes aux lettres spécifiées :
- Boîtes aux lettres : malik@contoso.com, lillian@contoso.com
- Type d’élément : Message électronique
- Objet du message : COGS FY17 Review
- Emplacement : Éléments récupérables\Suppressions
- Plage de dates : 15/03/2019 au 25/03/2019
- Nombre de boîtes aux lettres traitées simultanément : 2
Exemple 4
Get-RecoverableItems administrator | Restore-RecoverableItemsCet exemple montre comment restaurer en bloc tous les éléments récupérables pour l’administrateur.
Paramètres
-EntryID
Le paramètre EntryID spécifie l’élément supprimé que vous souhaitez restaurer. La valeur EntryID pour l’élément supprimé est unique dans la boîte aux lettres.
Vous pouvez trouver l’Id d’entrée pour des éléments spécifiques à l’aide d’autres filtres de recherche sur l’applet de commande Get-RecoverableItems (objet, plage de dates, etc.).
| Type: | String |
| 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 |
-FilterEndTime
FilterEndTime spécifie la date/heure de fin de la plage de dates. Ce paramètre utilise la valeur LastModifiedTime de l’élément.
Utilisez le format de date courte défini dans les paramètres Options régionales sur l’ordinateur où la commande est exécutée. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte jj/mm/aaaa, entrez 01/09/2018 pour spécifier le 1er septembre 2018. Vous pouvez entrer uniquement la date ou vous pouvez entrer la date et l'heure du jour. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets ("), par exemple, "01/09/2018 17:00".
| Type: | DateTime |
| 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 |
-FilterItemType
Le paramètre FilterItemType filtre les résultats en fonction de la valeur de propriété MessageClass (ItemClass) spécifiée de l’élément supprimé. Par exemple :
- IPM.Appointment (réunions et rendez-vous)
- IPM. Contact
- IPM. Fichier
- IPM. Note
- IPM. Tâche
| Type: | String |
| 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 |
-FilterStartTime
FilterStartTime spécifie la date/heure de début de la plage de dates. Ce paramètre utilise la valeur LastModifiedTime de l’élément.
Utilisez le format de date courte défini dans les paramètres Options régionales sur l’ordinateur où la commande est exécutée. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte jj/mm/aaaa, entrez 01/09/2018 pour spécifier le 1er septembre 2018. Vous pouvez entrer uniquement la date ou vous pouvez entrer la date et l'heure du jour. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets ("), par exemple, "01/09/2018 17:00".
| Type: | DateTime |
| 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 |
-Identity
Le paramètre Identity spécifie la boîte aux lettres qui contient les éléments supprimés que vous souhaitez restaurer. Vous pouvez utiliser n’importe quelle valeur qui identifie la boîte aux lettres de manière 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)
Dans Exchange Online, vous pouvez spécifier plusieurs boîtes aux lettres séparées par des virgules. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".
| Type: | GeneralMailboxOrMailUserIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-LastParentFolderID
Le paramètre LastParentFolderID spécifie la valeur FolderID de l’élément avant sa suppression. Par exemple, 53B93149989CA54DBC9702AE619B9CCA000062CE9397.
| Type: | String |
| 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 |
-MaxParallelSize
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
Le paramètre MaxParallelSize spécifie le nombre maximal de boîtes aux lettres traitées par la commande en parallèle. Une valeur valide est un entier compris entre 1 et 10. En règle générale, une valeur plus élevée réduit le temps nécessaire à l’exécution de la commande sur plusieurs boîtes aux lettres.
La valeur de ce paramètre n’a aucun effet lorsque le paramètre Identity spécifie une seule boîte aux lettres.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-NoOutput
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
Le commutateur NoOutput restaure les éléments supprimés directement sans aucune sortie de commande dans la console. 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 Online |
-PolicyTag
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
{{ Fill PolicyTag Description }}
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RestoreTargetFolder
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
Le paramètre RestoreTargetFolder spécifie le dossier de niveau supérieur dans lequel 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.
Ce paramètre est requis pour les archives et facultatif pour les boîtes aux lettres principales. Un dossier de destination est créé s’il n’existe pas. Les chemins d’accès valides sont les suivants :
//folder1/folder1/folder2folder1folder1/folder2
L’élément précédent ou de / fin sera ignoré. Ensuite, il sera traité comme le chemin d’accès relatif de la sous-arborescence IPM : /Top Of Information Store.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ResultSize
Le paramètre ResultSize spécifie le nombre maximal de résultats à renvoyer. Pour retourner toutes les demandes correspondant à la requête, utilisez unlimited comme valeur pour ce paramètre. La valeur par défaut est 1000.
| 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, Exchange Online |
-SourceFolder
Le paramètre SourceFolder spécifie où rechercher les éléments supprimés dans la boîte aux lettres. Les valeurs valides sont les suivantes :
- DeletedItems : le dossier Éléments supprimés.
- RecoverableItems : dossier Éléments récupérables\Suppressions. Ce dossier contient des éléments qui ont été supprimés du dossier Éléments supprimés (éléments supprimés de manière réversible).
- PurgedItems : dossier Éléments récupérables\Purges. Ce dossier contient les éléments qui ont été vidés du dossier Éléments récupérables (éléments supprimés en dur).
Si vous n’utilisez pas ce paramètre, la commande effectue une recherche dans ces trois dossiers.
- DiscoveryHoldsItems : dossier Éléments récupérables\DiscoveryHolds. Ce dossier contient des éléments qui ont été vidés du dossier Éléments récupérables (éléments supprimés en dur) et qui sont protégés par une conservation. Pour rechercher des éléments supprimés dans ce dossier, utilisez ce paramètre avec la valeur DiscoveryHoldsItems.
| Type: | RecoverableItemsFolderType |
| Accepted values: | DeletedItems | RecoverableItems | PurgedItems |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-SubjectContains
Le paramètre SubjectContains filtre les éléments supprimés en fonction de la valeur de texte spécifiée dans le champ Subject. Si la valeur contient des espaces, placez-la entre guillemets (").
| Type: | String |
| 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 |