Sdílet prostřednictvím


Set-AzDiagnosticSetting

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

Syntaxe

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

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.

Typ:List<T>[String]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Enabled

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

Typ:Boolean
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-EventHubAuthorizationRuleId

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

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-EventHubName

Název centra událostí

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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é.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-InputObject

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

Typ:PSServiceDiagnosticSettings
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-MetricCategory

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

Typ:List<T>[String]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

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

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ResourceId

Určuje ID prostředku.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-RetentionEnabled

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

Typ:Nullable<T>[Boolean]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-RetentionInDays

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

Typ:Nullable<T>[Int32]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ServiceBusRuleId

ID pravidla služby Service Bus.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-StorageAccountId

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

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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.

Typ:List<T>[String]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WorkspaceId

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

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

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

Výstupy

PSServiceDiagnosticSettings