Get-RMSFileStatus

Referência

Módulo:: AzureInformationProtection

Obtém o status de proteção RMS de um arquivo especificado.

Syntax

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.

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