Add-AzLogProfile
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.
Tipo: | List<T>[String] |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Position: | Named |
valor predeterminado: | None |
Requerido: | 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
Tipo: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
valor predeterminado: | None |
Requerido: | 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.
Tipo: | List<T>[String] |
Position: | Named |
valor predeterminado: | None |
Requerido: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Especifica el nombre del perfil.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | 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.
Tipo: | Nullable<T>[Int32] |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServiceBusRuleId
Especifica el identificador de la regla de Service Bus.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | 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
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | 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.
Tipo: | SwitchParameter |
Aliases: | wi |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
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
Vínculos relacionados
Azure PowerShell
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente las Cuestiones de GitHub como mecanismo de retroalimentación para el contenido y lo sustituiremos por un nuevo sistema de retroalimentación. Para más información, consulta:Enviar y ver comentarios de