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 disposition en attente de révision ou déjà éliminés pour une étiquette de rétention spécifique. Il peut également être utilisé pour récupérer une liste d’articles mis au rebut pour une maison de disques spécifique.
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
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 la disposition. Pour en savoir plus sur l’examen de la disposition, voir Disposition du 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 disposition pour l’étiquette avec la valeur a8cbeaac-e7aa-42ed-8dba-54200537c9c9d’ID immuable . Les résultats sont convertis en types de fichiers PSObject pour chaque élément, puis envoyé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 articles mis au rebut 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 disposition pour l’étiquette avec la valeur a8cbeaac-e7aa-42ed-8dba-54200537c9c9ID immuable. S’il existe plusieurs pages d’éléments, la commande se poursuit jusqu’à ce qu’il n’y ait plus de pages. Les résultats sont exportés dans le fichier CSV spécifié.
Remarque : bien que cette applet de commande ne limite pas le nombre d’éléments/pages qui peuvent être récupérés, une autre limitation peut 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 pauses 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 Disposition spécifie s’il faut retourner les articles mis au rebut plutôt que les articles en attente de mise au rebut. Les valeurs valides sont les suivantes :
- $true : Retourner les articles mis au rebut.
- $false : Retourner les éléments en attente de disposition. 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 à réviser. Les valeurs valides sont les suivantes :
- $true : les en-têtes sont retournés en tant que propriété avec les éléments à réviser. Cette option est utile lors de la conversion de la sortie en un projet PSObject dans PowerShell ou lors de l’exportation vers un fichier CSV.
- $false : les en-têtes ne sont pas renvoyés en tant que propriété avec les éléments à réviser. 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 pour commencer là où la dernière opération s’est arrêtée.
La valeur PagingCookie est retournée dans la propriété PaginationCookie chaque fois que l’applet de commande est exécutée avec succès. Si le 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 à réviser. 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 communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.