Add-AzLogProfile

  • Referência
Módulo:
Az.Monitor

Cria um novo perfil de registro de atividades. Esse perfil é usado para arquivar o log de atividades em uma conta de armazenamento do Azure ou transmiti-lo para um hub de eventos do Azure na mesma assinatura.

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

O cmdlet Add-AzLogProfile cria um perfil de log.

  • Conta de armazenamento - Apenas a conta de armazenamento padrão (não há suporte para conta de armazenamento premium) é suportada. Pode ser do tipo ARM ou Classic. Se ele estiver conectado a uma conta de armazenamento, o custo de armazenamento do registro de atividades será cobrado de acordo com as taxas normais de armazenamento padrão. Pode haver apenas um perfil de log por assinatura, consequentemente, apenas uma conta de armazenamento por assinatura pode ser usada para exportar o log de atividades.
  • Hub de Eventos - Pode haver apenas um perfil de log por assinatura, consequentemente, apenas um hub de eventos por assinatura pode ser usado para exportar o log de atividades. Se o log de atividades for transmitido para um hub de eventos, os preços padrão do hub de eventos serão aplicados. No registro de atividades, os eventos podem pertencer a uma região ou podem ser "Global". Global significa, essencialmente, que estes eventos são agnósticos da região e são independentes da região, na verdade, a maioria dos eventos se enquadra nesta categoria. Se o perfil do registro de atividades for definido a partir do portal, ele adicionará implicitamente "Global" junto com qualquer outra região selecionada na interface do usuário. Ao usar o cmdlet, o local como "Global" deve ser explicitamente mencionado além de qualquer outra região. Nota :- A falha ao definir "Global" nos locais resultará na maioria do log de atividades não sendo exportado. 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: Adicionar um novo perfil de log para exportar o log de atividades correspondente à condição de local para uma conta de armazenamento

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

Adicionar um novo perfil de log para exportar o log de atividades correspondente à condição de local para uma conta de armazenamento

Exemplo 2

Cria um novo perfil de registro de atividades. (gerado automaticamente)

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 a lista de categorias.

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

-Confirm

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

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

-DefaultProfile

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

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

-Location

Especifica o local do perfil de log. Valores válidos: execute o cmdlet abaixo para obter a lista mais recente de locais. Get-AzLocalização | Selecione DisplayName

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

-Name

Especifica o nome do perfil.

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

-RetentionInDays

Especifica a política de retenção, em dias. Este é o número de dias em que os logs são preservados na conta de armazenamento especificada. Para reter os dados para sempre, defina isso como 0. Se não for especificado, o padrão será 0. As taxas normais de faturamento padrão de armazenamento ou hub de eventos serão aplicadas para retenção de dados.

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

-ServiceBusRuleId

Especifica a ID da regra do Service Bus.

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

-StorageAccountId

Especifica a ID da conta de armazenamento. ID é o ID de recurso totalmente qualificado da conta de armazenamento, por exemplo, /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

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

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

Saídas

PSLogProfile