Compartilhar via

Add-AzLogProfile

  • Referência
Módulo:
Az.Monitor

Cria um novo perfil de log 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.

Sintaxe

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 – há suporte apenas para a conta de armazenamento padrão (não há suporte para a conta de armazenamento premium). Pode ser do tipo ARM ou Classic. Se ele estiver registrado em uma conta de armazenamento, o custo de armazenamento do log 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, o preço padrão do hub de eventos será aplicado. No registro de atividades, os eventos podem pertencer a uma região ou podem ser "Globais". Global significa essencialmente que esses eventos são agnósticos de região e são independentes da região, na verdade, a maioria dos eventos se enquadra nessa categoria. Se o perfil do log de atividades for definido no 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 mencionado explicitamente além de qualquer outra região. Nota : - Deixar de definir "Global" nos locais fará com que a maioria do registro de atividades não seja exportada. Esse cmdlet implementa o padrão ShouldProcess, ou seja, ele pode solicitar a 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 que corresponde à 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 que corresponde à condição de local para uma conta de armazenamento

Exemplo 2

Cria um novo perfil de log 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.

Tipo:List<T>[String]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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-AzLocation | Selecione DisplayName

Tipo:List<T>[String]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

Especifica o nome do perfil.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-RetentionInDays

Especifica a política de retenção, em dias. Esse é 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 cobrança do hub de eventos ou armazenamento padrão serão aplicadas para retenção de dados.

Tipo:Nullable<T>[Int32]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ServiceBusRuleId

Especifica a ID da regra do Barramento de Serviço.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-StorageAccountId

Especifica a ID da conta de armazenamento. A ID é a ID de recurso totalmente qualificada da conta de armazenamento, por exemplo, /subscriptions/40gpe80s-9sb7-4f07-9042-b1b6a92ja9fk/resourceGroups/activitylogRG/providers/Microsoft.Storage/storageAccounts/activitylogstorageaccount

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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