Partager via

Get-FileStatus

  • Référence
Module:
PurviewInformationProtection

Obtient les informations d’étiquette et de protection Protection des données Microsoft Purview pour un ou plusieurs fichiers spécifiés.

Syntax

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

Description

L’applet de commande Get-FileStatus retourne le status d’un fichier spécifié ou de tous les fichiers d’un chemin d’accès spécifié. Cette status indique si le fichier a une étiquette et, le cas échéant, le nom de l’étiquette, qui l’a appliqué, comment il a été appliqué et quand.

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

Le status retourné dans l’applet de commande Get-FileStatus indique également si le fichier est protégé par Rights Management et, le cas échéant, quel modèle Rights Management a été 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 à la place du nom du modèle. En outre, le propriétaire de Rights Management et l’émetteur Rights Management s’affichent 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 la status de protection false.

Vous pouvez exécuter cette applet de commande de manière non interactive.

Exemples

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

PS C:\> Get-FileStatus -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é « Confidentiel \ Groupe 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 - Confidential Finance ».

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

PS C:\> Get-FileStatus -Path \\Finance\Projects\ | Export-Csv C:\Reports\Report.csv

Cette commande obtient les informations d’étiquette et de protection de tous les fichiers sur le serveur Finance, dans le dossier Projects et l’un de ses sous-dossiers. Les résultats sont exportés vers le fichier nommé Report.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 sera remplacé.

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

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

Cette commande obtient les informations d’étiquette et de protection uniquement pour les fichiers étiquetés « Confidentiels » (quelle que soit leur sous-étiquette) sur le serveur Finance, dans le dossier Projets et l’un de ses sous-dossiers. Les résultats sont exportés vers le fichier nommé Report.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 sera remplacé.

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

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

5

Cette commande fournit le nombre de fichiers avec l’étiquette « Confidentiel » qui se trouvent 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 d’accès 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 d’accès entre 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