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

Set-AzDiagnosticSetting

模块:: Az.Monitor Module

设置资源的日志和指标设置。

语法

OldSetDiagnosticSetting （默认值）

Set-AzDiagnosticSetting
    -ResourceId <String>
    [-Name <String>]
    [-StorageAccountId <String>]
    [-ServiceBusRuleId <String>]
    [-EventHubName <String>]
    [-EventHubAuthorizationRuleId <String>]
    [-Enabled <Boolean>]
    [-Category <System.Collections.Generic.List`1[System.String]>]
    [-MetricCategory <System.Collections.Generic.List`1[System.String]>]
    [-Timegrain <System.Collections.Generic.List`1[System.String]>]
    [-RetentionEnabled <Boolean>]
    [-WorkspaceId <String>]
    [-ExportToResourceSpecific]
    [-RetentionInDays <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

NewSetDiagnosticSetting

Set-AzDiagnosticSetting
    -InputObject <PSServiceDiagnosticSettings>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

Set-AzDiagnosticSetting cmdlet 启用或禁用特定资源的每次粒度和日志类别。日志和指标存储在指定的存储帐户中。此 cmdlet 实现 ShouldProcess 模式，即在实际创建、修改或删除资源之前，它可能会请求用户确认。

示例

示例 1：为资源启用所有指标和日志

PS C:\>Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $True

此命令启用 Resource01 的所有可用指标和日志。

示例 2：禁用所有指标和日志

PS C:\>Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $False

此命令禁用资源 Resource01 的所有可用指标和日志。

示例 3：启用/禁用多个指标类别

PS C:\>Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $False -MetricCategory MetricCategory1,MetricCategory2
StorageAccountId   : <storageAccountId>
StorageAccountName : <storageAccountName>
Metrics
   Enabled   : False
   Category  : MetricCategory1
   Timegrain : PT1M
   Enabled   : False
   Category  : MetricCategory2
   Timegrain : PT1H
   Enabled   : True
   Category  : MetricCategory3
   Timegrain : PT1H
Logs
   Enabled  : True
   Category : Category1
   Enabled  : True
   Category : Category2
   Enabled  : True
   Category : Category3
   Enabled  : False
   Category : Category4

此命令禁用名为 Category1 和 Category2 的指标类别。所有其他类别保持不变。

示例 4：启用/禁用多个日志类别

PS C:\>Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $True -Category Category1,Category2
StorageAccountId   : <storageAccountId>
StorageAccountName : <storageAccountName>
Metrics
   Enabled   : False
   Category  : MetricCategory1
   Timegrain : PT1M
   Enabled   : False
   Category  : MetricCategory2
   Timegrain : PT1H
   Enabled   : True
   Category  : MetricCategory3
   Timegrain : PT1H
Logs
   Enabled  : True
   Category : Category1
   Enabled  : True
   Category : Category2
   Enabled  : True
   Category : Category3
   Enabled  : False
   Category : Category4

此命令启用 Category1 和 Category2。所有其他指标和日志类别保持不变。

示例 4：启用时间粒度和多个类别

PS C:\>Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $True -Category Category1,Category2 -Timegrain PT1M

此命令仅启用 Category1、Category2 和时间粒度 PT1M。所有其他时间粒度和类别保持不变。

示例 5：使用管道

PS C:\>Get-AzDiagnosticSetting -ResourceId "Resource01" | Set-AzDiagnosticSetting -Enabled $True -Category Category1,Category2

此命令使用 PowerShell 管道设置诊断设置（未进行更改）。

参数

-Category

根据 Enabled 的值指定要启用或禁用的日志类别列表。如果未指定任何类别，此命令将对所有受支持的类别进行作。

参数属性

类型:	List<T>[String]
默认值:	None
支持通配符:	False
不显示:	False

参数集

OldSetDiagnosticSetting

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-Confirm

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

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DefaultProfile

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

参数属性

类型:	IAzureContextContainer
默认值:	None
支持通配符:	False
不显示:	False
别名:	AzContext, AzureRmContext, AzureCredential

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Enabled

指示是否启用诊断。指定$True以启用诊断，或$False禁用诊断。

参数属性

类型:	Boolean
默认值:	None
支持通配符:	False
不显示:	False

参数集

OldSetDiagnosticSetting

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-EventHubAuthorizationRuleId

事件中心授权规则 ID

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

OldSetDiagnosticSetting

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-EventHubName

事件中心名称

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

OldSetDiagnosticSetting

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-ExportToResourceSpecific

指示导出到 LA 的标志必须执行到特定于资源的表（即专用或固定架构表），而不是名为 AzureDiagnostics的默认动态架构表。

仅当参数 -workspaceId 也给定时，此参数才有效。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

OldSetDiagnosticSetting

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-InputObject

输入对象（可能来自管道）。将从此对象中提取名称和 resourceId。

参数属性

类型:	PSServiceDiagnosticSettings
默认值:	None
支持通配符:	False
不显示:	False

参数集

NewSetDiagnosticSetting

Position:	Named
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-MetricCategory

指标类别的列表。如果未指定任何类别，此命令将对所有受支持的类别进行作。

参数属性

类型:	List<T>[String]
默认值:	None
支持通配符:	False
不显示:	False

参数集

OldSetDiagnosticSetting

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-Name

诊断设置的名称。默认值为服务。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

OldSetDiagnosticSetting

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-ResourceId

指定资源的 ID。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

OldSetDiagnosticSetting

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-RetentionEnabled

指示是否启用诊断信息的保留期。

参数属性

类型:	Nullable<T>[Boolean]
默认值:	None
支持通配符:	False
不显示:	False

参数集

OldSetDiagnosticSetting

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-RetentionInDays

指定保留策略（以天为单位）。

参数属性

类型:	Nullable<T>[Int32]
默认值:	None
支持通配符:	False
不显示:	False

参数集

OldSetDiagnosticSetting

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-ServiceBusRuleId

服务总线规则 ID。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

OldSetDiagnosticSetting

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-StorageAccountId

指定要在其中保存数据的存储帐户的 ID。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

OldSetDiagnosticSetting

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-Timegrain

根据 Enabled 的值指定要启用或禁用指标的时间粒度。如果未指定时间粒度，此命令将对所有可用的时间粒度进行作。

参数属性

类型:	List<T>[String]
默认值:	None
支持通配符:	False
不显示:	False

参数集

OldSetDiagnosticSetting

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。命令脚本未运行。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	无线

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WorkspaceId

要向其发送日志/指标的 Log Analytics 工作区的资源 ID

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

OldSetDiagnosticSetting

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。有关详细信息，请参阅 about_CommonParameters。

通过

Set-AzDiagnosticSetting

语法

OldSetDiagnosticSetting （默认值）

NewSetDiagnosticSetting

说明

示例

示例 1：为资源启用所有指标和日志

示例 2：禁用所有指标和日志

示例 3：启用/禁用多个指标类别

示例 4：启用/禁用多个日志类别

示例 4：启用时间粒度和多个类别

示例 5：使用管道

参数

-Category

参数属性

参数集

-Confirm

参数属性

参数集

-DefaultProfile

参数属性

参数集

-Enabled

参数属性

参数集

-EventHubAuthorizationRuleId

参数属性

参数集

-EventHubName

参数属性

参数集

-ExportToResourceSpecific

参数属性

参数集

-InputObject

参数属性

参数集

-MetricCategory

参数属性

参数集

-Name

参数属性

参数集

-ResourceId

参数属性

参数集

-RetentionEnabled

参数属性

参数集

-RetentionInDays

参数属性

参数集

-ServiceBusRuleId

参数属性

参数集

-StorageAccountId

参数属性

参数集

-Timegrain

参数属性

参数集

-WhatIf

参数属性

参数集

-WorkspaceId

参数属性

参数集

CommonParameters

输入

PSServiceDiagnosticSettings

String

Boolean

List<T>

Nullable<T>

Nullable<T>

输出

PSServiceDiagnosticSettings

相关链接