Unprotect-RMSFile

  • Ссылка
Модуль:
AzureInformationProtection

Отменяет защиту файла, защищенного в настоящее время службой RMS.

Синтаксис

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

Описание

Командлет Unprotect-RMSFile удаляет защиту Rights Management (RMS) из одного или нескольких файлов в указанной папке, если эти файлы ранее были защищены AD RMS или Azure RMS.

Для отмены защиты файлов необходимо иметь достаточные права на использование или быть суперпользоваем вашей организации. Дополнительные сведения см. в статье о настройке суперпользователей для служб Information Protection Azure и служб обнаружения или восстановления данных.

Если вы снимаете защиту с файла контейнера, каждый дочерний элемент рекурсивно извлекается, незащищен и перепаковывается. Поддерживаемые типы файлов контейнера: .zip, .rar, .7z, MSG и PST.

Для PST-файлов максимальный размер файла составляет 5 ГБ, поддерживаемый этим командлетом.

При запуске этого командлета доступны следующие параметры:

  • Файл не защищен в той же папке, чтобы исходный защищенный файл и новый незащищенный файл сосуществовали.

  • Исходный файл остается защищенным, а незащищенная версия файла создается в другом расположении.

  • Все файлы в указанной папке не защищены в текущем расположении, заменяя исходные защищенные файлы.

  • Все файлы в указанной папке остаются защищенными, а незащищенная версия каждого файла создается в другом расположении.

Эту команду можно выполнять параллельно при указании другого пути для параметра 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теста , а затем .txttest Copy(2) .

Пример 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-файла (таблица личного хранилища), которые являются файлами контейнера, которые могут содержать MSG-файлы Microsoft Outlook.

В свою очередь, эти 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 уже существует, создается .docxDocument-Copy(2) и т. д.

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

-LogFile

Указывает путь и базовое имя файла с необязательным расширением имени файла для файлов журнала. Эти файлы журналов перечисляют файлы, которые успешно или безуспешно не защищены. Следующие три файла журнала создаются для успешного выполнения, сбоя и отладки соответственно:

  • <имя> файла.< Расширение имени файла>

  • <сбой имени> файла.< Расширение имени файла>

  • <файл 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

Этот параметр не реализован; для этого командлета нет пользовательского интерфейса.

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