Aracılığıyla paylaş

Set-AzureRmDiagnosticSetting

  • Başvuru
Modül:
AzureRM.Insights

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

Uyarı

AzureRM PowerShell modülü 29 Şubat 2024 itibarıyla resmi olarak kullanım dışı bırakılmıştır. Kullanıcıların destek ve güncelleştirmelerin devam etmesini sağlamak için AzureRM'den Az PowerShell modülüne geçmeleri tavsiye edilir.

AzureRM modülü çalışmaya devam edebilir, ancak artık bakım yapılmaz veya desteklenmez ve kullanıcının takdirine ve riskine bağlı olarak sürekli kullanım sağlanır. Az modülüne geçiş konusunda yönergeler için lütfen geçiş kaynaklarımıza bakın.

Syntax

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

Description

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

Bu komut Category1 ve Category2 adlı ölçüm kategorilerini etkinleştirir. 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-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

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

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

Parametreler

-Categories

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.

Tür:List<T>[String]
Aliases:Category
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

Tür:SwitchParameter
Aliases:cf
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Tür:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
varsayılan değer:None
Gerekli: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.

Tür:Boolean
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters:False

-EventHubAuthorizationRuleId

Olay hub'ı yetkilendirme kuralı kimliği

Tür:String
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters:False

-EventHubName

Olay hub'ı adı

Tür:String
Position:Named
varsayılan değer:None
Gerekli: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.

Tür:PSServiceDiagnosticSettings
Position:Named
varsayılan değer:None
Gerekli:True
Accept pipeline input:True
Accept wildcard characters:False

-MetricCategory

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

Tür:List<T>[String]
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Tür:String
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

Kaynağın kimliğini belirtir.

Tür:String
Position:Named
varsayılan değer:None
Gerekli:True
Accept pipeline input:True
Accept wildcard characters:False

-RetentionEnabled

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

Tür:Nullable<T>[Boolean]
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters:False

-RetentionInDays

Bekletme ilkesini gün olarak belirtir.

Tür:Nullable<T>[Int32]
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters:False

-ServiceBusRuleId

Service Bus Kuralı kimliği.

Tür:String
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountId

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

Tür:String
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters:False

-Timegrains

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.

Tür:List<T>[String]
Aliases:Timegrain
Position:Named
varsayılan değer:None
Gerekli: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.

Tür:SwitchParameter
Aliases:wi
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:False
Accept wildcard characters:False

-WorkspaceId

Çalışma alanının kimliği

Tür:String
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters:False

Girişler

PSServiceDiagnosticSettings

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

Çıkışlar

PSServiceDiagnosticSettings