Dela via

Set-AzDiagnosticSetting

  • Referens
Modul:
Az.Monitor

Anger logg- och måttinställningarna för resursen.

Syntax

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

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.

Typ:List<T>[String]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Enabled

Anger om diagnostik ska aktiveras. Ange $True för att aktivera diagnostik eller $False för att inaktivera diagnostik.

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-EventHubAuthorizationRuleId

Händelsehubbens auktoriseringsregel-ID

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-EventHubName

Händelsehubbens namn

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-InputObject

Indataobjektet (möjligt från pipelinen.) Namnet och resourceId extraheras från det här objektet.

Typ:PSServiceDiagnosticSettings
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-MetricCategory

Listan över måttkategorier. Om ingen kategori anges körs det här kommandot i alla kategorier som stöds.

Typ:List<T>[String]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Namnet på diagnostikinställningen. Standardvärdet är tjänst.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ResourceId

Anger resursens ID.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-RetentionEnabled

Anger om kvarhållning av diagnostikinformation är aktiverat.

Typ:Nullable<T>[Boolean]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-RetentionInDays

Anger kvarhållningsprincipen i dagar.

Typ:Nullable<T>[Int32]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ServiceBusRuleId

Service Bus-regel-ID: t.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-StorageAccountId

Anger ID för lagringskontot där data ska sparas.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:List<T>[String]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WorkspaceId

Resurs-ID för Log Analytics-arbetsytan för att skicka loggar/mått till

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

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

Utdata

PSServiceDiagnosticSettings