Unprotect-RMSFile

Riferimento

Modulo:: AzureInformationProtection

Rimuove la protezione di un file attualmente protetto da RMS.

Sintassi

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

Descrizione

Il cmdlet Unprotect-RMSFile rimuove la protezione di Rights Management (RMS) da uno o più file in una cartella specificata se tali file sono stati precedentemente protetti da AD RMS o Azure RMS.

Per rimuovere la protezione dei file, è necessario disporre di diritti di utilizzo sufficienti o essere un utente con privilegi avanzati per l'organizzazione. Per altre informazioni, vedere Configuring super users for Azure Information Protection and discovery services or data recovery .For more information, see Configuring super users for Azure Information Protection and discovery services or data recovery.

Se si annulla la protezione di un file contenitore, ogni elemento figlio viene estratto, non protetto e ripacchetto in modo ricorsivo. I tipi di file di contenitore supportati sono .zip, .rar, .7z, .msg e pst.

Per i file PST , 5 GB è la dimensione massima supportata con questo cmdlet.

Quando si esegue questo cmdlet, sono disponibili le opzioni seguenti:

Il file non è protetto nella stessa cartella in modo che il file protetto originale e il nuovo file non protetto coesistono.
Il file originale rimane protetto e viene creata una versione non protetta del file in un altro percorso.
Tutti i file nella cartella specificata non sono protetti nel percorso corrente, sostituendo i file originali protetti.
Tutti i file nella cartella specificata rimangono protetti e viene creata una versione non protetta di ogni file in un altro percorso.

È possibile eseguire questo comando contemporaneamente quando si specifica un percorso diverso per il parametro LogFile per ogni comando eseguito in parallelo. Se non si specifica un percorso del file di log diverso e il comando precedente non è stato completato, il nuovo comando avrà esito negativo.

Esempio

Esempio 1: Rimuovere la protezione di un singolo file, sostituendo il file originale

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

Questo comando rimuove la protezione di un singolo file denominato Test.ptxt, sostituendo questa versione protetta del file con una versione non protetta nello stesso percorso. Quando non viene specificata una directory di output e viene specificato il parametro InPlace , il file di origine viene sostituito.

Esempio 2: Rimuovere la protezione di un singolo file, mantenendo il file originale

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

Questo comando rimuove la protezione di un singolo file ma mantiene il file protetto originale creando la versione non protetta nel percorso della cartella denominata C:\Temp. Quando viene specificata una cartella di output, viene creato un nome file univoco per il file non protetto. Se esiste un file con lo stesso nome, il nuovo nome file viene reso univoco nello stesso modo in cui Esplora file crea una copia univoca dello stesso nome file. Ad esempio , seTest.txt esiste, viene creato test Copy.txt , quindi test copia(2).txt.

Esempio 3: Rimuovere la protezione di una cartella

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

Questo comando rimuove la protezione di una cartella, conservando i file protetti originali e creando le versioni non protette nel percorso della cartella denominato C:\Temp e crea una sottocartella corrispondente di "Protected".

Questo comando può essere usato anche con il parametro Recurse , che determina se includere l'elaborazione delle sottocartelle.

Esempio 4: Rimuovere la protezione di un oggetto . File PST

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

Questo comando rimuove la protezione di un file pst (tabella di archiviazione personale), ovvero file di contenitore che possono contenere file msg di Microsoft Outlook.

A sua volta, questi file msg possono essere contenitori che contengono allegati. Poiché il file PST è un contenitore, anche ogni file figlio e contenitore annidato non sono protetti da questa operazione.

Esempio 5: Rimuovere la protezione di un file di .RAR

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

Questo comando rimuove la protezione di un file di archiviazione .rar . Poiché .rar file sono file contenitore che contengono file annidati, questi file annidati possono anche essere archivi. Anche ogni file figlio e contenitore annidato non sono protetti da questa operazione.

Si noti che per un file di input.rar , il file non protetto è un file di.zip .

Parametri

-File

Specifica il percorso e il file da rimuovere dalla protezione. Per il percorso, è possibile specificare una lettera di unità o UNC.

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

-Folder

Specifica il percorso e la cartella da rimuovere dalla protezione. Tutti i file nella cartella specificata non verranno protetti.

Per il percorso, è possibile specificare una lettera di unità o UNC.

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

-InPlace

Il file o i file nella cartella specificata non sono protetti nel percorso corrente, sostituendo il file o i file protetti originali. Questo parametro viene ignorato se viene specificato il parametro OutputFolder .

Se non viene specificato né InPlace né OutputFolder, il nuovo file viene creato nella directory corrente con "-Copy" aggiunto al nome del file, utilizzando la stessa convenzione di denominazione usata Esplora file quando un file viene copiato e incollato nella stessa cartella. Ad esempio, se un file con Document.docx è protetto, la versione non protetta viene denominata Document-Copy.docx. Se esiste già un file denominato Document-Copy.docx , viene creato document-copy(2).docx e così via.

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

-LogFile

Specifica il percorso e il nome del file di base, con estensione di file facoltativa per i file di log. Questi file di log elencano i file che sono stati correttamente o non protetti correttamente. I tre file di log seguenti vengono creati rispettivamente per l'esito positivo, negativo e il debug:

<nome> file.< estensione del nome file>
<file name-failure>.< estensione del nome file>
<file name-debug>.< estensione del nome file>

Per i file di contenitore, questi file di log includono anche file annidati.

Ad esempio, se si specifica C:\Users\Administrator\Unprotect-RMSFile.txt per questo parametro, vengono creati i file di log seguenti:

Per i file non protetti correttamente: C:\Users\Administrator\Unprotect-RMSFile.txt
Per tutti i file che non possono essere protetti: C:\Users\Administrator\Unprotect-RMSFile-failure.txt
Per informazioni di debug: C:\Users\Administrator\Unprotect-RMSFile-debug.txt

Per il percorso, è possibile specificare una lettera di unità o UNC.

Se non si specifica questo parametro, i file di log Success.log, Failure.log e Debug.log vengono scritti nel percorso predefinito del file di log %localappdata%\Microsoft\MSIPC\pscmdlet\Logs[GUID].

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

-OutputFolder

Specifica la cartella di output per le versioni non protette dei file protetti. La struttura di cartelle originale viene mantenuta, il che significa che è possibile creare sottocartelle per il valore specificato.

Per il percorso, è possibile usare una lettera di unità o UNC.

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

-ProcessContainers

Questo parametro non è attualmente implementato.

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

-Recurse

Indica che questa operazione rimuove la protezione di tutti i file in tutte le sottocartelle.

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

-SupressUI

Questo parametro non è implementato; non esiste un'interfaccia utente per questo cmdlet.

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

Protect-RMSFile