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

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]
預設值:	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

事件中樞授權規則標識碼

參數屬性

類型:	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

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

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

OldSetDiagnosticSetting

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-ResourceId

指定資源的識別碼。

參數屬性

類型:	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

服務總線規則標識碼。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

OldSetDiagnosticSetting

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-StorageAccountId

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

參數屬性

類型:	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工作區資源標識碼

參數屬性

類型:	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

Description

範例

範例 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

相關連結