Share via

Set-AzDiagnosticSetting

  • Odwołanie
Moduł:
Az.Monitor

Ustawia ustawienia dzienników i metryk dla zasobu.

Składnia

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

Opis

Polecenie cmdlet Set-AzDiagnosticSetting włącza lub wyłącza za każdym razem kategorię ziarna i dziennika dla określonego zasobu. Dzienniki i metryki są przechowywane na określonym koncie magazynu. To polecenie cmdlet implementuje wzorzec ShouldProcess, tj. może zażądać potwierdzenia od użytkownika przed utworzeniem, zmodyfikowaniem lub usunięciem zasobu.

Przykłady

Przykład 1. Włączanie wszystkich metryk i dzienników dla zasobu

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

To polecenie włącza wszystkie dostępne metryki i dzienniki dla zasobu Resource01.

Przykład 2. Wyłączanie wszystkich metryk i dzienników

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

To polecenie wyłącza wszystkie dostępne metryki i dzienniki zasobu Resource01.

Przykład 3. Włączanie/wyłączanie wielu kategorii metryk

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

To polecenie wyłącza kategorie metryk o nazwie Category1 i Category2. Wszystkie pozostałe kategorie pozostają takie same.

Przykład 4. Włączanie/wyłączanie wielu kategorii dzienników

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

To polecenie włącza elementy Category1 i Category2. Wszystkie pozostałe metryki i kategorie dzienników pozostają takie same.

Przykład 4. Włączanie ziarna czasu i wielu kategorii

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

To polecenie umożliwia tylko parametr Category1, Category2 i time grain PT1M. Wszystkie inne ziarna czasu i kategorie są niezmienione.

Przykład 5. Używanie potoku

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

To polecenie używa potoku programu PowerShell do ustawienia diagnostyki (bez wprowadzania zmian).

Parametry

-Category

Określa listę kategorii dzienników, które mają być włączone lub wyłączone, zgodnie z wartością Włączone. Jeśli nie określono żadnej kategorii, to polecenie działa we wszystkich obsługiwanych kategoriach.

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

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

-Enabled

Wskazuje, czy włączyć diagnostykę. Określ $True włączyć diagnostykę lub $False wyłączyć diagnostykę.

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

-EventHubAuthorizationRuleId

Identyfikator reguły autoryzacji centrum zdarzeń

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

-EventHubName

Nazwa centrum zdarzeń

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

-ExportToResourceSpecific

Flaga wskazująca, że eksport do usługi LA musi zostać wykonany w tabeli specyficznej dla zasobu , czyli dedykowanej lub stałej tabeli schematu, w przeciwieństwie do domyślnej tabeli schematu dynamicznego o nazwie AzureDiagnostics.

Ten argument jest skuteczny tylko wtedy, gdy argument -workspaceId jest również podany.

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

-InputObject

Obiekt wejściowy (możliwy z potoku). Nazwa i identyfikator resourceId zostaną wyodrębnione z tego obiektu.

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

-MetricCategory

Lista kategorii metryk. Jeśli nie określono żadnej kategorii, to polecenie działa we wszystkich obsługiwanych kategoriach.

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

-Name

Nazwa ustawienia diagnostycznego. Wartość domyślna to usługa.

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

-ResourceId

Określa identyfikator zasobu.

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

-RetentionEnabled

Wskazuje, czy jest włączone przechowywanie informacji diagnostycznych.

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

-RetentionInDays

Określa zasady przechowywania w dniach.

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

-ServiceBusRuleId

Identyfikator reguły usługi Service Bus.

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

-StorageAccountId

Określa identyfikator konta magazynu, w którym mają być zapisywane dane.

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

-Timegrain

Określa ziarna czasu, aby włączyć lub wyłączyć dla metryk, zgodnie z wartością Włączone. Jeśli nie określisz ziarna czasu, to polecenie działa na wszystkich dostępnych ziarnach czasu.

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

-WorkspaceId

Identyfikator zasobu obszaru roboczego usługi Log Analytics do wysyłania dzienników/metryk do

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

Dane wejściowe

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

Dane wyjściowe

PSServiceDiagnosticSettings