你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Get-AipServiceDocumentLog

获取有关 Azure 信息保护跟踪的文档的保护信息。

Azure 信息保护经典和统一标记客户端都支持此 cmdlet,其用法不同,如下所示。

语法

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

说明

Get-AIPServiceDocumentLog cmdlet 运行查询以返回有关跟踪文档的保护信息。

返回的信息包括:

  • 文档内容 ID(如果可用)。
  • Rights Management 所有者和 Rights Management 颁发者。
  • 授予访问权限的用户和组。
  • 保护模板 ID 或保护文档的特定使用权限。
  • 任何过期、脱机访问或吊销设置。

可以指定要包含的条目的开始时间和停止时间。 输出作为 PowerShell 控制台中的 PowerShell 对象列表返回。

有关详细信息,请参阅 Rights Management 所有者和 IRights 管理颁发者

与统一标记客户端一起使用时,查询基于文档名称、所有者电子邮件或两者。

必须至少指定以下参数之一:

  • ContentName
  • 所有者

提示

如果使用 ContentName 参数,建议还使用 FromTimeToTime 参数将内容筛选为特定时间段。

示例

示例 1: (统一标记客户端仅) 获取有关具有特定文件名的所有跟踪文档的保护信息,该文档在特定时间范围内受到保护

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

此命令运行一个查询,并返回有关存储在租户中且文件名为 2020 年 12 月的文件名 test.docx上存储的所有跟踪文档的保护信息。

示例 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 年 12 月受到保护。

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ContentName

指定跟踪文档的全名,包括文件扩展名。

如果你有统一标记客户端,则必须包含此参数或 Owner 参数,也可以同时包含这两个参数。

提示

如果使用此参数,建议还使用 FromTimeToTime 日期筛选器来筛选返回的数据。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-FromTime

将日志文件的开始时间 (非独占) 指定为 DateTime 对象。 若要获取 DateTime 对象,请使用 Get-Date cmdlet。 根据系统区域设置指定日期和时间。

要了解详情,请键入 Get-Help Get-Date

类型:DateTime
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Owner

指定保护文档的用户的电子邮件地址 (Rights Management 颁发者或所有者) 。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-ToTime

指定日志文件的停止时间 (非独占) 作为 DateTime 对象。 若要获取 DateTime 对象,请使用 Get-Date cmdlet。 根据系统区域设置指定日期和时间。

要了解详情,请键入 Get-Help Get-Date

类型:DateTime
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False