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

Add-AzLogProfile

  • 参考
模块:
Az.Monitor

创建新的活动日志配置文件。 此配置文件用于将活动日志存档到 Azure 存储帐户，或将其流式传输到同一订阅中的 Azure 事件中心。

语法

Add-AzLogProfile
   -Name <String>
   [-StorageAccountId <String>]
   [-ServiceBusRuleId <String>]
   [-RetentionInDays <Int32>]
   -Location <System.Collections.Generic.List`1[System.String]>
   [-Category <System.Collections.Generic.List`1[System.String]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Add-AzLogProfile cmdlet 创建日志配置文件。

  • 存储帐户 - 仅支持标准存储帐户（不支持高级存储帐户）。 它可以是 ARM 或经典类型。 如果记录到存储帐户，则存储活动日志的成本按正常的标准存储费率计费。 每个订阅只能有一个日志配置文件，因此每个订阅只能使用一个存储帐户来导出活动日志。
  • 事件中心 - 每个订阅只能有一个日志配置文件，因此每个订阅只能使用一个事件中心来导出活动日志。 如果将活动日志流式传输到事件中心，则会应用标准事件中心定价。 在活动日志中，事件可以与区域相关，也可以是“全局”。 全局本质上意味着这些事件与区域无关，独立于区域，事实上，大多数事件属于此类别。 如果从门户设置活动日志配置文件，则会隐式添加“全局”以及用户界面中选择的任何其他区域。 使用 cmdlet 时，必须将位置显式提及与任何其他区域分开。 注意 ：- 未能在位置中设置“全局”将导致大多数活动日志未导出。 此 cmdlet 实现 ShouldProcess 模式，即在实际创建、修改或删除资源之前，它可能会请求用户确认。

示例

示例 1：添加新日志配置文件以将与位置条件匹配的活动日志导出到存储帐户

Add-AzLogProfile -Location "Global","West US" -Name ExportLogProfile -StorageAccountId /subscriptions/40gpe80s-9sb7-4f07-9042-b1b6a92ja9fk/resourceGroups/activitylogRG/providers/Microsoft.Storage/storageAccounts/activitylogstorageaccount

添加新日志配置文件以将与位置条件匹配的活动日志导出到存储帐户

示例 2

创建新的活动日志配置文件。 （自动生成）

Add-AzLogProfile -Location 'Global' -Name ExportLogProfile -RetentionInDays <Int32> -ServiceBusRuleId <String> -StorageAccountId /subscriptions/40gpe80s-9sb7-4f07-9042-b1b6a92ja9fk/resourceGroups/activitylogRG/providers/Microsoft.Storage/storageAccounts/activitylogstorageaccount

参数

-Category

指定类别列表。

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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

-Location

指定日志配置文件的位置。 有效值：运行以下 cmdlet 以获取最新位置列表。 Get-AzLocation |选择 DisplayName

Type:List<T>[String]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

指定配置文件的名称。

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

-RetentionInDays

指定保留策略（以天为单位）。 这是日志在指定的存储帐户中保留的天数。 将数据永久保留为 0。 如果未指定，则默认为 0。 标准存储或事件中心计费费率适用于数据保留。

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ServiceBusRuleId

指定服务总线规则的 ID。

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

-StorageAccountId

指定存储帐户的 ID。 ID 是存储帐户的完全限定的资源 ID，例如 /subscriptions/40gpe80s-9sb7-4f07-9042-b1b6a92ja9fk/resourceGroups/activitylogRG/providers/Microsoft。存储/storageAccounts/activitylogstorageaccount

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

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

String

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

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

输出

PSLogProfile