Unprotect-RMSFile

Modul:

AzureInformationProtection

Avskyddar en fil som för närvarande skyddas av RMS.

Syntax

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

Description

Cmdleten Unprotect-RMSFile tar bort Rights Management-skyddet (RMS) från en eller flera filer i en angiven mapp om dessa filer tidigare skyddades av AD RMS eller Azure RMS.

Du måste ha tillräckliga användningsrättigheter eller vara en superanvändare för att din organisation ska kunna ta bort skyddet från filer. Mer information finns i Konfigurera superanvändare för Azure Information Protection och identifieringstjänster eller dataåterställning.

Om du tar bort skyddet från en containerfil extraheras varje underordnad rekursivt, oskyddad och paketeras om. Containerfiltyper som stöds är .zip, .rar, .7z, .msg och .pst.

För .pst-filer är 5 GB den maximala filstorlek som stöds med den här cmdleten.

När du kör den här cmdleten har du följande alternativ:

• Filen är oskyddad i samma mapp så att den ursprungliga skyddade filen och den nya oskyddade filen samexisterar.

• Den ursprungliga filen förblir skyddad och en oskyddad version av filen skapas på en annan plats.

• Alla filer i den angivna mappen är oskyddade på den aktuella platsen, vilket ersätter de ursprungliga filerna som skyddades.

• Alla filer i den angivna mappen förblir skyddade och en oskyddad version av varje fil skapas på en annan plats.

Du kan köra det här kommandot samtidigt när du anger en annan sökväg för LogFile-parametern för varje kommando som körs parallellt. Om du inte anger en annan loggfilsökväg och föregående kommando inte har slutförts misslyckas det nya kommandot.

Exempel

Exempel 1: Ta bort skyddet för en enskild fil och ersätt den ursprungliga filen

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

Det här kommandot avskyddar en enskild fil med namnet Test.ptxt och ersätter den här skyddade versionen av filen med en oskyddad version på samma plats. När en utdatakatalog inte har angetts och parametern InPlace har angetts ersätts källfilen.

Exempel 2: Ta bort skyddet för en enskild fil och behåll den ursprungliga filen

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

Det här kommandot avskyddar en enskild fil men behåller den ursprungliga skyddade filen genom att skapa den oskyddade versionen på mappplatsen med namnet C:\Temp. När en utdatamapp anges skapas ett unikt filnamn för den oskyddade filen. Om det finns en fil med samma namn blir det nya filnamnet unikt på samma sätt som Utforskaren gör en unik kopia av samma filnamn. Om Test.txt till exempel finns skapas Test Copy.txt och sedan Test Copy(2).txt.

Exempel 3: Ta bort skyddet för en mapp

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

Det här kommandot avskyddar en mapp, behåller de ursprungliga skyddade filerna och skapar de oskyddade versionerna på mappplatsen med namnet C:\Temp och skapar en motsvarande undermapp till "Skyddad".

Det här kommandot kan också användas med parametern Recurse , som avgör om bearbetningen av undermappar ska inkluderas.

Exempel 4: Ta bort skyddet från en . PST-fil

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

Det här kommandot tar bort skyddet från en .pst-fil (personlig lagringstabell), som är containerfiler som kan innehålla .msg-filer för Microsoft Outlook.

Dessa .msg-filer kan i sin tur vara containrar som innehåller bifogade filer. Eftersom .pst-filen är en container är varje underordnad fil och kapslad container också oskyddad av den här åtgärden.

Exempel 5: Ta bort skyddet för en .RAR fil

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

Det här kommandot avskyddar en .rar arkivfil. Eftersom .rar filer är containerfiler som innehåller kapslade filer kan dessa kapslade filer också vara arkiv. Varje underordnad fil och kapslad container är också oskyddade av den här åtgärden.

Observera att för en .rar indatafil är den oskyddade filen en .zip fil.

Parametrar

-File

Anger sökvägen och filen som ska avskyddas. För sökvägen kan du ange en enhetsbeteckning eller UNC.

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

-Folder

Anger sökvägen och mappen som ska avskyddas. Alla filer i den angivna mappen kommer att vara oskyddade.

För sökvägen kan du ange en enhetsbeteckning eller UNC.

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

-InPlace

Filen eller filerna i den angivna mappen är oskyddade på den aktuella platsen och ersätter den ursprungliga skyddade filen eller filerna. Den här parametern ignoreras om parametern OutputFolder har angetts.

Om varken InPlace eller OutputFolder anges skapas den nya filen i den aktuella katalogen med "-Copy" i filnamnet, med samma namngivningskonvention som Utforskaren använder när en fil kopieras och klistras in i samma mapp. Om till exempel en fil med Document.docx är skyddad får den oskyddade versionen namnet Document-Copy.docx. Om det redan finns en fil med namnet Document-Copy.docx skapas Document-Copy(2).docx och så vidare.

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

-LogFile

Anger sökvägen och basfilnamnet med det valfria filnamnstillägget för loggfiler. De här loggfilerna visar de filer som är oskyddade eller som inte är oskyddade. Följande tre loggfiler skapas för lyckade, misslyckade respektive felsökningsrelaterade:

• <filnamn>.< filnamnstillägg>

• <filnamnsfel>.< filnamnstillägg>

• <filnamnsfelsökning>.< filnamnstillägg>

För containerfiler innehåller loggfilerna även kapslade filer.

Om du till exempel anger C:\Users\Administrator\Unprotect-RMSFile.txt för den här parametern skapas följande loggfiler:

• För filer som har tagits bort från skyddet: C:\Users\Administrator\Unprotect-RMSFile.txt

• För filer som inte kunde vara oskyddade: C:\Users\Administrator\Unprotect-RMSFile-failure.txt

• Felsökningsinformation: C:\Users\Administrator\Unprotect-RMSFile-debug.txt

För sökvägen kan du ange en enhetsbeteckning eller UNC.

Om du inte anger den här parametern skrivs loggfilerna Success.log, Failure.log och Debug.log till standardplatsen för loggfilen %localappdata%\Microsoft\MSIPC\pscmdlet\Logs[GUID].

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

-OutputFolder

Anger utdatamappen för oskyddade versioner av de skyddade filerna. Den ursprungliga mappstrukturen bibehålls, vilket innebär att undermappar kan skapas för det angivna värdet.

För sökvägen kan du använda en enhetsbeteckning eller UNC.

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

-ProcessContainers

Den här parametern är inte implementerad för närvarande.

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

-Recurse

Anger att den här åtgärden avskyddar alla filer i alla undermappar.

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

-SupressUI

Den här parametern har inte implementerats. det finns inget användargränssnitt för den här cmdleten.

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

Relaterade länkar

• Protect-RMSFile