Add-AzLogProfile

  • Referenz
Modul:
Az.Monitor

Erstellt ein neues Aktivitätsprotokollprofil. Dieses Profil wird verwendet, um entweder das Aktivitätsprotokoll in ein Azure-Speicherkonto zu archivieren oder es in einen Azure Event Hub im selben Abonnement zu streamen.

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

Beschreibung

Das Cmdlet "Add-AzLogProfile " erstellt ein Protokollprofil.

  • Speicherkonto – Nur standardspeicherkonto (Premium-Speicherkonto wird nicht unterstützt) wird unterstützt. Es kann entweder vom Typ ARM oder Classic sein. Wenn es bei einem Speicherkonto protokolliert wird, werden die Kosten für das Speichern des Aktivitätsprotokolls in normalen Standardspeicherraten abgerechnet. Pro Abonnement kann nur ein Protokollprofil pro Abonnement vorhanden sein, das folgerichtig nur ein Speicherkonto pro Abonnement zum Exportieren des Aktivitätsprotokolls verwendet werden kann.
  • Event Hub – Es kann nur ein Protokollprofil pro Abonnement geben, das folgerichtig nur ein Event Hub pro Abonnement zum Exportieren des Aktivitätsprotokolls verwendet werden kann. Wenn das Aktivitätsprotokoll an einen Event Hub gestreamt wird, gelten standardmäßige Event Hub-Preise. Im Aktivitätsprotokoll können Ereignisse zu einer Region gehören oder "Global" sein. Global bedeutet im Wesentlichen, dass diese Ereignisse Regionenagnostik sind und unabhängig von der Region sind, in der Tat fallen die meisten Ereignisse in diese Kategorie. Wenn das Aktivitätsprotokollprofil aus dem Portal festgelegt wird, fügt es implizit "Global" zusammen mit einer anderen Region hinzu, die auf der Benutzeroberfläche ausgewählt ist. Bei Verwendung des Cmdlets muss der Speicherort als "Global" explizit Erwähnung werden, abgesehen von einer anderen Region. Hinweis :- Wenn "Global" an den Speicherorten nicht festgelegt wird, wird ein Großteil des Aktivitätsprotokolls nicht exportiert. Dieses Cmdlet implementiert das ShouldProcess-Muster, d. h. es kann eine Bestätigung des Benutzers anfordern, bevor die Ressource tatsächlich erstellt, geändert oder entfernt wird.

Beispiele

Beispiel 1: Hinzufügen eines neuen Protokollprofils zum Exportieren des Aktivitätsprotokolls, das der Standortbedingung entspricht, in ein Speicherkonto

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

Hinzufügen eines neuen Protokollprofils zum Exportieren des Aktivitätsprotokolls, das der Standortbedingung entspricht, in ein Speicherkonto

Beispiel 2

Erstellt ein neues Aktivitätsprotokollprofil. (automatisch generiert)

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

Parameter

-Category

Gibt die Liste der Kategorien an.

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

Gibt den Speicherort des Protokollprofils an. Gültige Werte: Führen Sie das folgende Cmdlet aus, um die neueste Liste der Speicherorte abzurufen. Get-AzLocation | Anzeigename auswählen

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

-Name

Gibt den Namen des Profils an.

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

-RetentionInDays

Gibt die Aufbewahrungsrichtlinie in Tagen an. Dies ist die Anzahl der Tage, an denen die Protokolle im angegebenen Speicherkonto beibehalten werden. Um die Daten für immer beizubehalten, legen Sie dies auf 0 fest. Wenn sie nicht angegeben ist, wird standardmäßig "0" verwendet. Normale Standardspeicher- oder Event Hub-Abrechnungssätze gelten für die Datenaufbewahrung.

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

-ServiceBusRuleId

Gibt die ID der ServiceBus-Regel an.

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

-StorageAccountId

Gibt die ID des Speicherkontos an. ID ist die vollqualifizierte Ressourcen-ID des Speicherkontos, z. B. /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

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

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

Ausgaben

PSLogProfile