你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Get-AipServiceUserLog
将保护用户日志从 Azure 信息保护下载到本地存储。
语法
Get-AipServiceUserLog
-Path <String>
[-FromDate <DateTime>]
[-ToDate <DateTime>]
[-ForDate <DateTime>]
[-Force]
[-NumberOfThreads <Int32>]
[<CommonParameters>] 说明
Get-AipServiceUserLog cmdlet 将保护用户日志下载到本地存储。 必须指定特定日期或日期范围才能下载日志条目。
必须使用 PowerShell 获取这些用户日志;无法使用管理门户执行此操作。
运行此命令并仅指定 DateTime 对象的日期时，假定该时间在本地时间为 00：00：00：00，然后转换为 UTC。
当指定日期的时间（例如，-ForDate '2/1/2016 15：00：00'），该日期和时间将转换为 UTC。 然后，Get-AipServiceUserLog 命令获取该 UTC 时间段的日志。 仅当“date”字段名称包含以前日期（UTC 时间）的值时，使用情况日志才可用。 当前日期中的使用情况日志不可用。
请参阅示例，了解如何更改 DateTime 值，以适应本地时间所需的转换。
有关保护使用情况日志记录和分步示例的详细信息，请参阅 日志记录和分析 Azure 在形成保护中的保护使用情况。
示例
示例 1：获取日期范围的用户日志
PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -FromDate '12/12/2015' -ToDate '12/15/2015' -NumberOfThreads 10此命令将创建的用户日志从 2015 年 12 月 12 日到 2015 年 12 月 15 日（UTC 时间）下载到文件夹 C：\Logs。
该命令使用 10 个线程下载日志。
示例 2：获取日期的用户日志
PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -ForDate '12/5/2015'此命令将 2015/12/5 的用户日志（UTC 时间）下载到文件夹 C：\Logs。
示例 3：获取日期的用户日志，并考虑 UTC +偏移时间转换
PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -ForDate '2/2/2016 12:00:00'此命令演示如何在将用户日志下载到文件夹 C：\Logs 之前，考虑从本地时间开始的 UTC +偏移时间转换。
你位于新西兰，这意味着计算机的本地时间是 UTC+12，你希望在本地时间（而不是 UTC）下载 2/2/2 的日志。 如果未指定日期为 12：00：00 的时间，则日志将仅包含前 12 小时 2/2/2 的数据（以及前一天的最后 12 小时）。
示例 4：获取日期范围的用户日志，同时考虑 UTC -offset 时间转换
PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -FromDate '2/1/2016 18:00:00' -ToDate '2/9/15/2016 18:00:00'此命令演示如何在将用户日志下载到文件夹 C：\Logs 之前考虑从本地时间 -offset UTC 时间转换。
你位于美国休斯顿，这意味着计算机的本地时间是 UTC-6，并且你希望从 2016 年 2 月 2 日至 2016 年 2 月 9 日下载日志，而不是 UTC。
如果未指定之前 18：00：00：00 的日期和时间，则本地时间的前 6 小时（以及结束日期的另外 6 小时）将丢失数据。
参数
-Force
指示此 cmdlet 会覆盖相同日期或日期范围的现有日志文件，而不提示进行确认。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ForDate
将日志文件的日期（可选）指定为 DateTime 对象。
如果不使用 fromDate 参数
若要获取 DateTime 对象，请使用 Get-Date cmdlet。
| 类型: | DateTime |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-FromDate
将日志文件的开始日期（可选）指定为 DateTime 对象。
如果不使用 ForDate 参数，请使用此参数。
如果指定此参数而不是 ToDate，则结束日期是运行命令的一天。
| 类型: | DateTime |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-NumberOfThreads
指定要用于下载日志的线程数。
此参数的可接受值为：1-32。
默认值为 3。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Path
指定要在其中保存日志的文件夹的现有路径。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-ToDate
将日志文件的停止日期（可选）指定为 DateTime 对象。
（可选）使用 fromDate 参数指定此参数以指定特定的日期范围。 如果使用 FromDate 参数时未指定此参数，则结束日期是运行命令的一天。
| 类型: | DateTime |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |