Get-FileStatus

Модуль:: PurviewInformationProtection Module

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

Синтаксис

Default (по умолчанию)

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 - Confidential Finance".

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

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

Эта команда получает метку и информацию о защите всех файлов на сервере Finance, в папке 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

Эта команда получает метку и информацию о защите только для файлов, помеченных как «Конфиденциальные» (независимо от их подметки) на сервере Finance, в папке «Проекты» и любой из ее подпапок. Результаты экспортируются в файл с именем 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

Рассмотрим пример.

C:\Папка\
C:\Папка\Имя файла
\\Сервер\Папка
http://sharepoint.contoso.com/Shared%20Documents/Folder

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

Свойства параметра

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	Полное имя, Имя файла

Наборы параметров

(All)

Position:	0
Обязательно:	True
Значение из конвейера:	True
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.