Set-AzureRmDiagnosticSetting
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
Parameter: 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]]