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.

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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

Type:List<T>[String]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Określa nazwę profilu.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ServiceBusRuleId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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