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

Get-AzLog

检索活动日志事件。

语法

Get-AzLog
   [-StartTime <DateTime>]
   [-EndTime <DateTime>]
   [-Status <String>]
   [-Caller <String>]
   [-DetailedOutput]
   [-CorrelationId] <String>
   [-MaxRecord <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzLog
   [-StartTime <DateTime>]
   [-EndTime <DateTime>]
   [-Status <String>]
   [-Caller <String>]
   [-DetailedOutput]
   [-ResourceId] <String>
   [-MaxRecord <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzLog
   [-StartTime <DateTime>]
   [-EndTime <DateTime>]
   [-Status <String>]
   [-Caller <String>]
   [-DetailedOutput]
   [-ResourceGroupName] <String>
   [-MaxRecord <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzLog
   [-StartTime <DateTime>]
   [-EndTime <DateTime>]
   [-Status <String>]
   [-Caller <String>]
   [-DetailedOutput]
   [-ResourceProvider] <String>
   [-MaxRecord <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzLog
   [-StartTime <DateTime>]
   [-EndTime <DateTime>]
   [-Status <String>]
   [-Caller <String>]
   [-DetailedOutput]
   [-MaxRecord <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

说明

Get-AzLog cmdlet 检索活动日志事件。 事件可以与当前订阅 ID、关联 ID、资源组、资源 ID 或资源提供程序相关联。

示例

示例 1:按订阅 ID 获取事件日志

PS C:\>Get-AzLog

此命令最多列出与用户订阅 ID 关联的 1000 个事件,该 ID 从当前日期/时间开始 7 天。

示例 2:按包含最大事件数的订阅 ID 获取事件日志

PS C:\>Get-AzLog -MaxRecord 100

此命令最多列出与用户订阅 ID 关联的 100 个事件,该 ID 从当前日期/时间开始 7 天。

示例 3:按包含开始时间的订阅 ID 获取事件日志。

PS C:\>Get-AzLog -StartTime 2017-06-01T10:30

此命令列出了与用户订阅 ID 关联的最多 1000 个事件,这些事件发生在 2017-06-01T10:30 本地时间(如果日期/时间不超过当前日期/时间的 90 天)。

示例 4:按包含开始时间和结束时间的订阅 ID 获取事件日志。

PS C:\>Get-AzLog -StartTime 2017-04-01T10:30 -EndTime 2017-04-14T11:30

此命令列出了与用户订阅 ID 关联的最多 1000 个事件,这些事件发生在 2017-04-01T10:30 本地时间之后,以及 2017-04-14T11:30 本地时间(例如,如果整个日期/时间范围不低于当前日期/时间的 90 天,即保留期)。

示例 5:按关联 ID 获取事件日志

PS C:\>Get-AzLog -CorrelationId "60c694d0-e46f-4c12-bed1-9b7aef541c23"

此命令最多列出 1000 个与从当前日期/时间起 7 天内发生的指定关联 ID 关联的事件。 注意:这通常是一个事件。

示例 6:通过具有最大事件数的相关 ID 获取事件日志

PS C:\>Get-AzLog -CorrelationId "60c694d0-e46f-4c12-bed1-9b7aef541c23" -MaxRecord 100

此命令最多列出 100 个与从当前日期/时间起 7 天内发生的指定关联 ID 关联的事件。 注意:这通常是一个事件。

示例 7:按相关 ID 和开始时间获取事件日志

PS C:\>Get-AzLog -CorrelationId "60c694d0-e46f-4c12-bed1-9b7aef541c23" -StartTime 2017-05-22T04:30:00

此命令最多列出 1000 个与在 2017-05-2017-05-22T04:30:00 本地时间(如果开始时间不超过当前日期/时间 90 天)之后发生的指定关联 ID 关联的事件。 注意:这通常是一个事件。

示例 8:通过包含开始时间和结束时间的相关 ID 获取事件日志

PS C:\>Get-AzLog -CorrelationId "60c694d0-e46f-4c12-bed1-9b7aef541c23" -StartTime 2017-04-15T04:30:00 -EndTime 2017-04-25T12:30:00

此命令将列出与指定关联 ID 关联的最多 1000 个事件,这些事件发生在 2017-04-15T04:30 本地时间之后,但在 2017-04-25T12:30 本地时间之前,如果整个日期/时间范围不低于当前日期/时间的 90 天,即保留期。

示例 9:获取资源组的事件日志

PS C:\>Get-AzLog -ResourceGroupName "Contoso-Web-CentralUS"

此命令最多列出 1000 个与从当前日期/时间起 7 天内发生的指定资源组关联的事件。

示例 10:获取具有最大事件数的资源组的事件日志

PS C:\>Get-AzLog -ResourceGroup "Contoso-Web-CentralUS" -MaxRecord 100

此命令最多列出 100 个与从当前日期/时间开始 7 天的指定资源组关联的事件。

示例 11:按开始时间获取资源组的事件日志

PS C:\>Get-AzLog -ResourceGroup "Contoso-Web-CentralUS" -StartTime 2017-05-22T04:30:00

此命令列出了与指定资源组关联的最多 1000 个事件,这些事件发生在 2017-05-22T04:30:00 本地时间(如果开始时间不低于当前日期/时间的 90 天)。

示例 12:获取具有开始时间和结束时间的资源组的事件日志

PS C:\>Get-AzLog -ResourceGroup "Contoso-Web-CentralUS" -StartTime 2017-04-15T04:30 -EndTime 2017-04-25T12:30

此命令列出了与指定资源组关联的最多 1000 个事件,这些事件发生在 2017-04-15T04:30 本地时间,但在 2017-04-25T12:30 本地时间(例如,如果整个日期/时间范围不低于当前日期/时间的 90 天)之前,即保留期。

示例 13:按资源 ID 获取事件日志

PS C:\>Get-AzLog -ResourceId "/subscriptions/623d50f1-4fa8-4e46-a967-a9214aed43ab/ResourceGroups/Contoso-Web-CentralUS/providers/Microsoft.Web/ServerFarms/Contoso1"

此命令最多列出 1000 个与从当前日期/时间起 7 天内发生的指定资源 ID 关联的事件。

示例 14:按具有最大事件数的资源 ID 获取事件日志

PS C:\>Get-AzLog -ResourceId "/subscriptions/623d50f1-4fa8-4e46-a967-a9214aed43ab/ResourceGroups/Contoso-Web-CentralUS/providers/Microsoft.Web/ServerFarms/Contoso1" -MaxRecord 100

此命令最多列出 100 个与从当前日期/时间起 7 天内发生的指定资源 ID 关联的事件。

示例 15:按具有开始时间的资源 ID 获取事件日志

PS C:\>Get-AzLog -ResourceId "/subscriptions/623d50f1-4fa8-4e46-a967-a9214aed43ab/ResourceGroups/Contoso-Web-CentralUS/providers/Microsoft.Web/ServerFarms/Contoso1" -StartTime 2017-05-22T04:30

此命令列出了与在 2017-05-2017-05-22T04:30:00 本地时间(如果开始时间不低于当前日期/时间 90 天)之前的 90 天关联的最多 1000 个事件。

示例 16:按具有开始时间和结束时间的资源 ID 获取事件日志

PS C:\>Get-AzLog -ResourceId "/subscriptions/623d50f1-4fa8-4e46-a967-a9214aed43ab/ResourceGroups/Contoso-Web-CentralUS/providers/Microsoft.Web/ServerFarms/Contoso1" -StartTime 2017-04-15T04:30 -EndTime 2017-04-25T12:30

此命令列出了与指定资源 ID 关联的最多 1000 个事件,这些事件发生在 2017-04-15T04:30 本地时间之后,但在 2017-04-25T12:30 本地时间之前,如果整个日期/时间范围不低于当前日期/时间的 90 天,即保留期。

示例 17:按资源提供程序获取事件日志

PS C:\>Get-AzLog -ResourceProvider "Microsoft.Web"

此命令最多列出与指定资源提供程序关联的 1000 个事件,这些事件从当前日期/时间开始 7 天。

示例 18:按具有最大事件数的资源提供程序获取事件日志

PS C:\>Get-AzLog -ResourceProvider "Microsoft.Web" -MaxRecord 100

此命令最多列出与指定资源提供程序关联的 100 个事件,这些事件从当前日期/时间开始 7 天。

示例 19:使用开始时间按资源提供程序获取事件日志

PS C:\>Get-AzLog -ResourceProvider "Microsoft.Web" -StartTime 2017-05-22T04:30

此命令列出了与指定资源提供程序关联的最多 1000 个事件,这些事件发生在 2017-05-22T04:30:00 本地时间(如果开始时间不低于当前日期/时间的 90 天)。

示例 20:使用开始时间和结束时间按资源提供程序获取事件日志

PS C:\>Get-AzLog -ResourceProvider "Microsoft.Web" -StartTime 2017-04-15T04:30 -EndTime 2017-04-25T12:30

此命令列出了与指定资源提供程序关联的最多 1000 个事件,这些事件发生在 2017-04-15T04:30 本地时间之后,但在 2017-04-25T12:30 本地时间(例如,如果整个日期/时间范围不低于当前日期/时间的 90 天)之前,即保留期。

参数

-Caller

指定调用方。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-CorrelationId

指定关联 ID。 此参数是必需的。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

用于与 azure 通信的凭据、帐户、租户和订阅

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DetailedOutput

指示此 cmdlet 显示详细的输出。 默认情况下,输出汇总。

Type:SwitchParameter
Position:Named
Default value:Switch not present = False, i.e. output summarized
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-EndTime

指定本地时间查询的结束时间。 默认值为当前时间。 该值必须晚于 StartTime。 可以使用 Get-Date cmdlet 获取 DateTime 对象。

Type:Nullable<T>[DateTime]
Position:Named
Default value:Current date (time: 00:00:00 AM) + 1 day
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MaxRecord

指定要为指定筛选器提取的记录总数。 默认值为 1000,接受的最大值为 100000。 忽略负值和 0,将使用默认值。

Type:Int32
Position:Named
Default value:1000
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

指定资源组的名称。

Type:String
Aliases:ResourceGroup
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

指定资源 ID。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceProvider

按资源提供程序指定筛选器。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StartTime

指定本地时间查询的开始时间。 默认值为 EndTime 减去 7 天。 可以使用 Get-Date cmdlet 获取 DateTime 对象。

Type:Nullable<T>[DateTime]
Position:Named
Default value:EndTime - 7 days
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Status

指定状态。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

输入

Nullable<T>[[System.DateTime, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

String

SwitchParameter

Int32

输出

PSEventData