Get-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 Get-RecoverableItems items pour afficher les éléments supprimés dans les boîtes aux lettres. Une fois que vous avez trouvé les éléments supprimés, vous utilisez le cmdlet Restore-RecoverableItems pour les 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

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

Description

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

Get-RecoverableItems -Identity laura@contoso.com -SubjectContains "FY17 Accounting" -FilterItemType IPM.Note -FilterStartTime "2/1/2018 12:00:00 AM" -FilterEndTime "2/5/2018 11:59:59 PM"

Cet exemple retourne tous les messages supprimés récupérables disponibles avec l’objet spécifié dans la boîte aux lettres laura@contoso.com pour la plage de date/heure spécifiée.

Exemple 2

Get-RecoverableItems -Identity "malik@contoso.com", "lillian@contoso.com" -FilterItemType IPM.Note -FilterStartTime "3/15/2019 12:00:00 AM" -FilterEndTime "3/25/2019 11:59:59 PM"

Cet exemple retourne tous les messages supprimés récupérables disponibles avec l’objet spécifié dans les boîtes aux lettres de malik@contoso.com et lillian@contoso.com pour la plage de date/heure spécifiée.

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

-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

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

-SubjectContains

Le paramètre SubjectContains filtre les éléments 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