Get-RMSFileStatus

Obtient l’état de protection RMS d’un fichier spécifié.

Syntax

Get-RMSFileStatus
   -File <String>
   [<CommonParameters>]

Description

L’applet de commande Get-RMSFileStatus retourne l’état de protection (que le fichier soit protégé par Rights Management ou non) d’un fichier spécifié.

Un fichier protégé a l’état Protégé (Natif) ou Protégé (Générique) et un fichier non protégé a l’état Non protégé.

Notez qu’un fichier conteneur protégé en mode natif, tel qu’un fichier de données Outlook (. PST) retourne toujours l’état de protection non protégé.

Exemples

Exemple 1 : Répertorier l’état de protection d’un fichier spécifié

PS C:\>Get-RMSFileStatus -File "C:\Test.docx"
FileName             Status
--------             ------
C:\Test.docx         Unprotected

Cette commande répertorie l’état de protection Rights Management pour le fichier spécifié C:\Test.docx.

Étant donné qu’un fichier avec une extension de nom de fichier.docx prend en charge la protection native, l’état retourne « Protégé (natif) » ou « Non protégé ».

Exemple 2 : Répertorier l’état de protection de tous les fichiers d’un dossier et de tous les sous-dossiers

PS C:\>foreach ($file in (Get-ChildItem -Path C:\Documents -Recurse -Force | where {!$_.PSIsContainer})) {Get-RMSFileStatus -f $file.PSPath}

Bien que l’applet de commande Get-RMSFileStatus fonctionne pour un fichier à la fois, vous pouvez utiliser la commande Windows PowerShell suivante pour obtenir l’état de tous les fichiers d’un dossier (dans notre exemple, nommé C:\Documents) et ses sous-dossiers.

La même commande peut être utilisée avec un chemin UNC au lieu d’un lecteur et d’un chemin d’accès.

Exemple 3 : Créer un fichier .CSV avec l’état de protection de tous les fichiers d’un dossier et de tous les sous-dossiers

PS C:\>$(foreach ($file in (Get-ChildItem -Path C:\Documents\ -Recurse -Force | where {!$_.PSIsContainer})) {Get-RMSFileStatus -f $file.PSPath}) | Export-Csv -Path C:\Temp\ProtectedFilesList.csv -Encoding ascii -NoTypeInformation

Vous pouvez étendre davantage l’exemple précédent en plaçant les résultats dans un fichier .CSV, afin de pouvoir trier et classer les informations.

Dans cet exemple, le fichier .CSV est nommé ProtectedFilesList.csv et enregistré dans le dossier C:\Temp . Si le fichier existe déjà, il sera remplacé.

Paramètres

-File

Spécifie le chemin complet du fichier pour vérifier s’il est protégé par Rights Management.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False