Get-RecoverableItems

Module:
Exchange PowerShell

Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. Certains paramètres et réglages peuvent être exclusifs à l’un ou l’autre environnement.

Utilisez l’applet de commande Éléments Get-RecoverableItems 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/Exportation de boîtes aux lettres et, par défaut, le rôle n’est pas affecté à des groupes 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 

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

Cloud 

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

Description

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

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 renvoie 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 renvoie l’intégralité des messages supprimés récupérables disponibles avec l’objet spécifié dans les boîtes aux lettres des deux malik@contoso.com et lillian@contoso.com pour la plage de date/heure spécifiée.

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’EntryID d’éléments spécifiques en utilisant 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 09/01/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 la propriété MessageClass (ItemClass) spécifiée de l’élément supprimé. Par exemple :

  • IPM.Appointment (réunions et rendez-vous)
  • IPM. Contacter
  • IPM. Fichier
  • IPM. Remarque
  • 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 09/01/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 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".

Attention : La valeur $null ou une valeur inexistante pour le paramètre Identity renvoie tous les objets comme si vous exécutiez la commande Get- sans le paramètre Identity. Vérifiez que les listes de valeurs du paramètre Identity sont exactes et ne contiennent pas de valeurs $null inexistantes.

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 ne spécifie qu’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

-PolicyTag

Applicable : Exchange Online

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

{{ description de la balise de politique de remplissage }}

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

Cloud
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

-SkipCount

Applicable : Exchange Online

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

{{ Remplir SkipCount Description }}

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

(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 l’emplacement de recherche des é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).
  • Éléments purgés : dossier Éléments récupérables\Suppressions. Ce dossier contient des éléments qui ont été purgés du dossier Éléments récupérables (éléments supprimés de manière définitive).

Si vous n’utilisez pas ce paramètre, la commande recherche dans ces trois dossiers.

  • DiscoveryHoldsItems (cloud uniquement) : dossier Recoverable Items\DiscoveryHolds. Ce dossier contient des éléments qui ont été purgés du dossier Éléments récupérables (éléments supprimés de manière définitive) et 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

(All)
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 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 communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.