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>]
   [-RetentionInDays <Int32>]
   [-ExportToResourceSpecific]
   [-EnableLog <Boolean>]
   [-EnableMetrics <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzDiagnosticSetting
   -InputObject <PSServiceDiagnosticSettings>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Deskripsi

Cmdlet Set-AzDiagnosticSetting memungkinkan atau menonaktifkan setiap kali grain dan kategori 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

Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $True

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

Contoh 2: Menonaktifkan semua metrik dan log

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

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 Category1 dan Category2. Semua kategori lainnya tetap sama.

Contoh 4: Mengaktifkan/menonaktifkan beberapa kategori log

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 mengaktifkan Category1 dan Category2. Semua kategori metrik dan log lainnya tetap sama.

Contoh 5: Mengaktifkan butir waktu dan beberapa kategori

Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $True -Category Category1,Category2 -Timegrain PT1M

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

Contoh 6: Menggunakan alur

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.

Contoh 7: Mengaktifkan semua kategori untuk langganan

$list = @()
Get-AzSubscriptionDiagnosticSettingCategory | ForEach-Object {
	$list += (New-AzDiagnosticDetailSetting -Log -Category $_.Name -Enabled)
}
$DiagnosticSettingName = 'please use your setting name here'
$SubscriptionId = 'please use your subscription Id here'
$WorkspaceId = 'please use your workspace Id here'
$setting = New-AzDiagnosticSetting -Name $DiagnosticSettingName -SubscriptionId $SubscriptionId -WorkspaceId $WorkspaceId -Setting $list
Set-AzDiagnosticSetting -InputObject $setting

Perintah ini mengaktifkan semua kategori log untuk langganan.

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
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
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
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
Accept pipeline input:	True
Accept wildcard characters:	False

-EnableLog

Nilai yang menunjukkan apakah log diagnostik harus diaktifkan atau dinonaktifkan

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

-EnableMetrics

Nilai yang menunjukkan apakah metrik diagnostik harus diaktifkan atau dinonaktifkan

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

-EventHubAuthorizationRuleId

Id aturan otorisasi pusat aktivitas

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

-EventHubName

Nama pusat aktivitas

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

-Name

Nama pengaturan diagnostik. Nilai defaultnya adalah layanan.

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

-ResourceId

Menentukan ID sumber daya.

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

-RetentionEnabled

Menunjukkan apakah retensi informasi diagnostik diaktifkan. Perhatikan bahwa ini hanya berlaku saat menyimpan data ke akun Penyimpanan.

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

-RetentionInDays

Menentukan kebijakan penyimpanan, dalam hari. Perhatikan bahwa ini hanya berlaku saat menyimpan data ke akun Penyimpanan.

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

-ServiceBusRuleId

Id Aturan Bus Layanan.

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

-StorageAccountId

Menentukan ID akun Penyimpanan untuk menyimpan data.

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

-WorkspaceId

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

Type:	String
Position:	Named
Default value:	None
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