Add-AzLogProfile
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 - Somente a conta de armazenamento padrão (a conta de armazenamento premium não é suportada) é suportada. 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 de armazenamento padrão normais. Pode haver apenas um perfil de log por assinatura, portanto, 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 log de atividades, os eventos podem pertencer a uma região ou podem ser "Globais". Global essencialmente significa 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 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. Observação :- A falha ao definir "Global" nos locais resultará em uma maioria do log de atividades não sendo exportado. Esse 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 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 usados 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. Taxas normais de faturamento de armazenamento padrão ou hub de eventos 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. 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
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]]