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