Protect-RMSFile

Синтаксис

Protect-RMSFile
       [-File <String>]
       [-Folder <String>]
       [-InPlace]
       [-Recurse]
       [-TemplateID <String>]
       [-License <SafeInformationProtectionLicenseHandle>]
       [-DoNotPersistEncryptionKey <String>]
       [-OutputFolder <String>]
       [-OwnerEmail <String>]
       [<CommonParameters>]

Описание

Командлет Protect-RMSFile защищает файл или все файлы в указанной папке с помощью Azure RMS или AD RMS. Если файл ранее был защищен, он будет снова защищен, чтобы применить любые изменения, такие как те, которые могут быть внесены в шаблон, используемый для защиты файла.

Несколько типов файлов можно защитить так же, как клиент Azure Information Protection может защищать файлы при использовании параметра "Классификация и защита" правой кнопкой мыши из проводник.

Различные уровни защиты автоматически применяются (собственные или универсальные) в зависимости от типа файла. Уровень защиты можно изменить, изменив реестр. Кроме того, некоторые файлы изменяют расширение имени файла после их защиты с помощью Rights Management. Дополнительные сведения см. в разделе о типах файлов, поддерживающих защиту, в руководстве администратора клиента Azure Information Protection.

Перед запуском этого командлета необходимо запустить Get-RMSTemplate , чтобы скачать шаблоны на компьютер. Если шаблон, который вы хотите использовать, был изменен с момента запуска этого командлета, запустите его еще раз с параметром -force , чтобы скачать измененный шаблон.

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

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

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

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

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

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

Этот командлет записывает в следующие файлы журналов: Success.log, Failure.log и Debug.log in %localappdata%\Microsoft\MSIPC\pscmdlet\Logs\\<GUID>.

Примеры

Пример 1. Защита и замена одного файла с помощью шаблона

PS C:\>Protect-RMSFile -File "C:\Test.docx" -InPlace -TemplateID 82bf3474-6efe-4fa1-8827-d1bd93339119
InputFile             EncryptedFile
---------             -------------
C:\Test.docx          C:\Test.docx

Эта команда защищает один файл с именемTest.docx с помощью шаблона и заменяет исходный незащищенный файл. Владелец файла Rights Management и адрес электронной почты, который может отображаться пользователям при доступе к защищенному файлу, автоматически задается в качестве адреса электронной почты для учетной записи, выполняющей команду.

Пример 2. Создание защищенной копии одного файла с помощью шаблона

PS C:\>Protect-RMSFile -File "Test.docx" -TemplateID 82bf3474-6efe-4fa1-8827-d1bd93339119
InputFile             EncryptedFile
---------             -------------
C:\Test.docx          C:\Test-Copy.docx

Эта команда аналогична предыдущему примеру, за исключением того, что она не использует параметр InPlace . Так как он также не использует параметр OutputFolder , защищенный файл создается в текущей папке с добавлением "-Copy" к имени файла. Исходный незащищенный файл остается в текущей папке.

Пример 3. Создание защищенной версии файла с помощью шаблона

PS C:\>Protect-RMSFile -File "C:\Test.docx" -OutputFolder "C:\Temp" -TemplateID e6ee2481-26b9-45e5-b34a-f744eacd53b0 -OwnerEmail "admin@Contoso.com"

InputFile             EncryptedFile
---------             -------------
C:\Test.txt           C:\Temp\Test.ptxt

Эта команда защищает один файл с именемTest.docx с помощью шаблона и помещает эту защищенную версию файла в C:\Temp, оставив исходный файл незащищенным в корне диска C: . Владелец файла Rights Management и адрес электронной почты, который может отображаться пользователям при доступе к защищенному файлу, предназначен для администратора.

Пример 4. Защита всех файлов в папке с помощью шаблона

PS C:\>Protect-RMSFile -Folder "\\server1\Docs" -InPlace -DoNotPersistEncryptionKey All -TemplateID e6ee2481-26b9-45e5-b34a-f744eacd53b0 -OwnerEmail "IT@Contoso.com"

