Freigeben über

Add-AzLogProfile

Modul:
Az.Monitor Module

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

Default (Standard) 

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 neben einer anderen Region erwähnt werden. 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. (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

Parameter

-Category

Gibt die Liste der Kategorien an.

Parametereigenschaften

Typ:

List<T>[String]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

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

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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

Parametereigenschaften

Typ:

List<T>[String]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Name

Gibt den Namen des Profils an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:

Nullable<T>[Int32]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ServiceBusRuleId

Gibt die ID der ServiceBus-Regel an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten: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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-WhatIf

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

String

Nullable<T>

List<T>

Ausgaben

PSLogProfile