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

Add-AzLogProfile

创建新的活动日志配置文件。 此配置文件用于将活动日志存档到 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

参数

-Category

指定类别列表。

类型:List<T>[String]
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Confirm

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

类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DefaultProfile

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

类型:IAzureContextContainer
别名:AzContext, AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Location

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

类型:List<T>[String]
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Name

指定配置文件的名称。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-RetentionInDays

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

类型:Nullable<T>[Int32]
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-ServiceBusRuleId

指定服务总线规则的 ID。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-StorageAccountId

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

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-WhatIf

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

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符: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