Share via

Get-RMSFileStatus

  • Referência
Módulo:
AzureInformationProtection

Obtém o estado de proteção RMS de um ficheiro especificado.

Syntax

Get-RMSFileStatus
   -File <String>
   [<CommonParameters>]

Description

O cmdlet Get-RMSFileStatus devolve o estado de proteção (quer o ficheiro esteja protegido pela Gestão de Direitos ou não) de um ficheiro especificado.

Um ficheiro protegido tem um estatuto de Protegido (Nativo) ou Protegido (Genérico), e um ficheiro desprotegido tem um estatuto de desprotegido.

Note que um ficheiro de contentor protegido nativo, como um ficheiro de dados do Outlook (. PST) devolve sempre o estado de proteção de Desprotegido.

Exemplos

Exemplo 1: Listar o estado de proteção de um ficheiro especificado

PS C:\>Get-RMSFileStatus -File "C:\Test.docx"
FileName             Status
--------             ------
C:\Test.docx         Unprotected

Este comando lista o estado de proteção da gestão de direitos para o ficheiro especificado C:\Test.docx.

Como um ficheiro com uma extensão de nome de ficheiro.docx suporta a proteção nativa, o estado devolve "Protected (Native)" ou "Desprotegido".

Exemplo 2: Listar o estado de proteção de todos os ficheiros numa pasta e de quaisquer sub-dobradores

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 ficheiro de cada vez, pode utilizar o seguinte comando Windows PowerShell para obter o estado de todos os ficheiros numa pasta (no nosso exemplo, denominado C:\Documentos) e suas sub-dobradinhas.

O mesmo comando pode ser usado com um caminho UNC em vez de uma unidade e caminho.

Exemplo 3: Criar um ficheiro .CSV com o estado de proteção de todos os ficheiros de uma pasta e de quaisquer sub-dobradores

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

Pode ainda alargar o exemplo anterior, desemlatando os resultados para um ficheiro .CSV, para que possa ordenar e encomendar a informação.

Neste exemplo, o ficheiro .CSV é nomeado ProtectedFilesList.csv e guardado na pasta C:\Temp . Se o ficheiro já existir, será substituído.

Parâmetros

-File

Especifica o caminho totalmente qualificado para o ficheiro para verificar se está protegido pela Gestão de Direitos.

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