Поделиться через

Set-AzDiagnosticSetting

  • Ссылка
Модуль:
Az.Monitor

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

Синтаксис

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

Описание

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

Примеры

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

PS C:\>Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $True

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

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

PS C:\>Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $False

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

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

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

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

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

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

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

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

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

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

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

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

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

Параметры

-Category

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

Тип:List<T>[String]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Confirm

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

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DefaultProfile

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

Тип:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Enabled

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

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-EventHubAuthorizationRuleId

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-EventHubName

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ExportToResourceSpecific

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

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-InputObject

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

Тип:PSServiceDiagnosticSettings
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-MetricCategory

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

Тип:List<T>[String]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Name

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ResourceId

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

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-RetentionEnabled

Указывает, включена ли хранение диагностических сведений.

Тип:Nullable<T>[Boolean]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-RetentionInDays

Указывает политику хранения в днях.

Тип:Nullable<T>[Int32]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ServiceBusRuleId

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-StorageAccountId

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Timegrain

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

Тип:List<T>[String]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-WhatIf

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

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WorkspaceId

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки: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