Unprotect-RMSFile

  • Référence
Module:
AzureInformationProtection

Annule la protection d’un fichier actuellement protégé par RMS.

Syntax

Unprotect-RMSFile
         [-File <String>]
         [-Folder <String>]
         [-InPlace]
         [-Recurse]
         [-OutputFolder <String>]
         [-SupressUI]
         [-LogFile <String>]
         [-ProcessContainers]
         [<CommonParameters>]

Description

L’applet de commande Unprotect-RMSFile supprime la protection Rights Management (RMS) d’un ou plusieurs fichiers dans un dossier spécifié si ces fichiers étaient précédemment protégés par AD RMS ou Azure RMS.

Vous devez disposer de droits d’utilisation suffisants ou être un super utilisateur pour votre organisation afin de déprotéger les fichiers. Pour plus d’informations, consultez Configuration de super utilisateurs pour Azure Information Protection et les services de découverte ou la récupération de données.

Si vous supprimez la protection d’un fichier conteneur, chaque enfant est extrait de manière récursive, non protégé et repackagené. Les types de fichiers conteneur pris en charge sont .zip, .rar, .7z, .msg et .pst.

Pour les fichiers .pst , 5 Go est la taille de fichier maximale prise en charge avec cette applet de commande.

Lorsque vous exécutez cette applet de commande, vous disposez des options suivantes :

  • Le fichier n’est pas protégé dans le même dossier afin que le fichier protégé d’origine et le nouveau fichier non protégé coexistent.

  • Le fichier d’origine reste protégé et une version non protégée du fichier est créée à un autre emplacement.

  • Tous les fichiers du dossier spécifié ne sont pas protégés à l’emplacement actuel, en remplaçant les fichiers d’origine protégés.

  • Tous les fichiers du dossier spécifié restent protégés et une version non protégée de chaque fichier est créée à un autre emplacement.

Vous pouvez exécuter cette commande simultanément lorsque vous spécifiez un chemin d’accès différent pour le paramètre LogFile pour chaque commande qui s’exécute en parallèle. Si vous ne spécifiez pas de chemin d’accès de fichier journal différent et que la commande précédente n’a pas terminé, la nouvelle commande échoue.

Exemples

Exemple 1 : Annuler la protection d’un seul fichier, en remplaçant le fichier d’origine

PS C:\>Unprotect-RMSFile -File "C:\Test.ptxt" -InPlace
InputFile         DecryptedFile
---------         -------------
C:\Test.ptxt      C:\ Test.txt

Cette commande annule la protection d’un seul fichier nommé Test.ptxt, en remplaçant cette version protégée du fichier par une version non protégée dans le même emplacement. Lorsqu’un répertoire de sortie n’est pas fourni et que le paramètre InPlace est spécifié, le fichier source est remplacé.

Exemple 2 : Annuler la protection d’un seul fichier, en conservant le fichier d’origine

PS C:\>Unprotect-RMSFile -File "C:\Test.ptxt" -OutputFolder "C:\Temp"
InputFile       DecryptedFile
---------       -------------
C:\Test.ptxt    C:\Temp\Test.txt

Cette commande annule la protection d’un seul fichier, mais conserve le fichier protégé d’origine en créant la version non protégée dans l’emplacement du dossier nommé C:\Temp. Lorsqu’un dossier de sortie est fourni, un nom de fichier unique est créé pour le fichier non protégé. Si un fichier du même nom existe, le nouveau nom de fichier est rendu unique de la même façon que Explorateur de fichiers effectue une copie unique du même nom de fichier. Par exemple, si Test.txt existe, test Copy.txt est créé, puis copie de test(2).txt.

Exemple 3 : Annuler la protection d’un dossier

PS C:\>Unprotect-RMSFile -Folder "C:\Protected" -OutputFolder "C:\Temp"
InputFile                  DecryptedFile
---------                  -------------
C:\Protected\Test.ptxt     C:\Temp\Protected\Test.txt

C:\Protected\Word.docx     C:\Temp\Protected\Word.docx

Cette commande annule la protection d’un dossier, la conservation des fichiers protégés d’origine et la création des versions non protégées dans l’emplacement du dossier nommé C:\Temp et crée un sous-dossier correspondant de « Protected ».

Cette commande peut également être utilisée avec le paramètre Recurse , qui détermine s’il faut inclure le traitement des sous-dossiers.

Exemple 4 : Annuler la protection d’un . Fichier PST

PS C:\>Unprotect-RMSFile -File "C:\Test.pst" -OutputFolder "C:\Temp"
InputFile     DecryptedFile
---------     -------------
C:\Test.pst   C:\Temp\Test.pst

