Delen via

Set-AzDiagnosticSetting

Module:
Az.Monitor Module

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

Syntaxis

OldSetDiagnosticSetting (Standaard) 

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

NewSetDiagnosticSetting 

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.

Parametereigenschappen

Type:

List<T>[String]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

OldSetDiagnosticSetting
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DefaultProfile

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

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:Boolean
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

OldSetDiagnosticSetting
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-EventHubAuthorizationRuleId

De id van de Event Hub-autorisatieregel

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

OldSetDiagnosticSetting
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-EventHubName

De naam van de Event Hub

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

OldSetDiagnosticSetting
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

OldSetDiagnosticSetting
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-InputObject

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

Parametereigenschappen

Type:PSServiceDiagnosticSettings
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

NewSetDiagnosticSetting
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-MetricCategory

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

Parametereigenschappen

Type:

List<T>[String]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

OldSetDiagnosticSetting
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Name

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

OldSetDiagnosticSetting
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ResourceId

Hiermee geeft u de id van de resource.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

OldSetDiagnosticSetting
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-RetentionEnabled

Geeft aan of retentie van diagnostische gegevens is ingeschakeld.

Parametereigenschappen

Type:

Nullable<T>[Boolean]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

OldSetDiagnosticSetting
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-RetentionInDays

Hiermee geeft u het bewaarbeleid, in dagen.

Parametereigenschappen

Type:

Nullable<T>[Int32]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

OldSetDiagnosticSetting
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ServiceBusRuleId

De Service Bus-regel-id.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

OldSetDiagnosticSetting
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-StorageAccountId

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

OldSetDiagnosticSetting
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:

List<T>[String]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

OldSetDiagnosticSetting
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-WorkspaceId

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

OldSetDiagnosticSetting
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

PSServiceDiagnosticSettings

String

Boolean

List<T>

Nullable<T>

Nullable<T>

Uitvoerwaarden

PSServiceDiagnosticSettings