Compartir a través de

Add-AzureRmLogProfile

  • Referencia
Módulo:
AzureRM.Insights

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.

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Sintaxis

Add-AzureRmLogProfile
   -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-AzureRmLogProfile 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 coincida con la condición de ubicación a una cuenta de almacenamiento

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

Parámetros

-Category

Especifica la lista de categorías.

Tipo:List<T>[String]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Confirm

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

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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-AzureLocation | Seleccione DisplayName.

Tipo:List<T>[String]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

Especifica el nombre del perfil.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:Nullable<T>[Int32]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ServiceBusRuleId

Especifica el identificador de la regla de Service Bus.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-StorageAccountId

Especifica el identificador de la cuenta de almacenamiento. El identificador 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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Salidas

PSLogProfile