Set-AzDiagnosticSetting

Modul:

Az.Monitor Module

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

-InputObject

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

Parameteregenskaper

Typ:	PSServiceDiagnosticSettings
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

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

Typ:	Nullable<T>[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

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

Indata

PSServiceDiagnosticSettings

String

Boolean

List<T>

Nullable<T>

Nullable<T>

Utdata

PSServiceDiagnosticSettings

Relaterade länkar

• Get-AzDiagnosticSetting
• Remove-AzDiagnosticSetting