Set-AzDiagnosticSetting
Nastaví protokoly a nastavení metrik pro prostředek.
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
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.
Type: | List<T>[String] |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EventHubAuthorizationRuleId
ID autorizačního pravidla centra událostí
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EventHubName
Název centra událostí
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
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. 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é.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InputObject
Vstupní objekt (možný z kanálu)) Název a resourceId se z tohoto objektu extrahují.
Type: | PSServiceDiagnosticSettings |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MetricCategory
Seznam kategorií metrik Pokud není zadána žádná kategorie, tento příkaz funguje ve všech podporovaných kategoriích.
Type: | List<T>[String] |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceId
Určuje ID prostředku.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RetentionEnabled
Určuje, jestli je povolené uchovávání diagnostických informací.
Type: | Nullable<T>[Boolean] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RetentionInDays
Určuje zásady uchovávání informací ve dnech.
Type: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServiceBusRuleId
ID pravidla služby Service Bus.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
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, bude tento příkaz pracovat se všemi dostupnými časovými zrnky.
Type: | List<T>[String] |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Vstupy
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]]