Set-AzDiagnosticSetting

Задает параметры журналов и метрик для ресурса.

Примечание

Это предыдущая версия нашей документации. Для получения актуальных сведений обратитесь к самой последней версии .

Синтаксис

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

Описание

Командлет Set-AzDiagnosticSetting включает или отключает каждый раз категорию интервалов и журналов для конкретного ресурса. Журналы и метрики хранятся в указанной учетной записи хранения. Этот командлет реализует шаблон ShouldProcess, т. е. может запросить подтверждение от пользователя перед фактическим созданием, изменением или удалением ресурса.

Примеры

Пример 1. Включение всех метрик и журналов для ресурса

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

Эта команда включает все доступные метрики и журналы для Resource01.

Пример 2. Отключение всех метрик и журналов

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

Эта команда отключает все доступные метрики и журналы для ресурса Resource01.

Пример 3. Включение и отключение нескольких категорий метрик

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

Эта команда отключает категории метрик с именем Category1 и Category2. Все остальные категории остаются прежними.

Пример 4. Включение и отключение нескольких категорий журналов

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

Эта команда включает Category1 и Category2. Все остальные категории метрик и журналов остаются неизменными.

Пример 5. Включение интервала времени и нескольких категорий

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

Эта команда включает только Category1, Category2 и time grain PT1M. Все остальные интервалы времени и категории не изменяются.

Пример 6. Использование конвейера

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

Эта команда использует конвейер PowerShell для установки (без изменений) параметра диагностики.

Пример 7. Включение всех категорий для подписки

$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

Эта команда включила все категории журналов для подписки.

Параметры

-Category

Указывает список категорий журналов для включения или отключения в соответствии со значением Enabled. Если категория не указана, эта команда работает со всеми поддерживаемыми категориями.

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

-Confirm

Запрос подтверждения перед выполнением командлета.

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

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure

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

-Enabled

Указывает, следует ли включать диагностику. Укажите $True для включения диагностики или $False для отключения диагностики.

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

-EnableLog

Значение, указывающее, следует ли включать или отключать журналы диагностики.

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

-EnableMetrics

Значение, указывающее, следует ли включать или отключать диагностические метрики.

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

-EventHubAuthorizationRuleId

Идентификатор правила авторизации концентратора событий

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

-EventHubName

Имя концентратора событий

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

-ExportToResourceSpecific

Флаг, указывающий, что экспорт в LA должен выполняться в определенную таблицу ресурсов, например выделенную или фиксированную таблицу схемы, а не таблицу динамической схемы по умолчанию с именем AzureDiagnostics.

Этот аргумент действует только при указании аргумента -workspaceId .

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

-InputObject

Входной объект (возможно, из конвейера).) Имя и идентификатор ресурса будут извлечены из этого объекта.

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

-MetricCategory

Список категорий метрик. Если категория не указана, эта команда работает со всеми поддерживаемыми категориями.

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

-Name

Имя параметра диагностики. Значением по умолчанию является служба.

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

-ResourceId

Указывает идентификатор ресурса.

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

-RetentionEnabled

Указывает, включено ли хранение диагностических сведений. Обратите внимание, что это применяется только при сохранении данных в учетной записи хранения.

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

-RetentionInDays

Указывает политику хранения в днях. Обратите внимание, что это применяется только при сохранении данных в учетной записи хранения.

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

-ServiceBusRuleId

Идентификатор правила служебной шины.

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

-StorageAccountId

Указывает идентификатор учетной записи хранения, в которой сохраняются данные.

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

-Timegrain

Задает интервалы времени для включения или отключения метрик в соответствии со значением Enabled. Если не указать интервал времени, эта команда будет работать со всеми доступными интервалами времени.

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

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

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

-WorkspaceId

Идентификатор ресурса рабочей области Log Analytics для отправки журналов и метрик в

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

Входные данные

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

Выходные данные

PSServiceDiagnosticSettings