Set-AzDiagnosticSetting

Modul:: Az.Monitor Module

Mengatur pengaturan log dan metrik untuk sumber daya.

Sintaks

OldSetDiagnosticSetting (Default)

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

Deskripsi

Cmdlet Set-AzDiagnosticSetting memungkinkan atau menonaktifkan setiap kali kategori butir dan log untuk sumber daya tertentu. Log dan metrik disimpan di akun penyimpanan yang ditentukan. Cmdlet ini mengimplementasikan pola ShouldProcess, yaitu mungkin meminta konfirmasi dari pengguna sebelum benar-benar membuat, memodifikasi, atau menghapus sumber daya.

Contoh

Contoh 1: Mengaktifkan semua metrik dan log untuk sumber daya

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

Perintah ini memungkinkan semua metrik dan log yang tersedia untuk Resource01.

Contoh 2: Menonaktifkan semua metrik dan log

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

Perintah ini menonaktifkan semua metrik dan log yang tersedia untuk sumber daya Resource01.

Contoh 3: Mengaktifkan/menonaktifkan beberapa kategori metrik

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

Perintah ini menonaktifkan kategori metrik yang disebut Kategori1 dan Kategori2. Semua kategori lainnya tetap sama.

Contoh 4: Mengaktifkan/menonaktifkan beberapa kategori log

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

Perintah ini memungkinkan Kategori1 dan Kategori2. Semua metrik dan kategori log lainnya tetap sama.

Contoh 4: Mengaktifkan butir waktu dan beberapa kategori

PS C:\>Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $True -Category Category1,Category2 -Timegrain PT1M

Perintah ini hanya mengaktifkan Category1, Category2, dan time grain PT1M. Semua butir dan kategori waktu lainnya tidak berubah.

Contoh 5: Menggunakan alur

PS C:\>Get-AzDiagnosticSetting -ResourceId "Resource01" | Set-AzDiagnosticSetting -Enabled $True -Category Category1,Category2

Perintah ini menggunakan alur PowerShell untuk mengatur (tidak ada perubahan yang dibuat) pengaturan diagnostik.

Parameter

-Category

Menentukan daftar kategori log untuk diaktifkan atau dinonaktifkan, sesuai dengan nilai Diaktifkan. Jika tidak ada kategori yang ditentukan, perintah ini beroperasi pada semua kategori yang didukung.

Properti parameter

Jenis:	List<T>[String]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

OldSetDiagnosticSetting

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	Cf

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure

Properti parameter

Jenis:	IAzureContextContainer
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	AzContext, AzureRmContext, AzureCredential

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Enabled

Menunjukkan apakah akan mengaktifkan diagnostik. Tentukan $True untuk mengaktifkan diagnostik, atau $False untuk menonaktifkan diagnostik.

Properti parameter

Jenis:	Boolean
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

OldSetDiagnosticSetting

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-EventHubAuthorizationRuleId

Id aturan otorisasi pusat aktivitas

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

OldSetDiagnosticSetting

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-EventHubName

Nama pusat aktivitas

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

OldSetDiagnosticSetting

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-ExportToResourceSpecific

Bendera yang menunjukkan bahwa ekspor ke LA harus dilakukan ke tabel khusus sumber daya, alias tabel skema khusus atau tetap, dibandingkan dengan tabel skema dinamis default yang disebut AzureDiagnostics.

Argumen ini hanya efektif ketika argumen -workspaceId juga diberikan.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

OldSetDiagnosticSetting

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-InputObject

Objek input (dimungkinkan dari alur.) Nama dan resourceId akan diekstrak dari objek ini.

Properti parameter

Jenis:	PSServiceDiagnosticSettings
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

NewSetDiagnosticSetting

Position:	Named
Wajib:	True
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-MetricCategory

Daftar kategori metrik. Jika tidak ada kategori yang ditentukan, perintah ini beroperasi pada semua kategori yang didukung.

Properti parameter

Jenis:	List<T>[String]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

OldSetDiagnosticSetting

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Name

Nama pengaturan diagnostik. Nilai defaultnya adalah layanan.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

OldSetDiagnosticSetting

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-ResourceId

Menentukan ID sumber daya.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

OldSetDiagnosticSetting

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-RetentionEnabled

Menunjukkan apakah retensi informasi diagnostik diaktifkan.

Properti parameter

Jenis:	Nullable<T>[Boolean]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

OldSetDiagnosticSetting

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-RetentionInDays

Menentukan kebijakan retensi, dalam hari.

Properti parameter

Jenis:	Nullable<T>[Int32]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

OldSetDiagnosticSetting

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-ServiceBusRuleId

Id Aturan Bus Layanan.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

OldSetDiagnosticSetting

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-StorageAccountId

Menentukan ID akun Penyimpanan untuk menyimpan data.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

OldSetDiagnosticSetting

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Timegrain

Menentukan butir waktu untuk mengaktifkan atau menonaktifkan metrik, sesuai dengan nilai Diaktifkan. Jika Anda tidak menentukan butir waktu, perintah ini beroperasi pada semua butir waktu yang tersedia.

Properti parameter

Jenis:	List<T>[String]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

OldSetDiagnosticSetting

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	wi

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-WorkspaceId

Id sumber daya ruang kerja Analitik Log untuk mengirim log/metrik ke

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

OldSetDiagnosticSetting

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Set-AzDiagnosticSetting

Sintaks

OldSetDiagnosticSetting (Default)

NewSetDiagnosticSetting

Deskripsi

Contoh

Contoh 1: Mengaktifkan semua metrik dan log untuk sumber daya

Contoh 2: Menonaktifkan semua metrik dan log

Contoh 3: Mengaktifkan/menonaktifkan beberapa kategori metrik

Contoh 4: Mengaktifkan/menonaktifkan beberapa kategori log

Contoh 4: Mengaktifkan butir waktu dan beberapa kategori

Contoh 5: Menggunakan alur

Parameter

-Category

Properti parameter

Set parameter

-Confirm

Properti parameter

Set parameter

-DefaultProfile

Properti parameter

Set parameter

-Enabled

Properti parameter

Set parameter

-EventHubAuthorizationRuleId

Properti parameter

Set parameter

-EventHubName

Properti parameter

Set parameter

-ExportToResourceSpecific

Properti parameter

Set parameter

-InputObject

Properti parameter

Set parameter

-MetricCategory

Properti parameter

Set parameter

-Name

Properti parameter

Set parameter

-ResourceId

Properti parameter

Set parameter

-RetentionEnabled

Properti parameter

Set parameter

-RetentionInDays

Properti parameter

Set parameter

-ServiceBusRuleId

Properti parameter

Set parameter

-StorageAccountId

Properti parameter

Set parameter

-Timegrain

Properti parameter

Set parameter

-WhatIf

Properti parameter

Set parameter

-WorkspaceId

Properti parameter

Set parameter

CommonParameters

Input

PSServiceDiagnosticSettings

String

Boolean

List<T>

Nullable<T>

Nullable<T>

Output

PSServiceDiagnosticSettings

Link Terkait