Get-AipServiceDocumentLog

Модуль:
AIPService Module

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

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

Синтаксис

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

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

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

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

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

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

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

-ContentName

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

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

Подсказка

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

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

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-FromTime

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

Для получения дополнительной информации введите Get-Help Get-Date.

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

Тип:DateTime
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-Owner

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

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

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-ToTime

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

Для получения дополнительной информации введите Get-Help Get-Date.

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

Тип:DateTime
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-WhatIf

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

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

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

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

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

CommonParameters

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