Set-AzureRmDiagnosticSetting

Referenz

Modul:: AzureRM.Insights

Legt die Protokoll- und Metrikeinstellungen für die Ressource fest.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

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

Beschreibung

Das Cmdlet "Set-AzureRmDiagnosticSetting " aktiviert oder deaktiviert jedes Mal die Korn- und Protokollkategorie für die jeweilige Ressource. Die Protokolle und Metriken werden im angegebenen Speicherkonto gespeichert. Dieses Cmdlet implementiert das ShouldProcess-Muster, d. h. es kann eine Bestätigung des Benutzers anfordern, bevor die Ressource tatsächlich erstellt, geändert oder entfernt wird.

Beispiele

Beispiel 1: Aktivieren aller Metriken und Protokolle für eine Ressource

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

Mit diesem Befehl werden alle verfügbaren Metriken und Protokolle für Resource01 aktiviert.

Beispiel 2: Alle Metriken und Protokolle deaktivieren

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

Mit diesem Befehl werden alle verfügbaren Metriken und Protokolle für die Ressource Ressource01 deaktiviert.

Beispiel 3: Aktivieren/Deaktivieren mehrerer Metrikkategorien

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

Mit diesem Befehl werden die Metrikkate namens "Kategorie1" und "Kategorie2" aktiviert. Alle anderen Kategorien werden erneut Standard.

Beispiel 4: Aktivieren/Deaktivieren mehrerer Protokollkategorien

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

Dieser Befehl aktiviert Kategorie1 und Kategorie2. Alle anderen Metriken und Protokollkategorien werden erneut Standard.

Beispiel 4: Aktivieren eines Zeitkorns und mehrerer Kategorien

PS C:\>Set-AzureRmDiagnosticSetting -ResourceId "Resource01" -Enabled $True -Categories Category1,Category2 -Timegrains PT1M

Dieser Befehl aktiviert nur Kategorie1, Kategorie2 und Zeitkorn PT1M. Alle anderen Zeitkornen und Kategorien sind unverändert.

Beispiel 5: Verwenden der Pipeline

PS C:\>Get-AzureRmDiagnosticSetting -ResourceId "Resource01" | Set-AzureRmDiagnosticSetting

Dieser Befehl verwendet die PowerShell-Pipeline, um eine Diagnoseeinstellung festzulegen (nicht geändert).

Parameter

-Categories

Gibt die Liste der zu aktivierenden oder deaktivierenden Protokollkategorien gemäß dem Wert von "Enabled" an. Wenn keine Kategorie angegeben ist, wird dieser Befehl für alle unterstützten Kategorien ausgeführt.

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

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

-Enabled

Gibt an, ob Diagnose aktiviert werden soll. Geben Sie $True an, um Diagnose zu aktivieren, oder $False, um Diagnose zu deaktivieren.

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

-EventHubAuthorizationRuleId

Die Ereignishub-Autorisierungsregel-ID

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

-EventHubName

Der Name des Ereignishubs

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

-InputObject

Das Eingabeobjekt (möglich aus der Pipeline).) Der Name und die resourceId werden aus diesem Objekt extrahiert.

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

-MetricCategory

Die Liste der Metrikkategorien. Wenn keine Kategorie angegeben ist, wird dieser Befehl für alle unterstützten Kategorien ausgeführt.

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

-Name

Der Name der Diagnoseeinstellung. Der Standardwert ist "Service".

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

-ResourceId

Gibt die ID der Ressource an.

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

-RetentionEnabled

Gibt an, ob die Aufbewahrung von Diagnoseinformationen aktiviert ist.

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

-RetentionInDays

Gibt die Aufbewahrungsrichtlinie in Tagen an.

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

-ServiceBusRuleId

Die Id der Servicebusregel.

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

-StorageAccountId

Gibt die ID des Speicherkontos an, in dem die Daten gespeichert werden sollen.

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

-Timegrains

Gibt die Zeitkornen an, die für Metriken gemäß dem Wert von "Enabled" aktiviert oder deaktiviert werden sollen. Wenn Sie keinen Zeitkorn angeben, wird dieser Befehl auf allen verfügbaren Zeitkornen ausgeführt.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

-WorkspaceId

Die ID des Arbeitsbereichs

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

Eingaben

PSServiceDiagnosticSettings

Parameter: InputObject (ByValue)

String

Boolean

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

Ausgaben