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.

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

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]
Aliases:Category
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-EventHubAuthorizationRuleId

De id van de Event Hub-autorisatieregel

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

-EventHubName

De naam van de Event Hub

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

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

-ResourceId

Hiermee geeft u de id van de resource.

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

-RetentionEnabled

Geeft aan of retentie van diagnostische gegevens is ingeschakeld.

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

-RetentionInDays

Hiermee geeft u het bewaarbeleid, in dagen.

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

-ServiceBusRuleId

De Service Bus-regel-id.

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

-StorageAccountId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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]
Aliases:Timegrain
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

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

-WorkspaceId

De id van de werkruimte

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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