InputFile                        EncryptedFile

----------                       -------------
\\server1\Docs\Feb2015.docx      \\server1\Docs\Feb2015.docx

\\server1\Docs\Feb2015.txt       \\server1\Docs\Feb2015.ptxt

\\server1\Docs\Jan2015.docx      \\server1\Docs\Jan2015.docx

\\server1\Docs\Jan2015.txt       \\server1\Docs\Jan2015.ptxt

Эта команда защищает все файлы в общей папке сервера (только одна папка, а не вложенные папки), заменив незащищенные файлы. Адрес электронной почты, отображаемый пользователям, если у них нет доступа, предназначен для группы ИТ-отдела, и эта группа предоставляет права на использование полного доступа в шаблоне, чтобы они могли изменять права на использование защищенных файлов.

Так как этот сценарий защищает файлы от имени других пользователей, параметр DoNotPersistEncryptionKey используется для максимальной производительности и для предотвращения сохранения неиспользуемых файлов на диск.

Пример 5. Защищенные файлы с определенным расширением имени файла в папке с помощью шаблона

PS C:\>foreach ($file in (Get-ChildItem -Path \\server1\Docs -Recurse -Force | where {!$_.PSIsContainer} | Where-Object {$_.Extension -eq ".docx"})) {Protect-RMSFile -File $file.PSPath -InPlace -DoNotPersistEncryptionKey All -TemplateID "e6ee2481-26b9-45e5-b34a-f744eacd53b0" -OwnerEmail "IT@Contoso.com"}


InputFile                                   EncryptedFile

---------                                   -------------
\\server1\Docs\Feb2015.docx                 \\server1\Docs\Feb2015.docx

\\server1\Docs\Jan2015.docx                 \\server1\Docs\Jan2015.docx

\\server1\Docs\Reports\Feb2015.docx         \\server1\Docs\Reports\Feb2015.docx

\\server1\Docs\Reports\Jan2015.docx         \\server1\Docs\Reports\Jan2015.docx

Эта команда защищает только файлы с расширением имени файла .docx в папке (и во всех вложенных папках) в общей папке сервера, заменив незащищенные файлы. Как и в предыдущем примере, адрес электронной почты, отображаемый пользователям, когда у них нет доступа, предназначен для ИТ-отдела.

Хотя команда Protect-RMSFile изначально не поддерживает подстановочные знаки, вы можете использовать Windows PowerShell для этого и изменить расширение имени файла в примере по мере необходимости.

Пример 6. Защита одного файла с помощью политики нерегламентированных прав

PS C:\>$License = New-RMSProtectionLicense -UserEmail 'user1@contoso.com' -Permission EDIT
PS C:\> Protect-RMSFile -License $License -File "C:\Test.txt" -InPlace
InputFile             EncryptedFile
---------             -------------
C:\Test.txt           C:\Test.ptxt

Первая команда создает политику нерегламентированных прав, которая предоставляет права на редактированиеuser1@contoso.com.

Вторая команда защищает один файл с именем Test.txt с помощью созданной политики нерегламентированных прав и заменяет исходный незащищенный файл.

Обратите внимание, что если адрес электронной почты не указан user1@contoso.com, вы не сможете снять защиту с этого файла после завершения команды, так как у вас нет прав на него и вы не являетесь владельцем Rights Management.

Если вам потребуется снять защиту с этого файла позже, вы можете добавить свое имя и предоставить пользователю право EXTRACT или OWNER в нерегламентированной политике прав в первой команде. Если вы не хотите, чтобы пользователь мог снять защиту с файла, добавьте -OwnerEmail <ваш адрес> электронной почты в конец второй команды.

Параметры

-DoNotPersistEncryptionKey

-File

-Folder

-InPlace

-License

-OutputFolder

-OwnerEmail

-Recurse

-TemplateID

Связанные ссылки

• Get-RMSTemplate
• Get-RMSFileStatus
• New-RMSProtectionLicense
• Unprotect-RMSFile