Set-AzDiagnosticSetting

Moduł:

Az.Monitor Module

Ustawia ustawienia dzienników i metryk dla zasobu.

Składnia

OldSetDiagnosticSetting (Domyślna)

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

NewSetDiagnosticSetting

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.

Właściwości parametru

Typ:	List<T>[String]
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

OldSetDiagnosticSetting

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	por

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-DefaultProfile

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

Właściwości parametru

Typ:	IAzureContextContainer
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	AzContext, AzureRmContext, AzureCredential

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Enabled

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

Właściwości parametru

Typ:	Boolean
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

OldSetDiagnosticSetting

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-EventHubAuthorizationRuleId

Identyfikator reguły autoryzacji centrum zdarzeń

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

OldSetDiagnosticSetting

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-EventHubName

Nazwa centrum zdarzeń

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

OldSetDiagnosticSetting

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	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.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

OldSetDiagnosticSetting

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-InputObject

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

Właściwości parametru

Typ:	PSServiceDiagnosticSettings
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

NewSetDiagnosticSetting

Position:	Named
Obowiązkowy:	True
Wartość z potoku:	True
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-MetricCategory

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

Właściwości parametru

Typ:	List<T>[String]
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

OldSetDiagnosticSetting

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-Name

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

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

OldSetDiagnosticSetting

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-ResourceId

Określa identyfikator zasobu.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

OldSetDiagnosticSetting

Position:	Named
Obowiązkowy:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-RetentionEnabled

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

Właściwości parametru

Typ:	Nullable<T>[Boolean]
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

OldSetDiagnosticSetting

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-RetentionInDays

Określa zasady przechowywania w dniach.

Właściwości parametru

Typ:	Nullable<T>[Int32]
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

OldSetDiagnosticSetting

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-ServiceBusRuleId

Identyfikator reguły usługi Service Bus.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

OldSetDiagnosticSetting

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-StorageAccountId

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

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

OldSetDiagnosticSetting

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	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.

Właściwości parametru

Typ:	List<T>[String]
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

OldSetDiagnosticSetting

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	Wi

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-WorkspaceId

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

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

OldSetDiagnosticSetting

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

PSServiceDiagnosticSettings

String

Boolean

List<T>

Nullable<T>

Nullable<T>

Dane wyjściowe

PSServiceDiagnosticSettings

Linki powiązane

• Get-AzDiagnosticSetting
• Remove-AzDiagnosticSetting