Udostępnij przez

Add-AzLogProfile

Moduł:
Az.Monitor Module

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

Default (Domyślne) 

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. (autogenerated)

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.

Właściwości parametrów

Typ:

List<T>[String]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:por

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DefaultProfile

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

Właściwości parametrów

Typ:IAzureContextContainer
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów: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

Właściwości parametrów

Typ:

List<T>[String]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-Name

Określa nazwę profilu.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów: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.

Właściwości parametrów

Typ:

Nullable<T>[Int32]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-ServiceBusRuleId

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

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów: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

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:Wi

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Wejścia

String

Nullable<T>

List<T>

Wyjść

PSLogProfile