Get-RMSFileStatus
Obtiene el estado de protección de RMS de un archivo especificado.
Sintaxis
Get-RMSFileStatus
-File <String>
[<CommonParameters>]
Description
El cmdlet Get-RMSFileStatus devuelve el estado de protección (si el archivo está protegido por Rights Management o no) de un archivo especificado.
Un archivo protegido tiene un estado protegido (nativo) o protegido (genérico) y un archivo no protegido tiene el estado Desprotegido.
Tenga en cuenta que un archivo de contenedor protegido de forma nativa, como un archivo de datos de Outlook (. PST) siempre devuelve el estado de protección de Desprotegido.
Ejemplos
Ejemplo 1: Enumerar el estado de protección de un archivo especificado
PS C:\>Get-RMSFileStatus -File "C:\Test.docx"
FileName Status
-------- ------
C:\Test.docx Unprotected
Este comando enumera el estado de protección de Rights Management para el archivo especificado C:\Test.docx.
Dado que un archivo con una extensión de nombre de archivo.docx admite la protección nativa, el estado devuelve "Protegido (nativo)" o "Desprotegido".
Ejemplo 2: Enumerar el estado de protección de todos los archivos de una carpeta y todas las subcarpetas
PS C:\>foreach ($file in (Get-ChildItem -Path C:\Documents -Recurse -Force | where {!$_.PSIsContainer})) {Get-RMSFileStatus -f $file.PSPath}
Aunque el cmdlet Get-RMSFileStatus funciona para un archivo a la vez, puede usar el siguiente comando Windows PowerShell para obtener el estado de todos los archivos de una carpeta (en nuestro ejemplo, denominado C:\Documents) y sus subcarpetas.
El mismo comando se puede usar con una ruta de acceso UNC en lugar de una unidad y una ruta de acceso.
Ejemplo 3: Crear un archivo .CSV con el estado de protección de todos los archivos de una carpeta y todas las subcarpetas
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
Puede ampliar aún más el ejemplo anterior mediante la salida de los resultados a un archivo .CSV, para que pueda ordenar y ordenar la información.
En este ejemplo, el archivo .CSV se denomina ProtectedFilesList.csv y se guarda en la carpeta C:\Temp . Si el archivo ya existe, se sobrescribirá.
Parámetros
-File
Especifica la ruta de acceso completa al archivo para comprobar si está protegida por Rights Management.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |