Condividi tramite

Add-AzureRmLogProfile

  • Riferimento
Modulo:
AzureRM.Insights

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.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

Add-AzureRmLogProfile
   -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-AzureRmLogProfile crea un profilo di log.

  • Archiviazione account: è 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-AzureRmLogProfile -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: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-AzureLocation | 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 Archiviazione. ID è l'ID risorsa completo dell'account di archiviazione, ad esempio
/subscriptions/40gpe80s-9sb7-4f07-9042-b1b6a92ja9fk/resourceGroups/activitylogRG/providers/Microsoft. Archiviazione/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, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Output

PSLogProfile