Dela via

Add-AzLogProfile

  • Referens
Modul:
Az.Monitor

Skapar en ny aktivitetsloggprofil. Den här profilen används för att antingen arkivera aktivitetsloggen till ett Azure Storage-konto eller strömma den till en Azure-händelsehubb i samma prenumeration.

Syntax

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

Cmdleten Add-AzLogProfile skapar en loggprofil.

  • Lagringskonto – Endast standardlagringskonto (premiumlagringskonto stöds inte) stöds. Den kan antingen vara av typen ARM eller klassisk. Om den loggas till ett lagringskonto debiteras kostnaden för att lagra aktivitetsloggen enligt normala standardlagringspriser. Det kan bara finnas en loggprofil per prenumeration som följd. Endast ett lagringskonto per prenumeration kan användas för att exportera aktivitetsloggen.
  • Händelsehubb – Det kan bara finnas en loggprofil per prenumeration som följd. Endast en händelsehubb per prenumeration kan användas för att exportera aktivitetsloggen. Om aktivitetsloggen strömmas till en händelsehubb tillämpas standardpriser för händelsehubben. I aktivitetsloggen kan händelser gälla för en region eller vara "Global". Global innebär i huvudsak att dessa händelser är regionoberoende och är oberoende av region, i själva verket faller majoriteten av händelserna i denna kategori. Om aktivitetsloggprofilen anges från portalen lägger den implicit till "Global" tillsammans med alla andra regioner som valts i användargränssnittet. När du använder cmdleten måste platsen som "Global" uttryckligen anges förutom andra regioner. Obs! Om du inte anger "Global" på platserna kommer en majoritet av aktivitetsloggen inte att exporteras. Den här cmdleten implementerar ShouldProcess-mönstret, dvs. den kan begära bekräftelse från användaren innan den faktiskt skapar, ändrar eller tar bort resursen.

Exempel

Exempel 1: Lägg till en ny loggprofil för att exportera aktivitetsloggen som matchar platsvillkoret till ett lagringskonto

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

Lägg till en ny loggprofil för att exportera aktivitetsloggen som matchar platsvillkoret till ett lagringskonto

Exempel 2

Skapar en ny aktivitetsloggprofil. (automatiskt genererad)

Add-AzLogProfile -Location 'Global' -Name ExportLogProfile -RetentionInDays <Int32> -ServiceBusRuleId <String> -StorageAccountId /subscriptions/40gpe80s-9sb7-4f07-9042-b1b6a92ja9fk/resourceGroups/activitylogRG/providers/Microsoft.Storage/storageAccounts/activitylogstorageaccount

Parametrar

-Category

Anger listan över kategorier.

Typ:List<T>[String]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Location

Anger platsen för loggprofilen. Giltiga värden: Kör cmdleten nedan för att hämta den senaste listan över platser. Get-AzLocation | Välj DisplayName

Typ:List<T>[String]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Anger namnet på profilen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-RetentionInDays

Anger kvarhållningsprincipen i dagar. Det här är antalet dagar som loggarna bevaras i det angivna lagringskontot. Om du vill behålla data för evigt anger du detta till 0. Om den inte har angetts är standardvärdet 0. Normala standardavgifter för lagring eller händelsehubb gäller för datakvarhållning.

Typ:Nullable<T>[Int32]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ServiceBusRuleId

Anger ID för Service Bus-regeln.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-StorageAccountId

Anger ID för lagringskontot. ID är det fullständigt kvalificerade resurs-ID:t för lagringskontot, till exempel /subscriptions/40gpe80s-9sb7-4f07-9042-b1b6a92ja9fk/resourceGroups/activitylogRG/providers/Microsoft.Storage/storageAccounts/activitylogstorageaccount

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

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

Utdata

PSLogProfile