你当前正在访问 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