你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Unprotect-RMSFile
取消保护当前受 RMS 保护的文件。
语法
Unprotect-RMSFile
[-File <String>]
[-Folder <String>]
[-InPlace]
[-Recurse]
[-OutputFolder <String>]
[-SupressUI]
[-LogFile <String>]
[-ProcessContainers]
[<CommonParameters>]
说明
Unprotect-RMSFile cmdlet 如果以前受 AD RMS 或 Azure RMS 保护,则从指定文件夹中的一个或多个文件中删除 Rights Management (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。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Folder
指定要取消保护的路径和文件夹。 指定文件夹中的所有文件都将不受保护。
对于路径,可以指定驱动器号或 UNC。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-InPlace
指定文件夹中的文件或文件在当前位置不受保护,替换原始受保护的文件或文件。 如果指定 OutputFolder 参数,则忽略此参数。
如果未指定 InPlace 和 OutputFolder,则新文件将在当前目录中创建,并将“-Copy”追加到文件名中,使用复制并粘贴到同一文件夹中时文件资源管理器使用的同一命名约定。 例如,如果具有 Document.docx 的文件受到保护,则未受保护的版本将命名 为Document-Copy.docx。 如果已存在名为 Document-Copy.docx 的文件,则会创建 文档复制 (2) .docx ,依此等。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-LogFile
指定路径和基文件名,以及日志文件的可选文件扩展名。 这些日志文件列出成功或未成功保护的文件。 将分别创建以下三个日志文件,以便成功、失败和调试:
<文件名>。<文件扩展名>
<文件名>失败。<文件扩展名>
<文件名>-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] 的默认日志文件位置。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-OutputFolder
指定受保护文件的未受保护的版本的输出文件夹。 维护原始文件夹结构,这意味着可以为指定的值创建子文件夹。
对于路径,可以使用驱动器号或 UNC。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ProcessContainers
此参数当前未实现。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Recurse
指示此操作取消保护所有子文件夹中的所有文件。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-SupressUI
此参数未实现;此 cmdlet 没有 UI。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |