Unprotect-RMSFile

  • Referência
Módulo:
AzureInformationProtection

Desprotege um arquivo que está atualmente protegido pelo RMS.

Syntax

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

Description

O cmdlet Unprotect-RMSFile remove a proteção do Rights Management (RMS) de um ou mais arquivos em uma pasta especificada se esses arquivos foram protegidos anteriormente pelo AD RMS ou pelo Azure RMS.

Você deve ter direitos de uso suficientes ou ser um superusuário para sua organização desproteger arquivos. Para obter mais informações, consulte Configurar superusuários para o Azure Proteção de Informações e serviços de descoberta ou recuperação de dados.

Se você estiver desprotegindo um arquivo de contêiner, cada criança será extraída, desprotegida e reempacotada recursivamente. Os tipos de arquivo de contêiner com suporte são .zip, .rar, .7z, .msg e .pst.

Para arquivos .pst , 5 GB é o tamanho máximo do arquivo com suporte com esse cmdlet.

Ao executar este cmdlet, você tem as seguintes opções:

  • O arquivo está desprotegido na mesma pasta para que o arquivo protegido original e o novo arquivo desprotegido coexistam.

  • O arquivo original permanece protegido e uma versão desprotegida do arquivo é criada em outro local.

  • Todos os arquivos na pasta especificada estão desprotegidos no local atual, substituindo os arquivos originais que foram protegidos.

  • Todos os arquivos na pasta especificada permanecem protegidos e uma versão desprotegida de cada arquivo é criada em outro local.

Você pode executar esse comando simultaneamente quando especificar um caminho diferente para o parâmetro LogFile para cada comando executado em paralelo. Se você não especificar um caminho de arquivo de log diferente e o comando anterior não tiver terminado, o novo comando falhará.

Exemplos

Exemplo 1: Desproteger um único arquivo, substituindo o arquivo original

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

Esse comando desprotege um único arquivo chamado Test.ptxt, substituindo essa versão protegida do arquivo por uma versão desprotegida no mesmo local. Quando um diretório de saída não é fornecido e o parâmetro InPlace é especificado, o arquivo de origem é substituído.

Exemplo 2: Desproteger um único arquivo, retendo o arquivo original

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

Esse comando desprotege um único arquivo, mas retém o arquivo protegido original criando a versão desprotegida no local da pasta chamado C:\Temp. Quando uma pasta de saída é fornecida, um nome de arquivo exclusivo é criado para o arquivo desprotegido. Se existir um arquivo com o mesmo nome, o novo nome de arquivo será exclusivo da mesma forma que Explorador de Arquivos faz uma cópia exclusiva do mesmo nome de arquivo. Por exemplo, se Test.txt existir, a Copy.txtde teste será criada e, em seguida, a Cópia de Teste(2).txt.

Exemplo 3: Desproteger uma pasta

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

Esse comando desprotege uma pasta, retendo os arquivos protegidos originais e criando as versões desprotegidas no local da pasta chamado C:\Temp e cria uma subpasta correspondente de "Protegido".

Esse comando também pode ser usado com o parâmetro Recurse , que determina se deve incluir o processamento de subpastas.

Exemplo 4: desproteger um . Arquivo PST

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

Esse comando desprotege um arquivo .pst (Tabela de Armazenamento Pessoal), que são arquivos de contêiner que podem conter arquivos .msg do Microsoft Outlook.

Por sua vez, esses arquivos .msg podem ser contêineres que contêm anexos. Como o arquivo .pst é um contêiner, cada arquivo filho e contêiner aninhado também são desprotegidos por essa operação.

Exemplo 5: Desproteger um arquivo .RAR

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

Esse comando desprotege um arquivo de arquivo de arquivo de.rar . Como .rar arquivos são arquivos de contêiner que contêm arquivos aninhados, esses arquivos aninhados também podem ser arquivos. Cada arquivo filho e contêiner aninhado também são desprotegidos por essa operação.

Observe que, para um arquivo de entrada.rar , o arquivo desprotegido é um arquivo .zip .

Parâmetros

-File

Especifica o caminho e o arquivo a serem desprotegidos. Para o caminho, você pode especificar uma letra de unidade ou UNC.

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

-Folder

Especifica o caminho e a pasta a serem desprotegidos. Todos os arquivos na pasta especificada serão desprotegidos.

Para o caminho, você pode especificar uma letra de unidade ou UNC.

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

-InPlace

O arquivo ou os arquivos na pasta especificada estão desprotegidos no local atual, substituindo o arquivo ou arquivos protegidos originais. Esse parâmetro será ignorado se o parâmetro OutputFolder for especificado.

Se nem InPlace nem OutputFolder forem especificados, o novo arquivo será criado no diretório atual com "-Copy" acrescentado ao nome do arquivo, usando a mesma convenção de nomenclatura que Explorador de Arquivos usa quando um arquivo é copiado e colado na mesma pasta. Por exemplo, se um arquivo com Document.docx estiver protegido, a versão desprotegida será nomeada Document-Copy.docx. Se um arquivo chamado Document-Copy.docx já existir, .docxde Cópia de Documento(2) será criado e assim por diante.

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

-LogFile

Especifica o caminho e o nome do arquivo base, com a extensão de nome de arquivo opcional para arquivos de log. Esses arquivos de log listam os arquivos que foram desprotegidos com êxito ou sem sucesso. Os três arquivos de log a seguir são criados para êxito, falha e depuração, respectivamente:

  • <nome> do arquivo.< extensão de nome de arquivo>

  • <falha no nome> do arquivo.< extensão de nome de arquivo>

  • <nome-depuração> do arquivo.< extensão de nome de arquivo>

Para arquivos de contêiner, esses arquivos de log também incluem arquivos aninhados.

Por exemplo, se você especificar C:\Users\Administrator\Unprotect-RMSFile.txt para esse parâmetro, os seguintes arquivos de log serão criados:

  • Para arquivos que foram desprotegidos com êxito: C:\Users\Administrator\Unprotect-RMSFile.txt

  • Para arquivos que não puderam ser desprotegidos: C:\Users\Administrator\Unprotect-RMSFile-failure.txt

  • Para obter informações de depuração: C:\Users\Administrator\Unprotect-RMSFile-debug.txt

Para o caminho, você pode especificar uma letra de unidade ou UNC.

Se você não especificar esse parâmetro, os arquivos de log Success.log, Failure.log e Debug.log serão gravados no local padrão do arquivo de log 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 a pasta de saída para versões desprotegidas dos arquivos protegidos. A estrutura de pasta original é mantida, o que significa que as subpastas podem ser criadas para o valor especificado.

Para o caminho, você pode usar uma letra de unidade ou UNC.

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

-ProcessContainers

Esse parâmetro não está implementado no momento.

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

-Recurse

Indica que essa operação desprotege todos os arquivos em todas as subpastas.

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

-SupressUI

Esse parâmetro não é implementado; não há interface do usuário para este cmdlet.

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