Get-AIPFileStatus
Obtient les informations d’étiquette et de protection d’Azure Information Protection pour un fichier ou des fichiers spécifiés.
Syntaxe
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 :
- C:\Folder\
- C:\Folder\Nom de fichier
- \\Server\Folder
- http://sharepoint.contoso.com/Shared%20Documents/Folder
Les chemins d’accès peuvent inclure des espaces lorsque vous placez la valeur du chemin avec des guillemets.
Type: | String[] |
Alias: | FullName, FileName |
Position: | 0 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
Entrées
System.String[]
Sorties
Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult