Condividi tramite

Set-AzureRmDiagnosticSetting

  • Riferimento
Modulo:
AzureRM.Insights

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

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

Set-AzureRmDiagnosticSetting
   -ResourceId <String>
   [-Name <String>]
   [-StorageAccountId <String>]
   [-ServiceBusRuleId <String>]
   [-EventHubName <String>]
   [-EventHubAuthorizationRuleId <String>]
   [-Enabled <Boolean>]
   [-Categories <System.Collections.Generic.List`1[System.String]>]
   [-MetricCategory <System.Collections.Generic.List`1[System.String]>]
   [-Timegrains <System.Collections.Generic.List`1[System.String]>]
   [-RetentionEnabled <Boolean>]
   [-WorkspaceId <String>]
   [-RetentionInDays <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureRmDiagnosticSetting
   -InputObject <PSServiceDiagnosticSettings>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-AzureRmDiagnosticSetting abilita o disabilita ogni intervallo di tempo e 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-AzureRmDiagnosticSetting -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-AzureRmDiagnosticSetting -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-AzureRmDiagnosticSetting -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 abilita 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-AzureRmDiagnosticSetting -ResourceId "Resource01" -Enabled $True -Categories 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-AzureRmDiagnosticSetting -ResourceId "Resource01" -Enabled $True -Categories Category1,Category2 -Timegrains 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-AzureRmDiagnosticSetting -ResourceId "Resource01" | Set-AzureRmDiagnosticSetting

Questo comando usa la pipeline di PowerShell per impostare (non apportare modifiche) un'impostazione di diagnostica.

Parametri

-Categories

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.

Tipo:List<T>[String]
Alias:Category
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Enabled

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

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-EventHubAuthorizationRuleId

ID regola di autorizzazione dell'hub eventi

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-EventHubName

Nome dell'hub eventi

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-InputObject

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

Tipo:PSServiceDiagnosticSettings
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-MetricCategory

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

Tipo:List<T>[String]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ResourceId

Specifica l'ID della risorsa.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-RetentionEnabled

Indica se la conservazione delle informazioni di diagnostica è abilitata.

Tipo:Nullable<T>[Boolean]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-RetentionInDays

Specifica i criteri di conservazione, in giorni.

Tipo:Nullable<T>[Int32]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ServiceBusRuleId

ID regola bus di servizio.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-StorageAccountId

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Timegrains

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.

Tipo:List<T>[String]
Alias:Timegrain
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WorkspaceId

ID dell'area di lavoro

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

PSServiceDiagnosticSettings

Parametri: InputObject (ByValue)

String

Boolean

List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Nullable<T>[[System.Boolean, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Output

PSServiceDiagnosticSettings