Share via

Set-AzureRmDiagnosticSetting

  • Referencia
Modul:
AzureRM.Insights

Beállítja az erőforrás naplóinak és metrikáinak beállításait.

Figyelmeztetés

Az AzureRM PowerShell-modul 2024. február 29-én hivatalosan elavult. Javasoljuk a felhasználóknak, hogy migráljanak az AzureRM-ből az Az PowerShell-modulba a folyamatos támogatás és frissítések biztosítása érdekében.

Bár az AzureRM-modul továbbra is működik, a továbbiakban nem tart fenn vagy nem támogatott, így a folyamatos használatot a felhasználó saját belátása szerint és kockázatára teheti. Az Az modulra való áttéréshez tekintse meg a migrálási erőforrásainkat.

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

A Set-AzureRmDiagnosticSetting parancsmag engedélyezi vagy letiltja az adott erőforráshoz tartozó összes időfelbontási és naplókategória használatát. A naplók és metrikák a megadott tárfiókban vannak tárolva. Ez a parancsmag implementálja a ShouldProcess mintát, azaz megerősítést kérhet a felhasználótól az erőforrás létrehozása, módosítása vagy eltávolítása előtt.

Példák

1. példa: Erőforrás összes metrikájának és naplójának engedélyezése

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

Ez a parancs engedélyezi a Resource01 összes elérhető metrikát és naplót.

2. példa: Az összes metrika és napló letiltása

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

Ez a parancs letiltja a Resource01 erőforrás összes elérhető metrikáit és naplóit.

3. példa: Több metrikakategória engedélyezése/letiltása

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

Ez a parancs engedélyezi a Category1 és Category2 nevű metrikák katekumentáit. Az összes többi kategória változatlan marad.

4. példa: Több naplókategória engedélyezése/letiltása

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

Ez a parancs engedélyezi a Category1 és a Category2 lehetőséget. Az összes többi metrika és naplókategória változatlan marad.

4. példa: Időfelbontás és több kategória engedélyezése

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

Ez a parancs csak a Category1, Category2 és time grain PT1M értéket engedélyezi. Minden más idő szemcséi és kategóriái változatlanok.

5. példa: Folyamat használata

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

Ez a parancs a PowerShell-folyamat használatával állít be (nem módosítva) egy diagnosztikai beállítást.

Paraméterek

-Categories

Az engedélyezendő vagy letiltandó naplókategóriák listáját adja meg az Engedélyezett értéknek megfelelően. Ha nincs megadva kategória, ez a parancs az összes támogatott kategórián működik.

Type:List<T>[String]
Aliases:Category
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

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

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Enabled

Jelzi, hogy engedélyezi-e a diagnosztikát. Adja meg a diagnosztikát engedélyező $True, vagy a diagnosztika letiltásához $False.

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

-EventHubAuthorizationRuleId

Az event hub engedélyezési szabály azonosítója

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

-EventHubName

Az eseményközpont neve

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

-InputObject

A bemeneti objektum (a folyamatból lehetséges).) A rendszer kinyeri a nevet és a resourceId azonosítót ebből az objektumból.

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

-MetricCategory

A metrikakategóriák listája. Ha nincs megadva kategória, ez a parancs az összes támogatott kategórián működik.

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

-Name

A diagnosztikai beállítás neve. Az alapértelmezett érték a szolgáltatás.

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

-ResourceId

Megadja az erőforrás azonosítóját.

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

-RetentionEnabled

Azt jelzi, hogy engedélyezve van-e a diagnosztikai adatok megőrzése.

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

-RetentionInDays

A megőrzési szabályzatot napokban adja meg.

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

-ServiceBusRuleId

A Service Bus-szabály azonosítója.

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

-StorageAccountId

Megadja annak a Tárfióknak az azonosítóját, amelyben menteni szeretné az adatokat.

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

-Timegrains

Megadja a metrikák engedélyezéséhez vagy letiltásához szükséges időértékeket az Engedélyezett értéknek megfelelően. Ha nem ad meg időfelbontást, ez a parancs az összes rendelkezésre álló időfelbontáson működik.

Type:List<T>[String]
Aliases:Timegrain
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

-WorkspaceId

A munkaterület azonosítója

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

Bevitelek

PSServiceDiagnosticSettings

Paraméterek: 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]]

Kimenetek

PSServiceDiagnosticSettings