Udostępnij za pośrednictwem

Add-AzLogProfile

  • Odwołanie
Moduł:
Az.Monitor

Tworzy nowy profil dziennika aktywności. Ten profil służy do archiwizowania dziennika aktywności na koncie usługi Azure Storage lub przesyłania strumieniowego go do centrum zdarzeń platformy Azure w tej samej subskrypcji.

Składnia

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

Opis

Polecenie cmdlet Add-AzLogProfile tworzy profil dziennika.

  • Konto magazynu — obsługiwane jest tylko standardowe konto magazynu (konto magazynu w warstwie Premium nie jest obsługiwane). Może to być typ ARM lub klasyczny. Jeśli jest rejestrowany na koncie magazynu, koszt przechowywania dziennika aktywności jest rozliczany przy normalnych standardowych stawkach magazynowania. W celu wyeksportowania dziennika dzienników można użyć tylko jednego profilu dziennika na subskrypcję.
  • Centrum zdarzeń — w celu wyeksportowania dziennika może być używany tylko jeden profil dziennika dla subskrypcji tylko jeden koncentrator zdarzeń na subskrypcję. Jeśli dziennik aktywności jest przesyłany strumieniowo do centrum zdarzeń, będą stosowane standardowe ceny centrum zdarzeń. W dzienniku aktywności zdarzenia mogą dotyczyć regionu lub mogą być "Globalne". Globalne zasadniczo oznacza, że te zdarzenia są niezależne od regionu i są niezależne od regionu, w rzeczywistości większość zdarzeń należy do tej kategorii. Jeśli profil dziennika aktywności jest ustawiony z portalu, niejawnie dodaje "Globalny" wraz z dowolnym innym regionem wybranym w interfejsie użytkownika. W przypadku korzystania z polecenia cmdlet lokalizacja jako "Global" musi być jawnie wymieniona poza dowolnym innym regionem. Uwaga : nie można ustawić wartości "Global" w lokalizacjach, co spowoduje, że większość dzienników aktywności nie zostanie wyeksportowana. To polecenie cmdlet implementuje wzorzec ShouldProcess, tj. może zażądać potwierdzenia od użytkownika przed utworzeniem, zmodyfikowaniem lub usunięciem zasobu.

Przykłady

Przykład 1. Dodawanie nowego profilu dziennika w celu wyeksportowania dziennika aktywności zgodnego z warunkiem lokalizacji do konta magazynu

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

Dodawanie nowego profilu dziennika w celu wyeksportowania dziennika aktywności zgodnego z warunkiem lokalizacji na koncie magazynu

Przykład 2

Tworzy nowy profil dziennika aktywności. (automatycznie wygenerowane)

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

Parametry

-Category

Określa listę kategorii.

Typ:List<T>[String]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Location

Określa lokalizację profilu dziennika. Prawidłowe wartości: uruchom poniższe polecenie cmdlet, aby uzyskać najnowszą listę lokalizacji. Get-AzLocation | Wybierz pozycję DisplayName

Typ:List<T>[String]
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę profilu.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-RetentionInDays

Określa zasady przechowywania w dniach. Jest to liczba dni, przez które dzienniki są zachowywane na określonym koncie magazynu. Aby zachować dane na zawsze, ustaw wartość 0. Jeśli nie zostanie określony, wartość domyślna to 0. Normalne standardowe stawki rozliczeń magazynu lub centrum zdarzeń będą stosowane do przechowywania danych.

Typ:Nullable<T>[Int32]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ServiceBusRuleId

Określa identyfikator reguły usługi Service Bus.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-StorageAccountId

Określa identyfikator konta magazynu. Identyfikator jest w pełni kwalifikowanym identyfikatorem zasobu konta magazynu, na przykład /subscriptions/40gpe80s-9sb7-4f07-9042-b1b6a92ja9fk/resourceGroups/activitylogRG/providers/Microsoft.Storage/storageAccounts/activitylogstorageaccount

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

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

Dane wyjściowe

PSLogProfile