Get-FileStatus

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

L’applet de commande Get-FileStatus renvoie l’état d’un fichier spécifié ou de tous les fichiers d’un chemin d’accès spécifié. Cet état indique si le fichier possède 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 l’applet de commande Get-FileSensitivityLabelInfo à partir du module SharePointOnlinePowerShell .

L’état renvoyé 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é par des autorisations personnalisées (une politique 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 et l’émetteur de Rights Management sont affichés, ainsi que la date à laquelle le fichier a été protégé.

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

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

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

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 financier », 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 - Finance confidentielle ».

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

Cette commande récupère l’étiquette et les informations 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 dans 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 écrasé.

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

Cette commande obtient l’étiquette et les informations de protection uniquement pour les fichiers étiquetés « Confidentiel » (quel que soit leur sous-label) sur le serveur Finance, dans le dossier Projets et dans l’un de ses sous-dossiers. Les résultats sont exportés dans 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 écrasé.

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

5

Cette commande fournit le nombre de fichiers portant 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.

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.