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.

Typ:List<T>[String]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Enabled

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

Typ:Boolean
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-EventHubAuthorizationRuleId

Identyfikator reguły autoryzacji centrum zdarzeń

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-EventHubName

Nazwa centrum zdarzeń

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-InputObject

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

Typ:PSServiceDiagnosticSettings
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-MetricCategory

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

Typ:List<T>[String]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ResourceId

Określa identyfikator zasobu.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-RetentionEnabled

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

Typ:Nullable<T>[Boolean]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-RetentionInDays

Określa zasady przechowywania w dniach.

Typ:Nullable<T>[Int32]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ServiceBusRuleId

Identyfikator reguły usługi Service Bus.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-StorageAccountId

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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.

Typ:List<T>[String]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

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

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WorkspaceId

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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