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

Запрос подтверждения перед выполнением командлета.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContentName

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

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

Совет

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-FromTime

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

Для получения дополнительных сведений введите Get-Help Get-Date.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Owner

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ToTime

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