Partager via

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

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

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 des paramètres

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 des paramètres

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 des paramètres

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 des paramètres

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 retourne 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 des paramètres

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 des paramètres

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 des paramètres

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.

{{ Fill PolicyTag Description }}

Propriétés des paramètres

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 des paramètres

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.

{{ Fill SkipCount Description }}

Propriétés des paramètres

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 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 des paramètres

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 des paramètres

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.