Get-RMSFileStatus
Obtém o status de proteção RMS de um arquivo especificado.
Sintaxe
Get-RMSFileStatus
-File <String>
[<CommonParameters>]
Description
O cmdlet Get-RMSFileStatus retorna o status de proteção (se o arquivo está protegido pelo Rights Management ou não) de um arquivo especificado.
Um arquivo protegido tem um status de Protegido (Nativo) ou Protegido (Genérico) e um arquivo desprotegido tem um status de Desprotegido.
Observe que um arquivo de contêiner protegido nativamente, como um arquivo de dados do Outlook (. PST) sempre retorna o status de proteção de Desprotegido.
Exemplos
Exemplo 1: Listar o status de proteção de um arquivo especificado
PS C:\>Get-RMSFileStatus -File "C:\Test.docx"
FileName Status
-------- ------
C:\Test.docx Unprotected
Este comando lista o status de proteção do Rights Management para o arquivo especificado C:\Test.docx.
Como um arquivo com uma extensão de nome de arquivo.docx dá suporte à proteção nativa, o status retorna "Protegido (Nativo)" ou "Desprotegido".
Exemplo 2: Listar o status de proteção para todos os arquivos em uma pasta e quaisquer subpastas
PS C:\>foreach ($file in (Get-ChildItem -Path C:\Documents -Recurse -Force | where {!$_.PSIsContainer})) {Get-RMSFileStatus -f $file.PSPath}
Embora o cmdlet Get-RMSFileStatus funcione para um arquivo por vez, você pode usar o seguinte comando Windows PowerShell para obter o status de todos os arquivos em uma pasta (em nosso exemplo, chamado C:\Documents) e suas subpastas.
O mesmo comando pode ser usado com um caminho UNC em vez de uma unidade e um caminho.
Exemplo 3: criar um arquivo .CSV com o status de proteção para todos os arquivos em uma pasta e quaisquer subpastas
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
Você pode estender ainda mais o exemplo anterior gerando os resultados para um arquivo .CSV, para que você possa classificar e ordenar as informações.
Neste exemplo, o arquivo .CSV é nomeado ProtectedFilesList.csv e salvo na pasta C:\Temp . Se o arquivo já existir, ele será substituído.
Parâmetros
-File
Especifica o caminho totalmente qualificado para o arquivo para verificar se ele está protegido pelo Rights Management.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |