Partilhar via

Set-AzDiagnosticSetting

  • Referência
Módulo:
Az.Monitor

Define as configurações de logs e métricas para o recurso.

Sintaxe

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

O cmdlet Set-AzDiagnosticSetting habilita ou desabilita cada categoria de log e grão de tempo para o recurso específico. Os logs e métricas são armazenados na conta de armazenamento especificada. Este cmdlet implementa o padrão ShouldProcess, ou seja, pode solicitar confirmação do usuário antes de realmente criar, modificar ou remover o recurso.

Exemplos

Exemplo 1: Habilitar todas as métricas e logs para um recurso

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

Este comando habilita todas as métricas e logs disponíveis para Resource01.

Exemplo 2: Desativar todas as métricas e logs

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

Este comando desativa todas as métricas e logs disponíveis para o recurso Resource01.

Exemplo 3: Ativar/desativar várias categorias de métricas

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

Este comando desativa as categorias de métricas chamadas Categoria1 e Categoria2. Todas as outras categorias permanecem as mesmas.

Exemplo 4: Ativar/desativar várias categorias de log

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

Este comando habilita Categoria1 e Categoria2. Todas as outras métricas e categorias de logs permanecem as mesmas.

Exemplo 4: Habilitar um grão de tempo e várias categorias

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

Este comando habilita apenas Categoria1, Categoria2 e granulação de tempo PT1M. Todos os outros grãos e categorias de tempo permanecem inalterados.

Exemplo 5: Usando pipeline

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

Este comando usa o pipeline do PowerShell para definir (nenhuma alteração feita) uma configuração de diagnóstico.

Parâmetros

-Category

Especifica a lista de categorias de log a serem habilitadas ou desabilitadas, de acordo com o valor de Enabled. Se nenhuma categoria for especificada, esse comando será operado em todas as categorias suportadas.

Tipo:List<T>[String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Enabled

Indica se o diagnóstico deve ser habilitado. Especifique $True para habilitar diagnósticos ou $False desabilitar diagnósticos.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-EventHubAuthorizationRuleId

A ID da regra de autorização do hub de eventos

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-EventHubName

O nome do hub de eventos

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ExportToResourceSpecific

Sinalizador que indica que a exportação para LA deve ser feita para uma tabela específica de recurso, também conhecida como tabela de esquema dedicada ou fixa, em oposição à tabela de esquema dinâmico padrão chamada AzureDiagnostics.

Esse argumento só é efetivo quando o argumento -workspaceId também é fornecido.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-InputObject

O objeto de entrada (possível a partir do pipeline.) O nome e resourceId serão extraídos deste objeto.

Tipo:PSServiceDiagnosticSettings
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-MetricCategory

A lista de categorias métricas. Se nenhuma categoria for especificada, esse comando será operado em todas as categorias suportadas.

Tipo:List<T>[String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Name

O nome da configuração de diagnóstico. O valor padrão é service.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ResourceId

Especifica a ID do recurso.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-RetentionEnabled

Indica se a retenção de informações de diagnóstico está habilitada.

Tipo:Nullable<T>[Boolean]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-RetentionInDays

Especifica a política de retenção, em dias.

Tipo:Nullable<T>[Int32]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ServiceBusRuleId

A ID da Regra do Service Bus.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-StorageAccountId

Especifica a ID da conta de armazenamento na qual salvar os dados.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Timegrain

Especifica os grãos de tempo a serem habilitados ou desabilitados para métricas, de acordo com o valor de Enabled. Se você não especificar um grão de tempo, esse comando operará em todos os grãos de tempo disponíveis.

Tipo:List<T>[String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WorkspaceId

O ID do recurso do espaço de trabalho do Log Analytics para enviar logs/métricas para

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Entradas

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

Saídas

PSServiceDiagnosticSettings