Get-ReviewItems
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.
Syntaxe
Default (Par défaut)
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 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.
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 cette applet de commande ne limite pas le 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
Applicable : Exchange Online
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 : retourner les éléments en attente de destruction. Cette valeur est la valeur par défaut.
Propriétés du paramètre
| Type: | Boolean |
| 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 |
-IncludeHeaders
Applicable : Exchange Online
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. Cette valeur est la valeur par défaut.
Propriétés du paramètre
| Type: | Boolean |
| 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 |
-PagingCookie
Applicable : Exchange Online
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.
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 |
-TargetLabelId
Applicable : Exchange Online
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.
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: | True |
| 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.