Cette commande supprime la protection d’un fichier .pst (Table de stockage personnel), qui sont des fichiers conteneur pouvant contenir des fichiers Microsoft Outlook .msg .

À son tour, ces fichiers .msg peuvent être des conteneurs qui contiennent des pièces jointes. Étant donné que le fichier .pst est un conteneur, chaque fichier enfant et conteneur imbriqué sont également non protégés par cette opération.

Exemple 5 : Annuler la protection d’un fichier .RAR

PS C:\>Unprotect-RMSFile -File "C:\Test.rar" -OutputFolder "C:\Temp"
InputFile     DecryptedFile
---------     -------------
C:\Test.rar   C:\Temp\Test.zip

Cette commande supprime la protection d’un fichier d’archivage.rar . Étant donné que.rar fichiers sont des fichiers conteneur qui contiennent des fichiers imbriqués, ces fichiers imbriqués peuvent également être des archives. Chaque fichier enfant et conteneur imbriqué sont également non protégés par cette opération.

Notez que pour un fichier d’entrée .rar , le fichier non protégé est un fichier .zip .

Paramètres

-File

Spécifie le chemin d’accès et le fichier à déprotéger. Pour le chemin d’accès, vous pouvez spécifier une lettre de lecteur ou UNC.

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

-Folder

Spécifie le chemin d’accès et le dossier à déprotéger. Tous les fichiers du dossier spécifié ne seront pas protégés.

Pour le chemin d’accès, vous pouvez spécifier une lettre de lecteur ou UNC.

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

-InPlace

Le fichier ou les fichiers du dossier spécifié ne sont pas protégés à l’emplacement actuel, en remplaçant le fichier ou les fichiers protégés d’origine. Ce paramètre est ignoré si le paramètre OutputFolder est spécifié.

Si ni InPlace ni OutputFolder n’est spécifié, le nouveau fichier est créé dans le répertoire actif avec « -Copy » ajouté au nom de fichier, en utilisant la même convention d’affectation de noms que celle utilisée par Explorateur de fichiers lorsqu’un fichier est copié et collé dans le même dossier. Par exemple, si un fichier avec Document.docx est protégé, la version non protégée est nommée Document-Copy.docx. Si un fichier nommé Document-Copy.docx existe déjà, Document-Copy(2).docx est créé, et ainsi de suite.

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

-LogFile

Spécifie le chemin d’accès et le nom de fichier de base, avec l’extension de nom de fichier facultative pour les fichiers journaux. Ces fichiers journaux répertorient les fichiers qui sont correctement ou non protégés sans succès. Les trois fichiers journaux suivants sont créés respectivement pour la réussite, l’échec et le débogage :

  • <nom du> fichier.< extension de nom de fichier>

  • <échec du nom> de fichier.< extension de nom de fichier>

  • <nom> de fichier -debug.< extension de nom de fichier>

Pour les fichiers conteneur, ces fichiers journaux incluent également des fichiers imbriqués.

Par exemple, si vous spécifiez C:\Users\Administrator\Unprotect-RMSFile.txt pour ce paramètre, les fichiers journaux suivants sont créés :

  • Pour les fichiers qui ont été correctement protégés : C:\Users\Administrator\Unprotect-RMSFile.txt

  • Pour tous les fichiers qui n’ont pas pu être non protégés : C:\Users\Administrator\Unprotect-RMSFile-failure.txt

  • Pour plus d’informations sur le débogage : C:\Users\Administrator\Unprotect-RMSFile-debug.txt

Pour le chemin d’accès, vous pouvez spécifier une lettre de lecteur ou UNC.

Si vous ne spécifiez pas ce paramètre, les fichiers journaux Success.log, Failure.log et Debug.log sont écrits à l’emplacement du fichier journal par défaut de %localappdata%\Microsoft\MSIPC\pscmdlet\Logs[GUID].

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

-OutputFolder

Spécifie le dossier de sortie pour les versions non protégées des fichiers protégés. La structure de dossiers d’origine est conservée, ce qui signifie que les sous-dossiers peuvent être créés pour votre valeur spécifiée.

Pour le chemin d’accès, vous pouvez utiliser une lettre de lecteur ou UNC.

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

-ProcessContainers

Ce paramètre n’est pas implémenté actuellement.

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

-Recurse

Indique que cette opération supprime la protection de tous les fichiers dans tous les sous-dossiers.

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

-SupressUI

Ce paramètre n’est pas implémenté ; il n’existe aucune interface utilisateur pour cette applet de commande.

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