Partager via

Restore-RecoverableItems

Module:
Exchange PowerShell

Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. Certains paramètres et paramètres peuvent être exclusifs à un environnement ou à l’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.

Syntaxe

OnPremises 

Restore-RecoverableItems
    -Identity <GeneralMailboxOrMailUserIdParameter>
    [-EntryID <String>]
    [-FilterEndTime <DateTime>]
    [-FilterItemType <String>]
    [-FilterStartTime <DateTime>]
    [-LastParentFolderID <String>]
    [-ResultSize <Unlimited>]
    [-SourceFolder <RecoverableItemsFolderType>]
    [-SubjectContains <String>]
    [<CommonParameters>]

Cloud 

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 cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont 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 2

Dans 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-RecoverableItems

Cet exemple montre comment restaurer en bloc tous les éléments récupérables pour l’administrateur.

Paramètres

-EntryID

Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-FilterEndTime

Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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 MM/jj/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".

Propriétés du paramètre

Type:DateTime
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-FilterItemType

Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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. Lime
  • IPM. Note
  • IPM. Tâche

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-FilterStartTime

Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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 MM/jj/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".

Propriétés du paramètre

Type:DateTime
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Identity

Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

Propriétés du paramètre

Type:GeneralMailboxOrMailUserIdParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

OnPremises
Position:1
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
Cloud
Position:1
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-LastParentFolderID

Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Le paramètre LastParentFolderID spécifie la valeur FolderID de l’élément avant sa suppression. Par exemple, 53B93149989CA54DBC9702AE619B9CCA000062CE9397.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-MaxParallelSize

Applicable : Exchange Online

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.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Cloud
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-NoOutput

Applicable : Exchange Online

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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Cloud
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PolicyTag

Applicable : Exchange Online

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

{{ Fill PolicyTag Description }}

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Default
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RestoreTargetFolder

Applicable : Exchange Online

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 disponible uniquement sur les boîtes aux lettres principales et est ignoré sur les boîtes aux lettres d’archivage. Un dossier de destination est créé s’il n’existe pas. Les chemins d’accès valides sont les suivants :

  • /
  • /folder1
  • /folder1/folder2
  • folder1
  • folder1/folder2

Les points précédents ou de / fin sont ignorés. Ensuite, il est traité comme le chemin relatif de la sous-arborescence IPM : /Top Of Information Store.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Default
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ResultSize

Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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.

Propriétés du paramètre

Type:Unlimited
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SourceFolder

Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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 recherche ces trois dossiers.

  • DiscoveryHoldsItems (cloud-only) : 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.

Propriétés du paramètre

Type:RecoverableItemsFolderType
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

OnPrem
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SubjectContains

Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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 (").

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.