Set-AzDiagnosticSetting

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

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>]
   [-ExportToResourceSpecific]
   [-RetentionInDays <Int32>]
   [-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 tanecik 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

PS C:\>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

PS C:\>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

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

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

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

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

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

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

Bu komut yalnızca Category1, Category2 ve time grain PT1M'yi etkinleştirir. Diğer tüm zaman dilimleri ve kategorileri değişmez.

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

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

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

Parametreler

-Category

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

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

-EventHubAuthorizationRuleId

Olay hub'ı yetkilendirme kuralı kimliği

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

-EventHubName

Olay hub'ı adı

Type:String
Position:Named
Default value:None
Required:False
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 geçerlidir.

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

-MetricCategory

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

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

-ResourceId

Kaynağın kimliğini belirtir.

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

-RetentionEnabled

Tanılama bilgilerinin saklanmasının etkinleştirilip etkinleştirilmediğini gösterir.

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

-RetentionInDays

Bekletme ilkesini gün olarak belirtir.

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

-ServiceBusRuleId

Service Bus Kuralı kimliği.

Type:String
Position:Named
Default value:None
Required:False
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
Required:False
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 dilimlerinde çalışır.

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

-WorkspaceId

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

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