Delen via

Set-AzDiagnosticSetting

  • Referentie
Module:
Az.Monitor

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

Syntax

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>]
Set-AzDiagnosticSetting
   -InputObject <PSServiceDiagnosticSettings>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

De cmdlet Set-AzDiagnosticSetting schakelt elke tijdsinterval en logboekcategorie voor de betreffende 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-AzDiagnosticSetting -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-AzDiagnosticSetting -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-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

Met deze opdracht worden de categorieën met metrische gegevens met de naam Categorie1 en Categorie2 uitgeschakeld. Alle andere categorieën blijven hetzelfde.

Voorbeeld 4: Meerdere logboekcategorieën in- of uitschakelen

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

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-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $True -Category Category1,Category2 -Timegrain 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-AzDiagnosticSetting -ResourceId "Resource01" | Set-AzDiagnosticSetting -Enabled $True -Category Category1,Category2

Met deze opdracht wordt de PowerShell-pijplijn gebruikt om een diagnostische instelling in te stellen (geen wijzigingen aangebracht).

Parameters

-Category

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]
Position:Named
standaardwaarde:None
Vereist: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
standaardwaarde:None
Vereist: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:AzContext, AzureRmContext, AzureCredential
Position:Named
standaardwaarde:None
Vereist: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
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-EventHubAuthorizationRuleId

De id van de Event Hub-autorisatieregel

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-EventHubName

De naam van de Event Hub

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-ExportToResourceSpecific

Vlag die aangeeft dat de export naar LA moet worden uitgevoerd voor een resourcespecifieke tabel, een toegewezen of vaste schematabel, in plaats van de standaard dynamische schematabel met de naam AzureDiagnostics.

Dit argument is alleen van kracht als het argument -workspaceId ook wordt gegeven.

Type:SwitchParameter
Position:Named
standaardwaarde:None
Vereist: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
standaardwaarde:None
Vereist: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
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

Hiermee geeft u de id van de resource.

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

-RetentionInDays

Hiermee geeft u het bewaarbeleid, in dagen.

Type:Nullable<T>[Int32]
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-ServiceBusRuleId

De Service Bus-regel-id.

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

-Timegrain

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]
Position:Named
standaardwaarde:None
Vereist: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
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-WorkspaceId

De resource-id van de Log Analytics-werkruimte voor het verzenden van logboeken/metrische gegevens naar

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

Invoerwaarden

PSServiceDiagnosticSettings

String

Boolean

List<T>[[System.String, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Uitvoerwaarden

PSServiceDiagnosticSettings