Condividi tramite


Add-AzLogProfile

Crea un nuovo profilo del log attività. Questo profilo viene usato per archiviare il log attività in un account di archiviazione di Azure o trasmetterlo a un hub eventi di Azure nella stessa sottoscrizione.

Sintassi

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

Descrizione

Il cmdlet Add-AzLogProfile crea un profilo di log.

  • Account di archiviazione: è supportato solo l'account di archiviazione Standard (l'account di archiviazione Premium non è supportato). Potrebbe essere di tipo ARM o Classico. Se viene registrato in un account di archiviazione, il costo dell'archiviazione del log attività viene fatturato a normali tariffe di archiviazione standard. È possibile usare un solo profilo di log per sottoscrizione consequenzialemente un solo account di archiviazione per sottoscrizione per esportare il log attività.
  • Hub eventi: può essere usato un solo profilo di log per sottoscrizione consequenzialemente solo un hub eventi per sottoscrizione per esportare il log attività. Se il log attività viene trasmesso a un hub eventi, verranno applicati i prezzi standard dell'hub eventi. Nel log attività gli eventi possono essere relativi a un'area o possono essere "Globali". Fondamentalmente, questi eventi sono indipendenti dall'area geografica e sono indipendenti dall'area, in realtà la maggior parte degli eventi rientra in questa categoria. Se il profilo del log attività viene impostato dal portale, aggiunge in modo implicito "Globale" insieme a qualsiasi altra area selezionata nell'interfaccia utente. Quando si usa il cmdlet , il percorso come "Global" deve essere indicato in modo esplicito a parte qualsiasi altra area. Nota : se non si imposta "Globale" nelle posizioni, la maggior parte del log attività non viene esportata. Questo cmdlet implementa il modello ShouldProcess, ovvero potrebbe richiedere conferma all'utente prima di creare, modificare o rimuovere la risorsa.

Esempio

Esempio 1: Aggiungere un nuovo profilo di log per esportare il log attività corrispondente alla condizione di posizione in un account di archiviazione

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

Parametri

-Category

Specifica l'elenco di categorie.

Tipo:List<T>[String]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Location

Specifica il percorso del profilo di log. Valori validi: eseguire il cmdlet seguente per ottenere l'elenco più recente delle posizioni. Get-AzLocation | Selezionare DisplayName

Tipo:List<T>[String]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specifica il nome del profilo.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-RetentionInDays

Specifica i criteri di conservazione, in giorni. Questo è il numero di giorni in cui i log vengono conservati nell'account di archiviazione specificato. Per conservare i dati impostati per sempre su 0. Se non è specificato, il valore predefinito è 0. Le normali tariffe di fatturazione per l'archiviazione standard o l'hub eventi verranno applicate per la conservazione dei dati.

Tipo:Nullable<T>[Int32]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ServiceBusRuleId

Specifica l'ID della regola di bus di servizio.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-StorageAccountId

Specifica l'ID dell'account di archiviazione. ID è l'ID risorsa completo dell'account di archiviazione, ad esempio /subscriptions/40gpe80s-9sb7-4f07-9042-b1b6a92ja9fk/resourceGroups/activitylogRG/providers/Microsoft.Storage/storageAccounts/activitylogstorageaccount

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

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

Output

PSLogProfile