Add-AzLogProfile
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 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/activitylogstorageaccountHinzufü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/activitylogstorageaccountParameter
-Category
Gibt die Liste der Kategorien an.
| Typ: | List<T>[String] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
| Typ: | IAzureContextContainer |
| Aliase: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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
| Typ: | List<T>[String] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Name
Gibt den Namen des Profils an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | Nullable<T>[Int32] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-ServiceBusRuleId
Gibt die ID der ServiceBus-Regel an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | 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
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
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]]