Add-AzLogProfile

Módulo:
Az.Monitor Module

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

Sintaxe

Default (Default) 

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 Clássico. Se ele estiver conectado a uma conta de armazenamento, o custo de armazenar o log de atividades será cobrado com 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 do hub de eventos padrão serão aplicados. No log de atividades, os eventos podem pertencer a uma região ou podem ser "Globais". Global essencialmente significa que esses eventos são independentes da região e são independentes da região, na verdade, a maioria dos eventos se enquadra nessa categoria. Se o perfil de log de atividades for definido no portal, ele adicionará implicitamente "Global" juntamente 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. Observação :- A falha na definição de "Global" nos locais resultará na não exportação da maioria do log de atividades. Esse cmdlet implementa o padrão ShouldProcess, ou seja, ele 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 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. (autogenerated)

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.

Propriedades do parâmetro

Tipo:

List<T>[String]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Confirm

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DefaultProfile

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

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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

Propriedades do parâmetro

Tipo:

List<T>[String]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Name

Especifica o nome do perfil.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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 manter os dados definidos para sempre 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 à retenção de dados.

Propriedades do parâmetro

Tipo:

Nullable<T>[Int32]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ServiceBusRuleId

Especifica a ID da regra Barramento de Serviço.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-WhatIf

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

Nullable<T>

List<T>

Saídas

PSLogProfile