Add-AzLogProfile

  • Referencia
Módulo:
Az.Monitor

Crea un nuevo perfil de registro de actividad. Este perfil se usa para archivar el registro de actividad en una cuenta de Almacenamiento de Azure o transmitirlo a un centro de eventos de Azure en la misma suscripción.

Syntax

Add-AzLogProfile
   -Name <String>
   [-StorageAccountId <String>]
   [-ServiceBusRuleId <String>]
   [-RetentionInDays <Int32>]
   -Location <System.Collections.Generic.List`1[System.String]>
   [-Category <System.Collections.Generic.List`1[System.String]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Add-AzLogProfile crea un perfil de registro.

  • Cuenta de almacenamiento: solo se admite la cuenta de almacenamiento estándar (no se admite la cuenta de almacenamiento premium). Podría ser de tipo ARM o clásico. Si se registra en una cuenta de almacenamiento, el costo de almacenar el registro de actividad se factura según las tarifas de almacenamiento estándar normales. Solo podría haber un perfil de registro por suscripción, lo que conlleva que solo se pueda usar una cuenta de almacenamiento por suscripción para exportar el registro de actividad.
  • Centro de eventos: solo puede haber un perfil de registro por suscripción, lo que conlleva que solo se pueda usar un centro de eventos por suscripción para exportar el registro de actividad. Si el registro de actividad se transmite a un centro de eventos, se aplicarán los precios estándar del centro de eventos. En el registro de actividad, los eventos pueden pertenecer a una región o pueden ser "Globales". Global básicamente significa que estos eventos son independientes de la región y son independientes de la región, de hecho, la mayoría de los eventos se dividen en esta categoría. Si el perfil de registro de actividad se establece desde el portal, agrega implícitamente "Global" junto con cualquier otra región seleccionada en la interfaz de usuario. Al usar el cmdlet , la ubicación como "Global" debe mencionarse explícitamente aparte de cualquier otra región. Nota : Si no se establece "Global" en las ubicaciones, la mayoría del registro de actividad no se exportará. 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: Agregar un nuevo perfil de registro para exportar el registro de actividad que coincide con la condición de ubicación a una cuenta de almacenamiento

Add-AzLogProfile -Location "Global","West US" -Name ExportLogProfile -StorageAccountId /subscriptions/40gpe80s-9sb7-4f07-9042-b1b6a92ja9fk/resourceGroups/activitylogRG/providers/Microsoft.Storage/storageAccounts/activitylogstorageaccount

Adición de un nuevo perfil de registro para exportar el registro de actividad que coincida con la condición de ubicación a una cuenta de almacenamiento

Ejemplo 2

Crea un nuevo perfil de registro de actividad. (generado automáticamente)

Add-AzLogProfile -Location 'Global' -Name ExportLogProfile -RetentionInDays <Int32> -ServiceBusRuleId <String> -StorageAccountId /subscriptions/40gpe80s-9sb7-4f07-9042-b1b6a92ja9fk/resourceGroups/activitylogRG/providers/Microsoft.Storage/storageAccounts/activitylogstorageaccount

Parámetros

-Category

Especifica la lista de categorías.

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

-Location

Especifica la ubicación del perfil de registro. Valores válidos: ejecute el cmdlet siguiente para obtener la lista más reciente de ubicaciones. Get-AzLocation | Seleccione DisplayName.

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

-Name

Especifica el nombre del perfil.

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

-RetentionInDays

Especifica la directiva de retención, en días. Este es el número de días que los registros se conservan en la cuenta de almacenamiento especificada. Para conservar los datos para siempre, establezca este valor en 0. Si no se especifica, el valor predeterminado es 0. Las tarifas de facturación normales del almacenamiento estándar o del centro de eventos se aplicarán a la retención de datos.

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

-ServiceBusRuleId

Especifica el identificador de la 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. Id. es el identificador de recurso completo de la cuenta de almacenamiento por ejemplo /subscriptions/40gpe80s-9sb7-4f07-9042-b1b6a92ja9fk/resourceGroups/activitylogRG/providers/Microsoft.Storage/storageAccounts/activitylogstorageaccount

Type: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

Entradas

String

Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

List<T>[[System.String, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Salidas

PSLogProfile