Set-AzDiagnosticSetting

Модуль:

Az.Monitor Module

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

Синтаксис

OldSetDiagnosticSetting (по умолчанию)

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

NewSetDiagnosticSetting

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]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

OldSetDiagnosticSetting

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	cf

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-DefaultProfile

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

Свойства параметра

Тип:	IAzureContextContainer
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Enabled

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

Свойства параметра

Тип:	Boolean
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

OldSetDiagnosticSetting

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-EventHubAuthorizationRuleId

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

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

OldSetDiagnosticSetting

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-EventHubName

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

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

OldSetDiagnosticSetting

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-ExportToResourceSpecific

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

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

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

OldSetDiagnosticSetting

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-InputObject

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

Свойства параметра

Тип:	PSServiceDiagnosticSettings
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

NewSetDiagnosticSetting

Position:	Named
Обязательно:	True
Значение из конвейера:	True
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-MetricCategory

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

Свойства параметра

Тип:	List<T>[String]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

OldSetDiagnosticSetting

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-Name

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

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

OldSetDiagnosticSetting

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-ResourceId

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

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

OldSetDiagnosticSetting

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-RetentionEnabled

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

Свойства параметра

Тип:	Nullable<T>[Boolean]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

OldSetDiagnosticSetting

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-RetentionInDays

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

Свойства параметра

Тип:	Nullable<T>[Int32]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

OldSetDiagnosticSetting

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-ServiceBusRuleId

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

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

OldSetDiagnosticSetting

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-StorageAccountId

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

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

OldSetDiagnosticSetting

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-Timegrain

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

Свойства параметра

Тип:	List<T>[String]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

OldSetDiagnosticSetting

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-WhatIf

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

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	wi

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-WorkspaceId

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

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

OldSetDiagnosticSetting

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

PSServiceDiagnosticSettings

String

Boolean

List<T>

Nullable<T>

Nullable<T>

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

PSServiceDiagnosticSettings

Связанные ссылки

• Get-AzDiagnosticSetting
• Remove-AzDiagnosticSetting