Delen via

Set-AzureRmDiagnosticSetting

  • Referentie
Module:
AzureRM.Insights

Hiermee stelt u de instellingen voor logboeken en metrische gegevens voor de resource in.

Waarschuwing

De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.

Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.

Syntaxis

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

Description

De cmdlet Set-AzureRmDiagnosticSetting schakelt elke tijdsinterval en logboekcategorie voor de specifieke resource in of uit. De logboeken en metrische gegevens worden opgeslagen in het opgegeven opslagaccount. Met deze cmdlet wordt het ShouldProcess-patroon geïmplementeerd, dat wil bijvoorbeeld dat de gebruiker om bevestiging wordt gevraagd voordat de resource daadwerkelijk wordt gemaakt, gewijzigd of verwijderd.

Voorbeelden

Voorbeeld 1: Alle metrische gegevens en logboeken voor een resource inschakelen

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

Met deze opdracht worden alle beschikbare metrische gegevens en logboeken voor Resource01 ingeschakeld.

Voorbeeld 2: Alle metrische gegevens en logboeken uitschakelen

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

Met deze opdracht worden alle beschikbare metrische gegevens en logboeken voor de resource Resource01 uitgeschakeld.

Voorbeeld 3: Meerdere categorieën met metrische gegevens in- of uitschakelen

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

Met deze opdracht worden de metrische gegevenscateories met de naam Category1 en Category2 ingeschakeld. Alle andere categorieën blijven hetzelfde.

Voorbeeld 4: Meerdere logboekcategorieën in- of uitschakelen

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

Met deze opdracht schakelt u Category1 en Category2 in. Alle andere categorieën voor metrische gegevens en logboeken blijven hetzelfde.

Voorbeeld 4: Een tijdsinterval en meerdere categorieën inschakelen

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

Met deze opdracht worden alleen Categorie1, Categorie2 en tijdsinterval PT1M ingeschakeld. Alle andere tijdskorrels en categorieën zijn ongewijzigd.

Voorbeeld 5: Pijplijn gebruiken

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

Met deze opdracht wordt de PowerShell-pijplijn gebruikt om een diagnostische instelling in te stellen (niet gewijzigd).

Parameters

-Categories

Hiermee geeft u de lijst met logboekcategorieën op die moeten worden ingeschakeld of uitgeschakeld, volgens de waarde ingeschakeld. Als er geen categorie is opgegeven, werkt deze opdracht voor alle ondersteunde categorieën.

Type:List<T>[String]
Aliassen:Category
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Type:IAzureContextContainer
Aliassen:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Enabled

Hiermee wordt aangegeven of diagnostische gegevens moeten worden ingeschakeld. Geef $True op om diagnostische gegevens in te schakelen of $False om diagnostische gegevens uit te schakelen.

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-EventHubAuthorizationRuleId

De id van de Event Hub-autorisatieregel

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-EventHubName

De naam van de Event Hub

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-InputObject

Het invoerobject (mogelijk vanuit de pijplijn.) De naam en resourceId worden uit dit object geëxtraheerd.

Type:PSServiceDiagnosticSettings
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-MetricCategory

De lijst met metrische categorieën. Als er geen categorie is opgegeven, werkt deze opdracht voor alle ondersteunde categorieën.

Type:List<T>[String]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

De naam van de diagnostische instelling. De standaardwaarde is service.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceId

Hiermee geeft u de id van de resource.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-RetentionEnabled

Geeft aan of retentie van diagnostische gegevens is ingeschakeld.

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-RetentionInDays

Hiermee geeft u het bewaarbeleid, in dagen.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ServiceBusRuleId

De Service Bus-regel-id.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-StorageAccountId

Hiermee geeft u de id op van het opslagaccount waarin de gegevens moeten worden opgeslagen.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Timegrains

Hiermee geeft u de tijdskorrels op die moeten worden ingeschakeld of uitgeschakeld voor metrische gegevens, volgens de waarde ingeschakeld. Als u geen tijdsinterval opgeeft, werkt deze opdracht op alle beschikbare tijdskorrels.

Type:List<T>[String]
Aliassen:Timegrain
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WorkspaceId

De id van de werkruimte

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

PSServiceDiagnosticSettings

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

Uitvoerwaarden

PSServiceDiagnosticSettings