Set-AzDiagnosticSetting
Beállítja az erőforrás naplóinak és metrikáinak beállításait.
Syntax
OldSetDiagnosticSetting (Alapértelmezett)
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
A Set-AzDiagnosticSetting parancsmag engedélyezi vagy letiltja az adott erőforrás minden alkalommali gabona- és naplókategóriáit.
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-AzDiagnosticSetting -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-AzDiagnosticSetting -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-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
Ez a parancs letiltja a Category1 és Category2 nevű metrikák kategóriá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-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
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-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $True -Category Category1,Category2 -Timegrain 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-AzDiagnosticSetting -ResourceId "Resource01" | Set-AzDiagnosticSetting -Enabled $True -Category Category1,Category2
Ez a parancs a PowerShell-folyamat használatával állít be (nincs módosítás) diagnosztikai beállítást.
Paraméterek
-Category
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.
Paramétertulajdonságok
Típus: List<T> [ String ]
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
OldSetDiagnosticSetting
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: True
Fennmaradó argumentumokból származó érték: False
-Confirm
Megerősítést kér a parancsmag futtatása előtt.
Paramétertulajdonságok
Típus: SwitchParameter
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Aliasok: Cf
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-DefaultProfile
Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés
Paramétertulajdonságok
Típus: IAzureContextContainer
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Aliasok: AzContext, AzureRmContext, AzureCredential
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: 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.
Paramétertulajdonságok
Típus: Boolean
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
OldSetDiagnosticSetting
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: True
Fennmaradó argumentumokból származó érték: False
-EventHubAuthorizationRuleId
Az event hub engedélyezési szabály azonosítója
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
OldSetDiagnosticSetting
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: True
Fennmaradó argumentumokból származó érték: False
-EventHubName
Az eseményközpont neve
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
OldSetDiagnosticSetting
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: True
Fennmaradó argumentumokból származó érték: False
-ExportToResourceSpecific
Jelölő, amely azt jelzi, hogy az la-ba való exportálást erőforrás-specifikus táblába, más néven dedikált vagy rögzített sématáblába kell végrehajtani, szemben az AzureDiagnostics nevű alapértelmezett dinamikus sématáblával.
Ez az argumentum csak akkor érvényes, ha a -workspaceId argumentum is meg van adva.
Paramétertulajdonságok
Típus: SwitchParameter
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
OldSetDiagnosticSetting
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: True
Fennmaradó argumentumokból származó érték: False
A bemeneti objektum (a folyamatból lehetséges).) A rendszer kinyeri a nevet és a resourceId azonosítót ebből az objektumból.
NewSetDiagnosticSetting
Position: Named
Kötelező: True
Folyamatból származó érték: True
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: 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.
Paramétertulajdonságok
Típus: List<T> [ String ]
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
OldSetDiagnosticSetting
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: True
Fennmaradó argumentumokból származó érték: False
-Name
A diagnosztikai beállítás neve. Az alapértelmezett érték a szolgáltatás .
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
OldSetDiagnosticSetting
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: True
Fennmaradó argumentumokból származó érték: False
-ResourceId
Megadja az erőforrás azonosítóját.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
OldSetDiagnosticSetting
Position: Named
Kötelező: True
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: True
Fennmaradó argumentumokból származó érték: False
-RetentionEnabled
Azt jelzi, hogy engedélyezve van-e a diagnosztikai adatok megőrzése.
Paramétertulajdonságok
Típus: Nullable<T> [ Boolean ]
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
OldSetDiagnosticSetting
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: True
Fennmaradó argumentumokból származó érték: False
-RetentionInDays
A megőrzési szabályzatot napokban adja meg.
Paramétertulajdonságok
Típus: Nullable<T> [ Int32 ]
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
OldSetDiagnosticSetting
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: True
Fennmaradó argumentumokból származó érték: False
-ServiceBusRuleId
A Service Bus-szabály azonosítója.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
OldSetDiagnosticSetting
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: True
Fennmaradó argumentumokból származó érték: False
-StorageAccountId
Megadja annak a Tárfióknak az azonosítóját, amelyben menteni szeretné az adatokat.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
OldSetDiagnosticSetting
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: True
Fennmaradó argumentumokból származó érték: False
-Timegrain
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.
Paramétertulajdonságok
Típus: List<T> [ String ]
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
OldSetDiagnosticSetting
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: True
Fennmaradó argumentumokból származó érték: False
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.
Paramétertulajdonságok
Típus: SwitchParameter
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Aliasok: Wi
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-WorkspaceId
A Log Analytics-munkaterület erőforrás-azonosítója a naplók/metrikák elküldéséhez
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
OldSetDiagnosticSetting
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: True
Fennmaradó argumentumokból származó érték: False
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters .
Kimenetek