你当前正在访问 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，然后转换为 UTC。
如果指定日期 (的时间，例如 -ForDate '2/1/2016 15：00：00') ，该日期和时间将转换为 UTC。 然后， Get-AipServiceUserLog 命令获取该 UTC 时间段的日志。 仅当“日期”字段名称包含上一个日期 (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，你希望下载 2016 年 2 月 2 日（而不是 UTC）的日志。 如果未指定日期为 12：00：00，则日志将仅包含 2016/2/2 (的前 12 小时和前一天) 的最后 12 小时的数据。
示例 4：获取日期范围的用户日志，同时考虑 UTC 偏移时间转换
PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -FromDate '2/1/2016 18:00:00' -ToDate '2/9/15/2016 18:00:00'此命令显示，在将用户日志下载到文件夹 C：\Logs 之前，可能需要如何考虑从本地时间开始的 UTC 偏移时间转换。
你位于美国休斯顿，这意味着你的计算机的本地时间是 UTC-6，你希望从 2016/2/2 到 2016/2/9/2016 的本地时间下载日志，而不是 UTC。
如果未指定上一个日期和时间 18：00：00，则日志将缺少 2016/2/2 本地时间前 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 |