共用方式為


Set-AzDiagnosticSetting

設定資源的記錄和計量設定。

語法

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>]
Set-AzDiagnosticSetting
   -InputObject <PSServiceDiagnosticSettings>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

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]
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

-Enabled

指出是否要啟用診斷。 指定$True以啟用診斷,或$False停用診斷。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-EventHubAuthorizationRuleId

事件中樞授權規則標識碼

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-EventHubName

事件中樞名稱

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ExportToResourceSpecific

指出導出至 LA 的旗標必須執行至資源特定數據表,也就是專用或固定架構數據表,而不是稱為 AzureDiagnostics 的預設動態架構數據表。

只有當自變數 -workspaceId 也提供時,這個自變數才有效。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-InputObject

輸入物件(可能來自管線。)名稱和 resourceId 將會從這個物件擷取。

類型:PSServiceDiagnosticSettings
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-MetricCategory

計量類別清單。 如果未指定任何類別,此命令會在所有支援的類別上運作。

類型:List<T>[String]
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Name

診斷設定的名稱。 預設值為 service

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ResourceId

指定資源的識別碼。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-RetentionEnabled

指出是否啟用診斷資訊的保留期。

類型:Nullable<T>[Boolean]
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-RetentionInDays

指定保留原則,以天為單位。

類型:Nullable<T>[Int32]
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ServiceBusRuleId

服務匯流排 規則標識碼。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-StorageAccountId

指定要在其中儲存數據的記憶體帳戶標識碼。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Timegrain

根據 Enabled 的值,指定要啟用或停用計量的時間粒紋。 如果您未指定時間粒紋,此命令會在所有可用的時間粒紋上運作。

類型:List<T>[String]
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:SwitchParameter
別名:wi
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-WorkspaceId

要傳送記錄/計量的Log Analytics工作區資源標識碼

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

輸入

PSServiceDiagnosticSettings

String

Boolean

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

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

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

輸出

PSServiceDiagnosticSettings