Get-ReviewItems

Référence

Module:: ExchangePowerShell

S’applique à:: Exchange Online

Cette cmdlet est disponible uniquement dans le service cloud.

Utilisez le Get-ReviewItems pour récupérer une liste d’éléments de révision de destruction qui sont en attente de révision ou déjà supprimés pour une étiquette de rétention spécifique. Il peut également être utilisé pour récupérer une liste d’éléments supprimés pour une étiquette d’enregistrement spécifique.

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-ReviewItems
   -TargetLabelId <String>
   [-Disposed <Boolean>]
   [-IncludeHeaders <Boolean>]
   [-PagingCookie <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.

L’applet Get-ReviewItems de commande peut être utilisée pour exporter une liste d’éléments en attente ou supprimés à partir de la révision de destruction. Pour en savoir plus sur la révision de destruction, consultez Disposition de contenu.

Exemples

Exemple 1

$itemsPendingDisposition = Get-ReviewItems -TargetLabelId a8cbeaac-e7aa-42ed-8dba-54200537c9c9 -IncludeHeaders $true

$formattedExportItems = $itemsPendingDisposition.ExportItems | ConvertFrom-Csv -Header $itemsPendingDisposition.Headers

$formattedExportItems

Cet exemple récupère la première page d’éléments en attente de destruction pour l’étiquette avec la valeur a8cbeaac-e7aa-42ed-8dba-54200537c9c9d’ID immuable . Les résultats sont convertis en types PSObject pour chaque élément, puis affichés à l’écran.

Exemple 2

$itemsPendingDisposition = Get-ReviewItems -TargetLabelId a8cbeaac-e7aa-42ed-8dba-54200537c9c9 -IncludeHeaders $true -Disposed $true

$formattedExportItems = $itemsPendingDisposition.ExportItems | ConvertFrom-Csv -Header $itemsPendingDisposition.Headers

$formattedExportItems | Select Subject,Location,ReviewAction,Comment,DeletedBy,DeletedDate

Cet exemple récupère tous les éléments supprimés pour l’étiquette avec un ID immuable de a8cbeaac-e7aa-42ed-8dba-54200537c9c9 et sélectionne des colonnes spécifiques à afficher à l’écran.

Exemple 3

$itemsPendingDisposition = Get-ReviewItems -TargetLabelId a8cbeaac-e7aa-42ed-8dba-54200537c9c9 -IncludeHeaders $true

$exportItems = $itemsPendingDisposition.ExportItems

While (![string]::IsNullOrEmpty($itemsPendingDisposition.PaginationCookie))
{
    $itemsPendingDisposition = Get-ReviewItems -TargetLabelId a8cbeaac-e7aa-42ed-8dba-54200537c9c9 -IncludeHeaders $true -PagingCookie $itemsPendingDisposition.PaginationCookie
    $exportItems += $itemsPendingDisposition.ExportItems
}

$exportItems | ConvertFrom-Csv -Header $itemsPendingDisposition.Headers | Export-Csv C:\temp\ItemsPendingDisposition.csv -NoTypeInformation

Cet exemple récupère tous les éléments en attente de destruction pour l’étiquette avec la valeur a8cbeaac-e7aa-42ed-8dba-54200537c9c9d’ID immuable . S’il existe plusieurs pages d’éléments, la commande continue jusqu’à ce qu’il n’y ait plus de pages. Les résultats sont exportés vers le fichier CSV spécifié.

Remarque : Bien que l’applet de commande n’impose aucune limite au nombre d’éléments/pages pouvant être récupérés, d’autres limitations peuvent se produire. Pour éviter la limitation lors de la récupération d’un grand nombre d’éléments, nous vous recommandons d’inclure des interruptions dans votre script. Vous pouvez utiliser le paramètre PagingCookie pour reprendre là où le script s’est arrêté après une pause.

Paramètres

-Disposed

Le paramètre Disposed spécifie s’il faut retourner les éléments supprimés au lieu des éléments en attente de destruction. Les valeurs valides sont les suivantes :

$true : retourne les éléments supprimés.
$false : renvoyer les éléments en attente de destruction. Il s’agit de la valeur par défaut.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-IncludeHeaders

Le paramètre IncludeHeaders spécifie si les en-têtes sont retournés en tant que propriété avec les éléments de révision. Les valeurs valides sont les suivantes :

$true : les en-têtes sont retournés en tant que propriété avec les éléments de révision. Cette option est utile lors de la conversion de la sortie en PSObject dans PowerShell ou lors de l’exportation au format CSV.
$false : les en-têtes ne sont pas retournés en tant que propriété avec les éléments de révision. Il s’agit de la valeur par défaut.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-PagingCookie

Le paramètre PagingCookie identifie la page à récupérer. Ce paramètre est utile dans les scénarios suivants :

Pour éviter la limitation lors de la récupération d’un grand nombre d’éléments.
Comme méthode de démarrage là où la dernière opération s’est arrêté.

La valeur PagingCookie est retournée dans la propriété PaginationCookie chaque fois que l’applet de commande est correctement exécutée. Si paginationCookie est vide (null), il n’y a plus d’éléments à récupérer.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-TargetLabelId

Le paramètre TargetLabelId spécifie l’étiquette pour laquelle vous souhaitez récupérer les éléments de révision. Une valeur valide pour ce paramètre est l’ID immuable de l’étiquette.

Pour obtenir la valeur d’ID immuable d’une étiquette, remplacez <RetentionLabelName> par le nom de l’étiquette, puis exécutez la commande suivante dans Exchange Online PowerShell : Get-ComplianceTag -Identity "<RetentionLabelName>" | select ImmutableId.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

Partager via