Condividi tramite

Set-AzDiagnosticSetting

Modulo:
Az.Monitor Module

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

Sintassi

OldSetDiagnosticSetting (impostazione predefinita). 

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

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.

Proprietà dei parametri

Tipo:

List<T>[String]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

OldSetDiagnosticSetting
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DefaultProfile

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

Proprietà dei parametri

Tipo:IAzureContextContainer
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Enabled

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

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

OldSetDiagnosticSetting
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-EventHubAuthorizationRuleId

ID regola di autorizzazione dell'hub eventi

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

OldSetDiagnosticSetting
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-EventHubName

Nome dell'hub eventi

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

OldSetDiagnosticSetting
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti: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 .

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

OldSetDiagnosticSetting
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-InputObject

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

Proprietà dei parametri

Tipo:PSServiceDiagnosticSettings
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

NewSetDiagnosticSetting
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-MetricCategory

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

Proprietà dei parametri

Tipo:

List<T>[String]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

OldSetDiagnosticSetting
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Name

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

OldSetDiagnosticSetting
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-ResourceId

Specifica l'ID della risorsa.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

OldSetDiagnosticSetting
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-RetentionEnabled

Indica se la conservazione delle informazioni di diagnostica è abilitata.

Proprietà dei parametri

Tipo:

Nullable<T>[Boolean]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

OldSetDiagnosticSetting
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-RetentionInDays

Specifica i criteri di conservazione, in giorni.

Proprietà dei parametri

Tipo:

Nullable<T>[Int32]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

OldSetDiagnosticSetting
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-ServiceBusRuleId

ID regola del bus di servizio.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

OldSetDiagnosticSetting
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-StorageAccountId

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

OldSetDiagnosticSetting
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:

List<T>[String]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

OldSetDiagnosticSetting
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-WhatIf

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WorkspaceId

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

OldSetDiagnosticSetting
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

PSServiceDiagnosticSettings

String

Boolean

List<T>

Nullable<T>

Nullable<T>

Output

PSServiceDiagnosticSettings