Get-AipServiceDocumentLog

Возвращает сведения о защите документов, отслеживаемых 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

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

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

Совет

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

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

-FromTime

Указывает время начала (включительно) для файла журнала в качестве объекта 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 , используйте командлет 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