Bagikan melalui

Set-AzureRmDiagnosticSetting

  • Referensi
Modul:
AzureRM.Insights

Mengatur pengaturan log dan metrik untuk sumber daya.

Peringatan

Modul AzureRM PowerShell telah resmi tidak digunakan lagi per 29 Februari 2024. Pengguna disarankan untuk bermigrasi dari AzureRM ke modul Az PowerShell untuk memastikan dukungan dan pembaruan yang berkelanjutan.

Meskipun modul AzureRM mungkin masih berfungsi, modul tersebut tidak lagi dipertahankan atau didukung, menempatkan penggunaan berkelanjutan berdasarkan kebijaksanaan dan risiko pengguna. Silakan merujuk ke sumber daya migrasi kami untuk panduan tentang transisi ke modul Az.

Sintaks

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

Deskripsi

Cmdlet Set-AzureRmDiagnosticSetting 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-AzureRmDiagnosticSetting -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-AzureRmDiagnosticSetting -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-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

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

Contoh 4: Mengaktifkan/menonaktifkan beberapa kategori log

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

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-AzureRmDiagnosticSetting -ResourceId "Resource01" -Enabled $True -Categories Category1,Category2 -Timegrains 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-AzureRmDiagnosticSetting -ResourceId "Resource01" | Set-AzureRmDiagnosticSetting

Perintah ini menggunakan alur PowerShell untuk mengatur (tidak berubah) pengaturan diagnostik.

Parameter

-Categories

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.

Jenis:List<T>[String]
Alias:Category
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Jenis:SwitchParameter
Alias:cf
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DefaultProfile

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

Jenis:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Enabled

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

Jenis:Boolean
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-EventHubAuthorizationRuleId

Id aturan otorisasi pusat aktivitas

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-EventHubName

Nama pusat aktivitas

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-InputObject

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

Jenis:PSServiceDiagnosticSettings
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-MetricCategory

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

Jenis:List<T>[String]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Name

Nama pengaturan diagnostik. Nilai defaultnya adalah layanan.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-ResourceId

Menentukan ID sumber daya.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-RetentionEnabled

Menunjukkan apakah retensi informasi diagnostik diaktifkan.

Jenis:Nullable<T>[Boolean]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-RetentionInDays

Menentukan kebijakan retensi, dalam hari.

Jenis:Nullable<T>[Int32]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-ServiceBusRuleId

Id Aturan Bus Layanan.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-StorageAccountId

Menentukan ID akun Penyimpanan untuk menyimpan data.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Timegrains

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.

Jenis:List<T>[String]
Alias:Timegrain
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Jenis:SwitchParameter
Alias:wi
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-WorkspaceId

Id ruang kerja

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

Input

PSServiceDiagnosticSettings

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

Output

PSServiceDiagnosticSettings