Unprotect-RMSFile

Referencia

Módulo:: AzureInformationProtection

Desprotege un archivo que está protegido actualmente por RMS.

Syntax

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

Description

El cmdlet Unprotect-RMSFile quita la protección de Rights Management (RMS) de uno o varios archivos de una carpeta especificada si esos archivos estaban protegidos previamente por AD RMS o Azure RMS.

Debe tener suficientes derechos de uso o ser un superusuario para que su organización desproteja los archivos. Para más información, consulte Configuración de superusuarios para Azure Information Protection y servicios de detección o recuperación de datos.

Si desprotege un archivo de contenedor, cada elemento secundario se extrae, desprotege y vuelve a empaquetar de forma recursiva. Los tipos de archivo de contenedor admitidos son .zip, .rar, .7z, .msg y .pst.

En el caso de los archivos .pst , 5 GB es el tamaño máximo de archivo admitido con este cmdlet.

Al ejecutar este cmdlet, tiene las siguientes opciones:

El archivo no está protegido en la misma carpeta para que coexista el archivo protegido original y el nuevo archivo no protegido.
El archivo original permanece protegido y se crea una versión desprotegida del archivo en otra ubicación.
Todos los archivos de la carpeta especificada no están protegidos en la ubicación actual, reemplazando los archivos originales protegidos.
Todos los archivos de la carpeta especificada permanecen protegidos y se crea una versión desprotegida de cada archivo en otra ubicación.

Puede ejecutar este comando simultáneamente cuando especifique una ruta de acceso diferente para el parámetro LogFile para cada comando que se ejecute en paralelo. Si no especifica una ruta de acceso de archivo de registro diferente y el comando anterior no ha terminado, se producirá un error en el nuevo comando.

Ejemplos

Ejemplo 1: Desproteger un único archivo, reemplazando el archivo original

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

Este comando desprotege un único archivo denominado Test.ptxt, reemplazando esta versión protegida del archivo por una versión desprotegida en la misma ubicación. Cuando no se proporciona un directorio de salida y se especifica el parámetro InPlace , se reemplaza el archivo de origen.

Ejemplo 2: Desprotección de un único archivo, conservando el archivo original

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

Este comando desprotege un único archivo, pero conserva el archivo protegido original mediante la creación de la versión desprotegida en la ubicación de la carpeta denominada C:\Temp. Cuando se proporciona una carpeta de salida, se crea un nombre de archivo único para el archivo no protegido. Si existe un archivo con el mismo nombre, el nuevo nombre de archivo se convierte en único de la misma manera que Explorador de archivos hace una copia única del mismo nombre de archivo. Por ejemplo, si Test.txt existe, se crea Copy.txtde prueba y, a continuación, copia de prueba(2).txt.

Ejemplo 3: Desproteger una carpeta

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

Este comando desprotege una carpeta, conserva los archivos protegidos originales y crea las versiones desprotegidas en la ubicación de la carpeta denominada C:\Temp y crea una subcarpeta correspondiente de "Protegido".

Este comando también se puede usar con el parámetro Recurse , que determina si se debe incluir el procesamiento de subcarpetas.

Ejemplo 4: Desproteger un objeto . Archivo PST

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

Este comando desprotege un archivo .pst (tabla de almacenamiento personal), que son archivos de contenedor que pueden contener archivos .msg de Microsoft Outlook.

A su vez, estos archivos .msg pueden ser contenedores que contienen datos adjuntos. Dado que el archivo .pst es un contenedor, cada archivo secundario y contenedor anidado también están desprotegidos por esta operación.

Ejemplo 5: Desproteger un archivo de .RAR

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

Este comando desprotege un archivo de.rar archivo. Dado que.rar archivos son archivos de contenedor que contienen archivos anidados, estos archivos anidados también pueden ser archivos. Esta operación también desprotegi cada archivo secundario y contenedor anidado.

Observe que para un archivo de entrada de.rar , el archivo no protegido es un archivo .zip .

Parámetros

-File

Especifica la ruta de acceso y el archivo que se van a desproteger. Para la ruta de acceso, puede especificar una letra de unidad o UNC.

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

-Folder

Especifica la ruta de acceso y la carpeta que se va a desproteger. Todos los archivos de la carpeta especificada no estarán protegidos.

Para la ruta de acceso, puede especificar una letra de unidad o UNC.

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

-InPlace

El archivo o los archivos de la carpeta especificada no están protegidos en la ubicación actual, reemplazando el archivo o los archivos protegidos originales. Este parámetro se omite si se especifica el parámetro OutputFolder .

Si no se especifica InPlace ni OutputFolder, el nuevo archivo se crea en el directorio actual con "-Copy" anexado al nombre de archivo, utilizando la misma convención de nomenclatura que Explorador de archivos usa cuando se copia y pega un archivo en la misma carpeta. Por ejemplo, si un archivo con Document.docx está protegido, la versión desprotegida se denomina Document-Copy.docx. Si ya existe un archivo denominado Document-Copy.docx , se crea document-copy(2).docx , etc.

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

-LogFile

Especifica la ruta de acceso y el nombre de archivo base, con la extensión de nombre de archivo opcional para los archivos de registro. Estos archivos de registro enumeran los archivos que no están protegidos correctamente o sin éxito. Los tres archivos de registro siguientes se crean para éxito, error y depuración, respectivamente:

<nombre de> archivo.< extensión de nombre de archivo>
<file name-failure>.< extensión de nombre de archivo>
<file name-debug>.< extensión de nombre de archivo>

En el caso de los archivos de contenedor, estos archivos de registro también incluyen archivos anidados.

Por ejemplo, si especifica C:\Users\Administrator\Unprotect-RMSFile.txt para este parámetro, se crean los siguientes archivos de registro:

Para los archivos que se desprotegieron correctamente: C:\Users\Administrator\Unprotect-RMSFile.txt
Para los archivos que no se pudieron desprotegir: C:\Users\Administrator\Unprotect-RMSFile-failure.txt
Para obtener información de depuración: C:\Users\Administrator\Unprotect-RMSFile-debug.txt

Para la ruta de acceso, puede especificar una letra de unidad o UNC.

Si no especifica este parámetro, los archivos de registro Success.log, Failure.log y Debug.log se escriben en la ubicación predeterminada del archivo de registro 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

Especifica la carpeta de salida para las versiones desprotegidas de los archivos protegidos. Se mantiene la estructura de carpetas original, lo que significa que se pueden crear subcarpetas para el valor especificado.

Para la ruta de acceso, puede usar una letra de unidad o UNC.

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

-ProcessContainers

Este parámetro no está implementado actualmente.

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

-Recurse

Indica que esta operación desprotege todos los archivos de todas las subcarpetas.

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

-SupressUI

Este parámetro no se implementa; no hay ninguna interfaz de usuario para este cmdlet.

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

Protect-RMSFile