Get-AIPFileStatus

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

Получает метку azure Information Protection и сведения о защите для указанного файла или файла.

Синтаксис

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

Описание

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

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

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

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

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

Этот командлет можно запустить неинтерактивно. Дополнительные сведения см. в руководстве администратора клиента унифицированных меток.

Примеры

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

PS C:\> Get-AIPFileStatus -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-AIPFileStatus -Path \\Finance\Projects\ | Export-Csv C:\Reports\AIP-status.csv

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

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

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

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

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

PS C:\> (Get-AIPFileStatus -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