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

Get-AipServiceDocumentLog

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

Возвращает сведения о защите документов, отслеживаемых Azure Information Protection.

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

Синтаксис

Get-AipServiceDocumentLog
   -ContentName <String>
   -Owner <String>
   [-FromTime <DateTime>]
   [-ToTime <DateTime>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет Get-AIPServiceDocumentLog запускает запрос для возврата сведений о защите отслеживаемых документов.

Возвращаемые сведения включают:

  • Идентификатор содержимого документа с именем документа, если он доступен.
  • Владелец Rights Management и издатель Rights Management.
  • Пользователи и группы, которым предоставлен доступ.
  • Идентификатор шаблона защиты или определенные права использования, которые защищают документ.
  • Любой срок действия, автономный доступ или параметр отзыва.

Можно указать время начала и время остановки записей для включения. Выходные данные возвращаются в виде списка объектов PowerShell в консоли PowerShell.

Дополнительные сведения см. в владельцев Rights Management и издателей IRights Management.

При использовании с клиентом унифицированных меток запрос основан на имени документа, электронной почте владельца или обоих.

Необходимо указать по крайней мере один из следующих параметров:

  • ContentName
  • владелец

Кончик

Если вы используете параметр ContentName, мы рекомендуем также использовать параметры FromTime и ToTime для фильтрации содержимого в определенный период времени.

Примеры

Пример 1. (Только клиент унифицированных меток) Получение сведений о защите всех отслеживаемых документов с определенным именем файла, которые были защищены в определенном временном интервале.

Get-AipServiceDocumentLog -ContentName "test.docx" -FromTime "12/01/2020 00:00:00" -ToTime "12/31/2020 23:59:59"

Эта команда запускает запрос и возвращает сведения о защите всех отслеживаемых документов, хранящихся в клиенте, с именем файла test.docx, которые были защищены в декабре 2020 года.

Пример 2. (Только клиент унифицированных меток) Получение сведений о защите всех отслеживаемых документов с определенным именем файла и владельцем, которые были защищены в определенном временном интервале.

Get-AipServiceDocumentLog -ContentName "test.docx" -Owner “alice@microsoft.com” -FromTime "12/01/2020 00:00:00" -ToTime "12/31/2020 23:59:59"

Эта команда выполняет запрос и возвращает сведения о защите всех отслеживаемых документов, хранящихся в клиенте, которые соответствуют следующим сведениям:

  • Имя файла — test.docx
  • Файл был защищен пользователем с помощью alice@contoso.com электронной почты
  • Файл был защищен в декабре 2020 года.

Параметры

-Confirm

Запрашивает подтверждение перед запуском командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ContentName

Указывает полное имя отслеживаемого документа, включая расширение файла.

Если у вас есть клиент унифицированных меток, необходимо включить этот параметр или параметр владельца или включить оба параметра.

Кончик

Если этот параметр используется, рекомендуется также использовать FromTime и фильтры даты toTime ToTime для фильтрации возвращаемых данных.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-FromTime

Указывает время начала (включительно) для файла журнала в качестве объекта DateTime. Чтобы получить объект dateTime DateTime, используйте командлет Get-Date. Укажите дату и время в соответствии с параметрами языкового стандарта системы.

Дополнительные сведения см. в Get-Help Get-Date.

Тип:DateTime
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Owner

Указывает адрес электронной почты пользователя, который защитил документ (издатель Rights Management или владелец).

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ToTime

Указывает время остановки (включительно) для файла журнала в качестве объекта DateTime. Чтобы получить объект dateTime DateTime, используйте командлет Get-Date. Укажите дату и время в соответствии с параметрами языкового стандарта системы.

Дополнительные сведения см. в Get-Help Get-Date.

Тип:DateTime
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False