Unprotect-RMSFile

參考

模組:: AzureInformationProtection

取消保護目前受 RMS 保護的檔案。

Syntax

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

Description

Unprotect-RMSFile Cmdlet 會從指定資料夾中的一或多個檔案中移除 Rights Management (RMS) 保護，前提是這些檔案先前受到 AD RMS 或 Azure RMS 的保護。

您必須擁有足夠的許可權，或是您組織的進階使用者，才能解除保護檔案。如需詳細資訊，請參閱設定 Azure 資訊保護和探索服務或資料復原的進階使用者。

如果您要解除保護容器檔案，則會遞迴擷取、解除保護及重新封裝每個子系。支援的容器 檔案類型.zip、 .rar、 .7z、 .msg和 .pst。

對於 .pst 檔案，5 GB 是此 Cmdlet 支援的最大檔案大小。

當您執行此 Cmdlet 時，您有下列選項：

檔案在相同的資料夾中未受保護，因此原始受保護的檔案和新的未受保護的檔案會並存。
原始檔案會維持受保護狀態，且未受保護的檔案版本會在另一個位置建立。
指定資料夾中的所有檔案都會在目前的位置解除保護，並取代受保護的原始檔案。
指定資料夾中的所有檔案都會維持受保護狀態，而且每個檔案的未受保護版本都會在另一個位置建立。

當您為平行執行的每個命令指定 LogFile 參數的不同路徑時，可以同時執行此命令。如果您未指定不同的記錄檔路徑，且先前的命令尚未完成，新的命令將會失敗。

範例

範例 1：取消保護單一檔案，取代原始檔案

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

此命令會取消保護名為 Test.ptxt的單一檔案，並將這個受保護的檔案版本取代為相同位置中未受保護的版本。未提供輸出目錄且指定 InPlace 參數時，會取代原始程式檔。

範例 2：取消保護單一檔案，保留原始檔案

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

此命令會取消保護單一檔案，但在名為 C：\Temp的資料夾位置中建立未受保護的版本，以保留原始受保護的檔案。提供輸出檔案夾時，會為未受保護的檔案建立唯一的檔案名。如果存在同名的檔案，新檔案名會以與檔案總管建立相同檔案名的唯一複本相同的方式成為唯一的。例如，如果 Test.txt 存在，則會建立 測試Copy.txt ，然後 測試複製 (2) .txt。

範例 3：取消保護資料夾

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

此命令會取消保護資料夾、保留原始受保護的檔案，並在名為 C：\Temp 的資料夾位置中建立未受保護的版本，並建立對應的「Protected」子資料夾。

此命令也可以與 Recurse 參數搭配使用，以判斷是否要包含子資料夾的處理。

範例 4：取消保護。PST 檔案

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

此命令會解除保護 .pst (個人儲存體資料表) 檔案，這是可保存 Microsoft Outlook .msg 檔案的容器檔案。

接著，這些 .msg 檔案可以是保存附件的容器。因為 .pst 檔案是容器，所以此作業也會取消保護每個子檔案和巢狀容器。

範例 5：取消保護.RAR檔案

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

此命令會解除保護 .rar 封存檔案。因為 .rar 檔案是保存巢狀檔案的容器檔案，所以這些巢狀檔案也可以封存。此作業也會解除保護每個子檔案和巢狀容器。

請注意，對於 .rar 輸入檔，未受保護的檔案是 .zip 檔案。

參數

-File

指定要取消保護的路徑和檔案。針對路徑，您可以指定磁碟機號或 UNC。

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

-Folder

指定要取消保護的路徑和資料夾。將取消保護指定資料夾中的所有檔案。

針對路徑，您可以指定磁碟機號或 UNC。

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

-InPlace

指定資料夾中的檔案或檔案在目前位置中未受保護，取代原始受保護的檔案或檔案。如果指定 OutputFolder 參數，則會忽略此參數。

如果未指定InPlace或OutputFolder，則會在目前目錄中建立新檔案，並將「-Copy」附加至檔案名，並使用檔案總管在複製檔案並貼到相同資料夾中時使用的相同命名慣例。例如，如果具有 Document.docx的 檔案受到保護，則未受保護的版本會命名 為Document-Copy.docx。如果名為 Document-Copy.docx 的檔案已經存在， 則會建立檔案複製 (2) .docx 等等。

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

-LogFile

指定路徑和基底檔案名，以及記錄檔的選擇性副檔名。這些記錄檔會列出成功或失敗未受保護的檔案。下列三個記錄檔分別針對成功、失敗和偵錯而建立：

<檔案名 > 。 <副檔名>
<檔案名 > 失敗。 <副檔名>
<file name-debug > 。 <副檔名>

對於容器檔案，這些記錄檔也包含巢狀檔案。

例如，如果您為此參數指定 C:\Users\Administrator\Unprotect-RMSFile.txt ，則會建立下列記錄檔：

針對已成功解除保護的檔案： C:\Users\Administrator\Unprotect-RMSFile.txt
對於無法解除保護的任何檔案： C:\Users\Administrator\Unprotect-RMSFile-failure.txt
如需偵錯資訊： C:\Users\Administrator\Unprotect-RMSFile-debug.txt

針對路徑，您可以指定磁碟機號或 UNC。

如果您未指定此參數，則會將 記錄檔 Success.log、 Failure.log和 Debug.log 寫入 %localappdata%\Microsoft\MSIPC\psCmdlet\Logs[GUID]的預設記錄檔位置。

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

-OutputFolder

指定受保護檔案未受保護版本的輸出檔案夾。會維護原始檔案夾結構，這表示可能會針對指定的值建立子資料夾。

針對路徑，您可以使用磁碟機號或 UNC。

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

-ProcessContainers

目前未實作此參數。

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

-Recurse

表示此作業會取消保護所有子資料夾中的所有檔案。

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

-SupressUI

未實作此參數;此 Cmdlet 沒有 UI。

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

Protect-RMSFile