Поделиться через

Get-FileStatus

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

Возвращает метку Защита информации Microsoft Purview и сведения о защите для указанного файла или файлов.

Синтаксис

Get-FileStatus
   [-Path] <String[]>
   [<CommonParameters>]

Описание

Командлет Get-FileStatus возвращает состояние указанного файла или всех файлов по указанному пути. Это состояние включает в себя, имеет ли файл метку, и, если он есть, имя метки, кто его применил, как он был применен и когда.

Если файлы хранятся в SharePoint Online, используйте командлет Get-FileSensitivityLabelInfo из модуля SharePointOnlinePowerShell .

Состояние, возвращаемое командлетом Get-FileStatus , также включает в себя, защищен ли файл с помощью Rights Management, и, если это так, какой шаблон Rights Management использовался для применения этой защиты. Если файл был защищен с помощью пользовательских разрешений (нерегламентированной политики прав) вместо шаблона, вместо имени шаблона отображается слово "Ограниченный доступ". Кроме того, отображаются владелец Rights Management и издатель Rights Management , а также время защиты файла.

Этот командлет возвращает сведения о метки только из собственного клиента.

Обратите внимание, что защищенные паролем файлы всегда возвращают состояние защиты False.

Этот командлет можно выполнять неинтерактивно.

Примеры

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

PS C:\> Get-FileStatus -Path \\Finance\Projects\Project.docx

FileName        : \\Finance\Projects\Project.docx
IsLabeled       : True
MainLabelId     : 074e257c-1234-1234-1234-34a182080e71
MainLabelName   : Confidential
SubLabelId      : d9f23ae3-1234-1234-1234-f515f824c57b
SubLabelName    : Finance group
LabelingMethod  : Privileged
LabelDate       : 12/12/2016 12:24:36 PM
IsRMSProtected  : True
RMSTemplateId   : e6ee2481-1234-1234-1234-f744eacd53b0
RMSTemplateName : Contoso - Confidential Finance
RMSOwner        : John@Contoso.com
RMSIssuer       : John@Contoso.com
ContentId       : 4ca757d2-83bf-4ec3-b93b-c7fe9433bf33

Эта команда предоставляет сведения о файле с меткой "Конфиденциально \ Финансовая группа", которая является меткой, настроенной для клиента. Этот файл был помечен вручную Джоном и также защищен с помощью шаблона Rights Management Contoso — Конфиденциальные финансы.

Пример 2. Получение метки и состояния защиты для всех файлов в папке и экспорт результатов в CSV-файл

PS C:\> Get-FileStatus -Path \\Finance\Projects\ | Export-Csv C:\Reports\Report.csv

Эта команда получает метку и сведения о защите всех файлов на финансовом сервере, в папке Projects и любой из ее вложенных папок. Результаты экспортируются в файл с именемReport.csv для упрощения поиска и сортировки. Если предыдущий отчет существует в C:\Reports\Report.csv, он будет перезаписан.

Пример 3. Вывод списка файлов с меткой "Конфиденциальные" и экспорт результатов в CSV-файл

PS C:\> Get-FileStatus -Path \\Finance\Projects\ | Where-Object {$_.MainLabelName -eq 'Confidential'} | Export-Csv C:\Reports\Report.csv

Эта команда получает метку и сведения о защите только для файлов, которые помечены как "Конфиденциальные" (независимо от их вложенной метки) на финансовом сервере, в папке Projects и любой из ее вложенных папок. Результаты экспортируются в файл с именемReport.csv для упрощения поиска и сортировки. Если предыдущий отчет существует в C:\Reports\Report.csv, он будет перезаписан.

Пример 4. Количество файлов с меткой "Конфиденциально"

PS C:\> (Get-FileStatus -Path C:\Projects\ | Where-Object {$_.MainLabelName -eq 'Confidential'}).Count

5

Эта команда предоставляет количество файлов с меткой "Конфиденциально", которые находятся в папке C:\Projects и любой из ее вложенных папок. В этом примере найдено 5 файлов.

Параметры

-Path

Указывает локальный путь, сетевой путь или URL-адрес SharePoint Server к файлам, для которых требуется получить метку и сведения о защите. Подстановочные знаки не поддерживаются.

Для путей SharePoint поддерживаются следующие:

  • SharePoint Server 2019
  • SharePoint Server 2016
  • SharePoint Server 2013

Пример:

Пути могут содержать пробелы, если значение пути заключено в кавычки.

Type:String[]
Aliases:FullName, FileName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Входные данные

System.String[]

Выходные данные

Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult