Unprotect-RMSFile
Desprotege um arquivo que está atualmente protegido pelo RMS.
Sintaxe
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.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | 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.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | 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.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | 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].
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | 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.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ProcessContainers
Esse parâmetro não está implementado no momento.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Recurse
Indica que essa operação desprotege todos os arquivos em todas as subpastas.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-SupressUI
Esse parâmetro não é implementado; não há interface do usuário para este cmdlet.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |