Set-AzDiagnosticSetting

  • Referencia
Módulo:
Az.Monitor

Establece la configuración de registros y métricas del recurso.

Syntax

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

El cmdlet Set-AzDiagnosticSetting habilita o deshabilita cada categoría de intervalo de tiempo y registro para el recurso concreto. Los registros y las métricas se almacenan en la cuenta de almacenamiento especificada. Este cmdlet implementa el patrón ShouldProcess, es decir, podría solicitar confirmación del usuario antes de crear, modificar o quitar el recurso realmente.

Ejemplos

Ejemplo 1: Habilitación de todas las métricas y registros de un recurso

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

Este comando habilita todas las métricas y registros disponibles para Resource01.

Ejemplo 2: Deshabilitar todas las métricas y registros

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

Este comando deshabilita todas las métricas y registros disponibles para el recurso Resource01.

Ejemplo 3: Habilitar o deshabilitar varias categorías 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 deshabilita las categorías de métricas denominadas Category1 y Category2. Todas las demás categorías siguen siendo las mismas.

Ejemplo 4: Habilitar o deshabilitar varias categorías de registro

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 Category1 y Category2. Todas las demás métricas y categorías de registros siguen siendo las mismas.

Ejemplo 4: Habilitar un intervalo de tiempo y varias categorías

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

Este comando solo habilita Category1, Category2 y time grain PT1M. El resto de granos y categorías de tiempo no se modifican.

Ejemplo 5: Uso de la canalización

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

Este comando usa la canalización de PowerShell para establecer (sin cambios realizados) una configuración de diagnóstico.

Parámetros

-Category

Especifica la lista de categorías de registro que se van a habilitar o deshabilitar, según el valor de Habilitado. Si no se especifica ninguna categoría, este comando funciona en todas las categorías admitidas.

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

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

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

-Enabled

Indica si se habilitan los diagnósticos. Especifique $True para habilitar diagnósticos o $False para deshabilitar los diagnósticos.

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

-EventHubAuthorizationRuleId

Identificador de la regla de autorización del centro de eventos

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

-EventHubName

Nombre del centro de eventos

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

-ExportToResourceSpecific

Marca que indica que la exportación a LA debe realizarse en una tabla específica del recurso, a.k.a. tabla de esquemas dedicada o fija, en lugar de la tabla de esquema dinámico predeterminada denominada AzureDiagnostics.

Este argumento solo es efectivo cuando también se proporciona el argumento -workspaceId .

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

-InputObject

Objeto de entrada (posible desde la canalización). El nombre y resourceId se extraerán de este objeto.

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

-MetricCategory

Lista de categorías de métricas. Si no se especifica ninguna categoría, este comando funciona en todas las categorías admitidas.

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

-Name

Nombre de la configuración de diagnóstico. El valor predeterminado es service.

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

-ResourceId

Especifica el identificador del recurso.

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

-RetentionEnabled

Indica si está habilitada la retención de información de diagnóstico.

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

-RetentionInDays

Especifica la directiva de retención, en días.

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

-ServiceBusRuleId

Identificador de regla de Service Bus.

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

-StorageAccountId

Especifica el identificador de la cuenta de almacenamiento en la que se guardarán los datos.

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

-Timegrain

Especifica los granos de tiempo que se van a habilitar o deshabilitar para las métricas, según el valor de Habilitado. Si no especifica un intervalo de tiempo, este comando funciona en todos los granos de tiempo disponibles.

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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

-WorkspaceId

Identificador de recurso del área de trabajo de Log Analytics para enviar registros o métricas a

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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]]

Salidas

PSServiceDiagnosticSettings