Get-RMSFileStatus

Ссылка

Модуль:: AzureInformationProtection

Возвращает состояние защиты RMS указанного файла.

Синтаксис

Get-RMSFileStatus
   -File <String>
   [<CommonParameters>]

Описание

Командлет Get-RMSFileStatus возвращает состояние защиты (независимо от того, защищен ли файл службой Rights Management) указанного файла.

Защищенный файл имеет состояние Protected (Native) или Protected (Generic), а незащищенный файл имеет состояние "Незащищено".

Обратите внимание, что файл контейнера, защищенный в собственном коде, например файл данных Outlook (). PST) всегда возвращает состояние защиты незащищенного.

Примеры

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

PS C:\>Get-RMSFileStatus -File "C:\Test.docx"
FileName             Status
--------             ------
C:\Test.docx         Unprotected

Эта команда выводит список состояния защиты Rights Management для указанного C:\Test.docxфайла .

Так как файл с расширением имени файла.docx поддерживает собственную защиту, состояние возвращает значение "Protected (Native)" или "Unprotected".

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

PS C:\>foreach ($file in (Get-ChildItem -Path C:\Documents -Recurse -Force | where {!$_.PSIsContainer})) {Get-RMSFileStatus -f $file.PSPath}

Хотя командлет Get-RMSFileStatus работает для одного файла одновременно, можно использовать следующую команду Windows PowerShell, чтобы получить состояние всех файлов в папке (в нашем примере — C:\Documents) и ее вложенных папок.

Ту же команду можно использовать с UNC-путем вместо диска и пути.

Пример 3. Создание файла .CSV с состоянием защиты для всех файлов в папке и вложенных папок

PS C:\>$(foreach ($file in (Get-ChildItem -Path C:\Documents\ -Recurse -Force | where {!$_.PSIsContainer})) {Get-RMSFileStatus -f $file.PSPath}) | Export-Csv -Path C:\Temp\ProtectedFilesList.csv -Encoding ascii -NoTypeInformation

Вы можете расширить предыдущий пример, выпустив результаты в файл .CSV, чтобы можно было сортировать и упорядочивать информацию.

В этом примере файл .CSV называется ProtectedFilesList.csv и сохраняется в папку C:\Temp . Если файл уже существует, он будет перезаписан.

Параметры

-File

Указывает полный путь к файлу, чтобы проверить, защищен ли он службой Rights Management.

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