Get-AIPFileStatus

  • Référence
Module:
AzureInformationProtection

Obtient les informations d’étiquette et de protection d’Azure Information Protection pour un fichier ou des fichiers spécifiés.

Syntax

Get-AIPFileStatus
   [-Path] <String[]>
   [<CommonParameters>]

Description

L’applet de commande Get-AIPFileStatus retourne l’état d’Azure Information Protection d’un fichier spécifié ou de tous les fichiers d’un chemin d’accès spécifié. Cet état inclut si le fichier a une étiquette et, s’il le fait, le nom de l’étiquette, qui l’a appliqué, la façon dont il a été appliqué et quand.

Si vos fichiers sont stockés dans SharePoint Online, utilisez l’applet de commande Get-FileSensitivityLabelInfo à partir du module SharePointOnlinePowerShell à la place.

L’état retourné dans l’applet de commande Get-AIPFileStatus inclut également si le fichier est protégé par Rights Management, et s’il s’agit de ce modèle Rights Management utilisé pour appliquer cette protection. Si le fichier a été protégé avec des autorisations personnalisées (une stratégie de droits ad hoc) au lieu d’un modèle, « Accès restreint » s’affiche au lieu du nom du modèle. En outre, le propriétaire rights Management et l’émetteur Rights Management sont affichés et lorsque le fichier a été protégé.

Cette applet de commande retourne les informations d’étiquette de votre propre locataire uniquement.

Notez que les fichiers protégés par mot de passe retournent toujours l’état de protection false.

Vous pouvez exécuter cette applet de commande de manière non interactive. Pour plus d’informations, consultez le guide d’administration du client d’étiquetage unifié.

Exemples

Exemple 1 : Obtenir l’état d’étiquette et de protection d’un seul fichier

PS C:\> Get-AIPFileStatus -Path \\Finance\Projects\Project.docx

FileName        : \\Finance\Projects\Project.docx
IsLabeled       : True
MainLabelId     : 074e257c-1234-1234-1234-34a182080e71
MainLabelName   : Confidential
SubLabelId      : d9f23ae3-1234-1234-1234-f515f824c57b
SubLabelName    : Finance group
LabelingMethod  : Privileged
LabelDate       : 12/12/2016 12:24:36 PM
IsRMSProtected  : True
RMSTemplateId   : e6ee2481-1234-1234-1234-f744eacd53b0
RMSTemplateName : Contoso - Confidential Finance
RMSOwner        : John@Contoso.com
RMSIssuer       : John@Contoso.com
ContentId       : 4ca757d2-83bf-4ec3-b93b-c7fe9433bf33

Cette commande fournit des informations sur un fichier étiqueté « Groupe Confidentiel \ Finance », qui est une étiquette configurée pour votre locataire. Ce fichier a été étiqueté manuellement par John et il est également protégé à l’aide du modèle Rights Management, « Contoso - Confidentiel Finance ».

Exemple 2 : Obtenir l’état d’étiquette et de protection pour tous les fichiers d’un dossier et exporter les résultats dans un fichier CSV

PS C:\> Get-AIPFileStatus -Path \\Finance\Projects\ | Export-Csv C:\Reports\AIP-status.csv

Cette commande obtient les informations d’étiquette et de protection de tous les fichiers sur le serveur Finance, dans le dossier Projets et dans l’un de ses sous-dossiers. Les résultats sont exportés vers le fichier nommé AIP-status.csv afin qu’ils puissent être plus facilement recherchés et triés. Si un rapport précédent existe dans C:\Reports\Report.csv, il est remplacé.

Exemple 3 : Répertorier les fichiers étiquetés « Confidentiel » et exporter les résultats dans un fichier CSV

PS C:\> Get-AIPFileStatus -Path \\Finance\Projects\ | Where-Object {$_.MainLabelName -eq 'Confidential'} | Export-Csv C:\Reports\AIP-status.csv

Cette commande obtient les informations d’étiquette et de protection pour uniquement les fichiers étiquetés « Confidentiels » (quelle que soit leur sous-étiquette) sur le serveur Finance, dans le dossier Projets et tous ses sous-dossiers. Les résultats sont exportés vers le fichier nommé AIP-status.csv afin qu’ils puissent être plus facilement recherchés et triés. Si un rapport précédent existe dans C:\Reports\Report.csv, il est remplacé.

Exemple 4 : Nombre de fichiers avec une étiquette « Confidentiel »

PS C:\> (Get-AIPFileStatus -Path C:\Projects\ | Where-Object {$_.MainLabelName -eq 'Confidential'}).Count

5

Cette commande fournit le nombre de fichiers avec l’étiquette « Confidentiel » qui se trouve dans le dossier C:\Projects et l’un de ses sous-dossiers. Dans cet exemple, 5 fichiers sont trouvés.

Paramètres

-Path

Spécifie un chemin d’accès local, un chemin d’accès réseau ou une URL SharePoint Server aux fichiers pour lesquels vous souhaitez obtenir les informations d’étiquette et de protection. Les caractères génériques ne sont pas pris en charge.

Pour les chemins SharePoint, les éléments suivants sont pris en charge :

  • SharePoint Server 2019
  • Serveur SharePoint 2016
  • SharePoint Server 2013

Par exemple :

Les chemins d’accès peuvent inclure des espaces lorsque vous placez la valeur du chemin avec des guillemets.

Type:String[]
Aliases:FullName, FileName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entrées

System.String[]

Sorties

Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult