Set-AzDiagnosticSetting

Riferimento

Modulo:: Az.Monitor

Imposta le impostazioni dei log e delle metriche per la risorsa.

Sintassi

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

Descrizione

Il cmdlet Set-AzDiagnosticSetting abilita o disabilita ogni intervallo di tempo e la categoria di log per la risorsa specifica. I log e le metriche vengono archiviati nell'account di archiviazione specificato. Questo cmdlet implementa il modello ShouldProcess, ovvero potrebbe richiedere conferma all'utente prima di creare, modificare o rimuovere la risorsa.

Esempio

Esempio 1: Abilitare tutte le metriche e i log per una risorsa

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

Questo comando abilita tutte le metriche e i log disponibili per Resource01.

Esempio 2: Disabilitare tutte le metriche e i log

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

Questo comando disabilita tutte le metriche e i log disponibili per la risorsa Resource01.

Esempio 3: Abilitare/disabilitare più categorie di metriche

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

Questo comando disabilita le categorie di metriche denominate Category1 e Category2. Tutte le altre categorie rimangono invariate.

Esempio 4: Abilitare/disabilitare più categorie di log

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

Questo comando abilita Category1 e Category2. Tutte le altre metriche e categorie di log rimangono invariate.

Esempio 4: Abilitare un intervallo di tempo e più categorie

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

Questo comando abilita solo Category1, Category2 e time grain PT1M. Tutti gli altri grani e categorie di tempo sono invariati.

Esempio 5: Uso della pipeline

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

Questo comando usa la pipeline di PowerShell per impostare (nessuna modifica apportata) un'impostazione di diagnostica.

Parametri

-Category

Specifica l'elenco delle categorie di log da abilitare o disabilitare, in base al valore abilitato. Se non viene specificata alcuna categoria, questo comando opera su tutte le categorie supportate.

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

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Enabled

Indica se abilitare la diagnostica. Specificare $True per abilitare la diagnostica o $False per disabilitare la diagnostica.

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

-EventHubAuthorizationRuleId

ID regola di autorizzazione dell'hub eventi

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

-EventHubName

Nome dell'hub eventi

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

-ExportToResourceSpecific

Flag che indica che l'esportazione in LA deve essere eseguita in una tabella specifica della risorsa, ovvero una tabella dedicata o fissa dello schema, anziché la tabella dello schema dinamica predefinita denominataAzureDiagnostics.

Questo argomento è valido solo quando viene specificato anche l'argomento -workspaceId .

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

-InputObject

Oggetto di input (possibile dalla pipeline). Il nome e resourceId verranno estratti da questo oggetto.

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

-MetricCategory

Elenco di categorie di metriche. Se non viene specificata alcuna categoria, questo comando opera su tutte le categorie supportate.

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

-Name

Nome dell'impostazione di diagnostica. Il valore predefinito è service.

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

-ResourceId

Specifica l'ID della risorsa.

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

-RetentionEnabled

Indica se la conservazione delle informazioni di diagnostica è abilitata.

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

-RetentionInDays

Specifica i criteri di conservazione, in giorni.

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

-ServiceBusRuleId

ID regola del bus di servizio.

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

-StorageAccountId

Specifica l'ID dell'account di archiviazione in cui salvare i dati.

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

-Timegrain

Specifica il tempo di abilitazione o disabilitazione per le metriche, in base al valore abilitato. Se non si specifica un intervallo di tempo, questo comando opera su tutti i grani di tempo disponibili.

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

-WorkspaceId

ID risorsa dell'area di lavoro Log Analytics a cui inviare log/metriche

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

Input

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

Output