Set-AzDiagnosticSetting
Anger logg- och måttinställningarna för resursen.
Syntax
OldSetDiagnosticSetting (Standard)
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
Cmdleten Set-AzDiagnosticSetting aktiverar eller inaktiverar varje tidsintervall och loggkategori för den specifika resursen.
Loggarna och måtten lagras i det angivna lagringskontot.
Den här cmdleten implementerar ShouldProcess-mönstret, dvs. den kan begära bekräftelse från användaren innan den faktiskt skapar, ändrar eller tar bort resursen.
Exempel
Exempel 1: Aktivera alla mått och loggar för en resurs
PS C:\>Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $True
Det här kommandot aktiverar alla tillgängliga mått och loggar för Resource01.
Exempel 2: Inaktivera alla mått och loggar
PS C:\>Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $False
Det här kommandot inaktiverar alla tillgängliga mått och loggar för resursen Resource01.
Exempel 3: Aktivera/inaktivera flera måttkategorier
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
Det här kommandot inaktiverar de måttkategorier som kallas Kategori1 och Kategori2.
Alla andra kategorier är desamma.
Exempel 4: Aktivera/inaktivera flera loggkategorier
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
Det här kommandot aktiverar Category1 och Category2.
Alla andra mått- och loggkategorier förblir desamma.
Exempel 4: Aktivera ett tidsintervall och flera kategorier
PS C:\>Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $True -Category Category1,Category2 -Timegrain PT1M
Det här kommandot aktiverar endast PT1, Category2 och tidsintervall PT1M.
Alla andra tidsintervall och kategorier är oförändrade.
Exempel 5: Använda pipeline
PS C:\>Get-AzDiagnosticSetting -ResourceId "Resource01" | Set-AzDiagnosticSetting -Enabled $True -Category Category1,Category2
Det här kommandot använder PowerShell-pipelinen för att ange (ingen ändring har gjorts) en diagnostikinställning.
Parametrar
-Category
Anger listan över loggkategorier som ska aktiveras eller inaktiveras, enligt värdet för Aktiverad .
Om ingen kategori anges körs det här kommandot i alla kategorier som stöds.
Parameteregenskaper
Typ: List<T> [ String ]
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
OldSetDiagnosticSetting
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: True Värde från återstående argument: False
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: None Stöder jokertecken: False DontShow: False Alias: jfr
Parameteruppsättningar
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
-DefaultProfile
Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure
Parameteregenskaper
Typ: IAzureContextContainer
Standardvärde: None Stöder jokertecken: False DontShow: False Alias: AzContext, AzureRmContext, AzureCredential
Parameteruppsättningar
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
-Enabled
Anger om diagnostik ska aktiveras.
Ange $True för att aktivera diagnostik eller $False för att inaktivera diagnostik.
Parameteregenskaper
Typ: Boolean
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
OldSetDiagnosticSetting
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: True Värde från återstående argument: False
-EventHubAuthorizationRuleId
Händelsehubbens auktoriseringsregel-ID
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
OldSetDiagnosticSetting
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: True Värde från återstående argument: False
-EventHubName
Händelsehubbens namn
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
OldSetDiagnosticSetting
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: True Värde från återstående argument: False
-ExportToResourceSpecific
Flagga som anger att exporten till LA måste göras till en resursspecifik tabell, även kallad dedikerad eller fast schematabell, i motsats till standardtabellen för dynamiskt schema med namnet AzureDiagnostics .
Det här argumentet gäller endast när argumentet -workspaceId också anges.
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
OldSetDiagnosticSetting
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: True Värde från återstående argument: False
Indataobjektet (möjligt från pipelinen.) Namnet och resourceId extraheras från det här objektet.
NewSetDiagnosticSetting
Position: Named Obligatorisk: True Värde från pipeline: True Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
-MetricCategory
Listan över måttkategorier.
Om ingen kategori anges körs det här kommandot i alla kategorier som stöds.
Parameteregenskaper
Typ: List<T> [ String ]
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
OldSetDiagnosticSetting
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: True Värde från återstående argument: False
-Name
Namnet på diagnostikinställningen. Standardvärdet är tjänst .
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
OldSetDiagnosticSetting
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: True Värde från återstående argument: False
-ResourceId
Anger resursens ID.
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
OldSetDiagnosticSetting
Position: Named Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: True Värde från återstående argument: False
-RetentionEnabled
Anger om kvarhållning av diagnostikinformation är aktiverat.
Parameteregenskaper
Parameteruppsättningar
OldSetDiagnosticSetting
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: True Värde från återstående argument: False
-RetentionInDays
Anger kvarhållningsprincipen i dagar.
Parameteregenskaper
Typ: Nullable<T> [ Int32 ]
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
OldSetDiagnosticSetting
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: True Värde från återstående argument: False
-ServiceBusRuleId
Service Bus-regel-ID: t.
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
OldSetDiagnosticSetting
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: True Värde från återstående argument: False
-StorageAccountId
Anger ID för lagringskontot där data ska sparas.
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
OldSetDiagnosticSetting
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: True Värde från återstående argument: False
-Timegrain
Anger de tidsintervall som ska aktiveras eller inaktiveras för mått, enligt värdet för Aktiverad .
Om du inte anger ett tidsintervall körs det här kommandot på alla tillgängliga tidsintervall.
Parameteregenskaper
Typ: List<T> [ String ]
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
OldSetDiagnosticSetting
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: True Värde från återstående argument: False
-WhatIf
Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: None Stöder jokertecken: False DontShow: False Alias: Wi
Parameteruppsättningar
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
-WorkspaceId
Resurs-ID för Log Analytics-arbetsytan för att skicka loggar/mått till
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
OldSetDiagnosticSetting
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: True Värde från återstående argument: False
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters .
Utdata