Set-AzDiagnosticSetting

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

Poznámka

Toto je předchozí verze naší dokumentace. Aktuální informace najdete v nejnovější verzi .

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>]
   [-RetentionInDays <Int32>]
   [-ExportToResourceSpecific]
   [-EnableLog <Boolean>]
   [-EnableMetrics <Boolean>]
   [-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 intervalů a protokolů pro konkrétní prostředek. Protokoly a metriky se ukládají do zadaného účtu úložiště. Tato rutina implementuje model ShouldProcess, tj. před vytvořením, úpravou nebo odebráním prostředku může požádat uživatele o potvrzení.

Příklady

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

Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $True

Tento příkaz umožňuje všechny dostupné metriky a protokoly pro Resource01.

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

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

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ůstávají stejné.

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

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 5: Povolení časového intervalu a více kategorií

Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $True -Category Category1,Category2 -Timegrain PT1M

Tento příkaz umožňuje pouze pt1M kategorie1, Kategorie2 a časové intervaly. Všechny ostatní zrna a kategorie se nemění.

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

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

Příklad 7: Povolení všech kategorií pro předplatné

$list = @()
Get-AzSubscriptionDiagnosticSettingCategory | ForEach-Object {
	$list += (New-AzDiagnosticDetailSetting -Log -Category $_.Name -Enabled)
}
$DiagnosticSettingName = 'please use your setting name here'
$SubscriptionId = 'please use your subscription Id here'
$WorkspaceId = 'please use your workspace Id here'
$setting = New-AzDiagnosticSetting -Name $DiagnosticSettingName -SubscriptionId $SubscriptionId -WorkspaceId $WorkspaceId -Setting $list
Set-AzDiagnosticSetting -InputObject $setting

Tento příkaz povolil všechny kategorie protokolů pro předplatné.

Parametry

-Category

Určuje seznam kategorií protokolů, které se mají povolit nebo zakázat, podle hodnoty Povoleno. Pokud není zadána žádná kategorie, tento příkaz pracuje se všemi podporovanými kategoriemi.

Type:List<T>[String]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Enabled

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-EnableLog

Hodnota označující, jestli mají být diagnostické protokoly povolené nebo zakázané.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-EnableMetrics

Hodnota označující, jestli mají být diagnostické metriky povolené nebo zakázané.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-EventHubAuthorizationRuleId

ID pravidla autorizace centra událostí

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-EventHubName

Název centra událostí

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-ExportToResourceSpecific

Příznak označující, že export do la musí být proveden pro tabulku specifickou pro prostředek, a.k.a. vyhrazenou nebo pevnou tabulku schématu, na rozdíl od výchozí tabulky dynamického schématu s názvem AzureDiagnostics.

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-InputObject

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

Type:PSServiceDiagnosticSettings
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-MetricCategory

Seznam kategorií metrik. Pokud není zadána žádná kategorie, tento příkaz pracuje se všemi podporovanými kategoriemi.

Type:List<T>[String]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

Určuje ID prostředku.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-RetentionEnabled

Označuje, jestli je povolené uchovávání diagnostických informací. Mějte na paměti, že to platí jenom při ukládání dat do účtu úložiště.

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-RetentionInDays

Určuje zásady uchovávání informací ve dnech. Mějte na paměti, že to platí jenom při ukládání dat do účtu úložiště.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-ServiceBusRuleId

ID pravidla služby Service Bus.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountId

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

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Timegrain

Určuje časová zrna, která se mají pro metriky povolit nebo zakázat, podle hodnoty Povoleno. Pokud nezadáte časové intervaly, tento příkaz funguje na všech dostupných časových zrnech.

Type:List<T>[String]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WorkspaceId

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

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters: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