Set-AzDiagnosticSetting

Modul:

Az.Monitor Module

Nastaví protokoly a nastavení metrik pro prostředek.

Syntaxe

OldSetDiagnosticSetting (Výchozí)

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

Rutina Set-AzDiagnosticSetting povolí nebo zakáže každou kategorii agregačního intervalu a protokolu pro konkrétní prostředek. Protokoly a metriky se ukládají do zadaného účtu úložiště. Tato rutina implementuje model ShouldProcess, tj. může před vytvořením, úpravou nebo odebráním prostředku požádat uživatele o potvrzení.

Příklady

Příklad 1: Povolení všech metrik a protokolů pro prostředek

PS C:\>Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $True

Tento příkaz povolí všechny dostupné metriky a protokoly pro Resource01.

Příklad 2: Zakázání všech metrik a protokolů

PS C:\>Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $False

Tento příkaz zakáže všechny dostupné metriky a protokoly prostředku Resource01.

Příklad 3: Povolení nebo zakázání více kategorií metrik

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

Tento příkaz zakáže kategorie metrik s názvem Category1 a Category2. Všechny ostatní kategorie zůstanou stejné.

Příklad 4: Povolení nebo zakázání více kategorií protokolů

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

Tento příkaz povolí Kategorii1 a Category2. Všechny ostatní metriky a kategorie protokolů zůstanou stejné.

Příklad 4: Povolení agregační intervalu a více kategorií

PS C:\>Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $True -Category Category1,Category2 -Timegrain PT1M

Tento příkaz povolí pouze pt1M kategorie1, Kategorie2 a agregační interval. Všechna ostatní časová zrnka a kategorie se nemění.

Příklad 5: Použití kanálu

PS C:\>Get-AzDiagnosticSetting -ResourceId "Resource01" | Set-AzDiagnosticSetting -Enabled $True -Category Category1,Category2

Tento příkaz používá kanál PowerShellu k nastavení diagnostiky (beze změn).

Parametry

-Category

Určuje seznam kategorií protokolu, které se mají povolit nebo zakázat podle hodnoty Povoleno. Pokud není zadána žádná kategorie, tento příkaz funguje ve všech podporovaných kategoriích.

Vlastnosti parametru

Typ:	List<T>[String]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

OldSetDiagnosticSetting

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	viz

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure

Vlastnosti parametru

Typ:	IAzureContextContainer
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	AzContext, AzureRmContext, AzureCredential

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Enabled

Určuje, jestli se má povolit diagnostika. Zadáním $True povolte diagnostiku nebo $False zakázat diagnostiku.

Vlastnosti parametru

Typ:	Boolean
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

OldSetDiagnosticSetting

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-EventHubAuthorizationRuleId

ID autorizačního pravidla centra událostí

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

OldSetDiagnosticSetting

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-EventHubName

Název centra událostí

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

OldSetDiagnosticSetting

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ExportToResourceSpecific

Příznak označující, že export do la musí být proveden pro tabulku specifickou pro prostředek( a.k.a. vyhrazená nebo pevná tabulka schématu), a ne výchozí tabulka dynamického schématu s názvem AzureDiagnostics.

Tento argument je efektivní pouze v případě, že argument -workspaceId je uveden také.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

OldSetDiagnosticSetting

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-InputObject

Vstupní objekt (možný z kanálu)) Název a resourceId se z tohoto objektu extrahují.

Vlastnosti parametru

Typ:	PSServiceDiagnosticSettings
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

NewSetDiagnosticSetting

Position:	Named
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-MetricCategory

Seznam kategorií metrik Pokud není zadána žádná kategorie, tento příkaz funguje ve všech podporovaných kategoriích.

Vlastnosti parametru

Typ:	List<T>[String]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

OldSetDiagnosticSetting

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Name

Název nastavení diagnostiky. Výchozí hodnota je služba.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

OldSetDiagnosticSetting

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ResourceId

Určuje ID prostředku.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

OldSetDiagnosticSetting

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-RetentionEnabled

Určuje, jestli je povolené uchovávání diagnostických informací.

Vlastnosti parametru

Typ:	Nullable<T>[Boolean]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

OldSetDiagnosticSetting

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-RetentionInDays

Určuje zásady uchovávání informací ve dnech.

Vlastnosti parametru

Typ:	Nullable<T>[Int32]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

OldSetDiagnosticSetting

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ServiceBusRuleId

ID pravidla služby Service Bus.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

OldSetDiagnosticSetting

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-StorageAccountId

Určuje ID účtu úložiště, do kterého se mají data uložit.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

OldSetDiagnosticSetting

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Timegrain

Určuje časová zrna, která se mají pro metriky povolit nebo zakázat, podle hodnoty Povoleno. Pokud nezadáte časové intervaly, bude tento příkaz pracovat se všemi dostupnými časovými zrnky.

Vlastnosti parametru

Typ:	List<T>[String]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

OldSetDiagnosticSetting

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Wi

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-WorkspaceId

ID prostředku pracovního prostoru služby Log Analytics pro odesílání protokolů nebo metrik do

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

OldSetDiagnosticSetting

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

PSServiceDiagnosticSettings

String

Boolean

List<T>

Nullable<T>

Nullable<T>

Výstupy

PSServiceDiagnosticSettings

Související odkazy

• Get-AzDiagnosticSetting
• Remove-AzDiagnosticSetting