Set-AzDiagnosticSetting

Referensi

Modul:: Az.Monitor

Mengatur pengaturan log dan metrik untuk sumber daya.

Sintaks

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

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.

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

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

-DefaultProfile

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

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

-Enabled

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

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

-EventHubAuthorizationRuleId

Id aturan otorisasi pusat aktivitas

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

-EventHubName

Nama pusat aktivitas

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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.

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

-InputObject

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

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

-MetricCategory

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

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

-Name

Nama pengaturan diagnostik. Nilai defaultnya adalah layanan.

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

-ResourceId

Menentukan ID sumber daya.

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

-RetentionEnabled

Menunjukkan apakah retensi informasi diagnostik diaktifkan.

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

-RetentionInDays

Menentukan kebijakan retensi, dalam hari.

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

-ServiceBusRuleId

Id Aturan Bus Layanan.

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

-StorageAccountId

Menentukan ID akun Penyimpanan untuk menyimpan data.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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.

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

-WhatIf

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

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

-WorkspaceId

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

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

Input

PSServiceDiagnosticSettings

String

Boolean

List<T>[[System.String, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Output