Get-AipServiceDocumentLog
获取有关 Azure 信息保护跟踪的文档的保护信息。
Azure 信息保护经典客户端和统一标记客户端都支持此 cmdlet，其用法不同，如下所示。
语法
Default （默认值）
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 Management 颁发者。
与统一标记客户端一起使用时，查询基于文档名称、所有者电子邮件或两者兼有。
必须至少指定以下参数之一：
- 内容名称
- 所有者
小窍门
如果使用 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 年 12 月受到保护。
示例 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 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ContentName
指定跟踪文档的全名，包括文件扩展名。
如果你有统一标记客户端，则必须包含此参数，或者 所有者 参数，也可以同时包含这两个参数。
小窍门
如果使用此参数，建议还使用 FromTime，ToTime 日期筛选器来筛选返回的数据。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-FromTime
将日志文件的开始时间（非独占）指定为 DateTime 对象。 若要获取 DateTime 对象，请使用 Get-Date cmdlet。 根据系统区域设置指定日期和时间。
要了解详情，请键入 Get-Help Get-Date。
参数属性
| 类型: | DateTime |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Owner
指定保护文档的用户的电子邮件地址（Rights Management 颁发者或所有者）。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ToTime
将日志文件的停止时间（含）指定为 DateTime 对象。 若要获取 DateTime 对象，请使用 Get-Date cmdlet。 根据系统区域设置指定日期和时间。
要了解详情，请键入 Get-Help Get-Date。
参数属性
| 类型: | DateTime |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。