Set-AzDiagnosticSetting

Kaynak için günlükleri ve ölçüm ayarlarını ayarlar.

Not

Bu, belgelerimizin önceki sürümüdür. Güncel bilgiler için lütfen en son sürüme başvurun.

Syntax

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

Description

Set-AzDiagnosticSetting cmdlet'i belirli bir kaynak için her zaman dilim ve günlük kategorisini etkinleştirir veya devre dışı bırakır. Günlükler ve ölçümler belirtilen depolama hesabında depolanır. Bu cmdlet ShouldProcess desenini uygular; örneğin, kaynağı oluşturmadan, değiştirmeden veya kaldırmadan önce kullanıcıdan onay isteyebilir.

Örnekler

Örnek 1: Bir kaynak için tüm ölçümleri ve günlükleri etkinleştirme

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

Bu komut Resource01 için tüm kullanılabilir ölçümleri ve günlükleri etkinleştirir.

Örnek 2: Tüm ölçümleri ve günlükleri devre dışı bırakma

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

Bu komut Resource01 kaynağı için tüm kullanılabilir ölçümleri ve günlükleri devre dışı bırakır.

Örnek 3: Birden çok ölçüm kategorisini etkinleştirme/devre dışı bırakma

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

Bu komut Category1 ve Category2 adlı ölçüm kategorilerini devre dışı bırakır. Diğer tüm kategoriler aynı kalır.

Örnek 4: Birden çok günlük kategorisini etkinleştirme/devre dışı bırakma

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

Bu komut Category1 ve Category2'ye olanak tanır. Diğer tüm ölçümler ve günlük kategorileri aynı kalır.

Örnek 5: Zaman dilimini ve birden çok kategoriyi etkinleştirme

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

Bu komut yalnızca Kategori1, Kategori2 ve zaman dilimi PT1M'yi etkinleştirir. Diğer tüm zaman dilimleri ve kategoriler değişmez.

Örnek 6: İşlem hattını kullanma

Get-AzDiagnosticSetting -ResourceId "Resource01" | Set-AzDiagnosticSetting -Enabled $True -Category Category1,Category2

Bu komut, bir tanılama ayarı ayarlamak için (değişiklik yapılmamış) PowerShell işlem hattını kullanır.

Örnek 7: Abonelik için tüm kategorileri etkinleştirme

$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

Bu komut abonelik için tüm günlük kategorilerini etkinleştirdi.

Parametreler

-Category

Etkinleştirilen veya devre dışı bırakacak günlük kategorilerinin listesini Etkin değerine göre belirtir. Kategori belirtilmezse, bu komut desteklenen tüm kategorilerde çalışır.

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

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

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

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik

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

-Enabled

Tanılamanın etkinleştirilip etkinleştirilmeymeyeceğini gösterir. Tanılamayı etkinleştirmek için $True belirtin veya tanılamayı devre dışı bırakmak için $False.

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

-EnableLog

Tanılama günlüklerinin etkinleştirilmesi veya devre dışı bırakılması gerektiğini gösteren değer

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

-EnableMetrics

Tanılama ölçümlerinin etkinleştirilmesi veya devre dışı bırakılması gerektiğini gösteren değer

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

-EventHubAuthorizationRuleId

Olay hub'ı yetkilendirme kuralı kimliği

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

-EventHubName

Olay hub'ı adı

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

-ExportToResourceSpecific

LA'ye dışarı aktarma işleminin AzureDiagnostics adlı varsayılan dinamik şema tablosunun aksine ayrılmış veya sabit şema tablosu gibi kaynağa özgü bir tabloya yapılması gerektiğini belirten bayrak.

Bu bağımsız değişken yalnızca -workspaceId bağımsız değişkeni de verildiğinde etkilidir.

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

-InputObject

Giriş nesnesi (işlem hattından mümkündür.) Name ve resourceId bu nesneden ayıklanacak.

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

-MetricCategory

Ölçüm kategorileri listesi. Kategori belirtilmezse, bu komut desteklenen tüm kategorilerde çalışır.

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

-Name

Tanılama ayarının adı. Varsayılan değer hizmettir.

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

-ResourceId

Kaynağın kimliğini belirtir.

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

-RetentionEnabled

Tanılama bilgilerinin saklanmasının etkinleştirilip etkinleştirilmediğini gösterir. Bunun yalnızca bir Depolama hesabına veri kaydederken geçerli olduğunu unutmayın.

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

-RetentionInDays

Bekletme ilkesini gün olarak belirtir. Bunun yalnızca bir Depolama hesabına veri kaydederken geçerli olduğunu unutmayın.

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

-ServiceBusRuleId

Service Bus Kuralı kimliği.

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

-StorageAccountId

Verilerin kaydedildiği Depolama hesabının kimliğini belirtir.

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

-Timegrain

Etkin değerine göre ölçümler için etkinleştirileceği veya devre dışı bırakileceği zaman dilimlerini belirtir. Zaman dilimi belirtmezseniz, bu komut tüm kullanılabilir zaman dilimleri üzerinde çalışır.

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

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

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

-WorkspaceId

Günlükleri/ölçümleri göndermek için Log Analytics çalışma alanının kaynak kimliği

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

Girişler

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

Çıkışlar

PSServiceDiagnosticSettings