Set-AzureRmDiagnosticSetting
Nastaví protokoly a nastavení metrik pro prostředek.
Upozorňující
Modul AzureRM PowerShell byl od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.
I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.
Syntax
Set-AzureRmDiagnosticSetting
-ResourceId <String>
[-Name <String>]
[-StorageAccountId <String>]
[-ServiceBusRuleId <String>]
[-EventHubName <String>]
[-EventHubAuthorizationRuleId <String>]
[-Enabled <Boolean>]
[-Categories <System.Collections.Generic.List`1[System.String]>]
[-MetricCategory <System.Collections.Generic.List`1[System.String]>]
[-Timegrains <System.Collections.Generic.List`1[System.String]>]
[-RetentionEnabled <Boolean>]
[-WorkspaceId <String>]
[-RetentionInDays <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzureRmDiagnosticSetting
-InputObject <PSServiceDiagnosticSettings>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Rutina Set-AzureRmDiagnosticSetting povolí nebo zakáže každou kategorii agregační interval 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-AzureRmDiagnosticSetting -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-AzureRmDiagnosticSetting -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-AzureRmDiagnosticSetting -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 povolí kateorie 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-AzureRmDiagnosticSetting -ResourceId "Resource01" -Enabled $True -Categories 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-AzureRmDiagnosticSetting -ResourceId "Resource01" -Enabled $True -Categories Category1,Category2 -Timegrains 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-AzureRmDiagnosticSetting -ResourceId "Resource01" | Set-AzureRmDiagnosticSetting
Tento příkaz používá kanál PowerShellu k nastavení diagnostiky (beze změn).
Parametry
-Categories
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] |
Aliases: | Category |
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: | 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 |
-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 |
-Timegrains
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] |
Aliases: | Timegrain |
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 pracovního prostoru
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Vstupy
Parametry: InputObject (ByValue)
List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
Nullable<T>[[System.Boolean, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]