Add-AzLogProfile
Hiermee maakt u een nieuw activiteitenlogboekprofiel. Dit profiel wordt gebruikt om het activiteitenlogboek te archiveren naar een Azure-opslagaccount of om het te streamen naar een Azure Event Hub in hetzelfde abonnement.
Syntaxis
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>] Description
Met de cmdlet Add-AzLogProfile wordt een logboekprofiel gemaakt.
- Opslagaccount : alleen een standard-opslagaccount (Premium-opslagaccount wordt niet ondersteund) wordt ondersteund. Het kan van het type ARM of klassiek zijn. Als het is geregistreerd bij een opslagaccount, worden de kosten voor het opslaan van het activiteitenlogboek gefactureerd volgens de normale standaardopslagtarieven. Er kan slechts één logboekprofiel per abonnement zijn, maar één opslagaccount per abonnement kan worden gebruikt om het activiteitenlogboek te exporteren.
- Event Hub: er kan slechts één logboekprofiel per abonnement zijn, maar één Event Hub per abonnement kan worden gebruikt voor het exporteren van activiteitenlogboeken. Als het activiteitenlogboek naar een Event Hub wordt gestreamd, zijn de prijzen van de Standaard Event Hub van toepassing. In het activiteitenlogboek kunnen gebeurtenissen betrekking hebben op een regio of 'Globaal' zijn. Globaal betekent in wezen dat deze gebeurtenissen regioagnostiek zijn en onafhankelijk zijn van regio, in feite vallen de meeste gebeurtenissen in deze categorie. Als het activiteitenlogboekprofiel is ingesteld vanuit de portal, wordt impliciet 'Globaal' toegevoegd, samen met een andere regio die is geselecteerd in de gebruikersinterface. Wanneer u de cmdlet gebruikt, moet de locatie als 'Globaal' expliciet worden vermeld, behalve in andere regio's. Opmerking :- Als u 'Globaal' niet instelt op de locaties, wordt het merendeel van het activiteitenlogboek niet geëxporteerd. Met deze cmdlet wordt het ShouldProcess-patroon geïmplementeerd, dat wil bijvoorbeeld dat de gebruiker om bevestiging wordt gevraagd voordat de resource daadwerkelijk wordt gemaakt, gewijzigd of verwijderd.
Voorbeelden
Voorbeeld 1: Een nieuw logboekprofiel toevoegen om het activiteitenlogboek te exporteren dat overeenkomt met de locatievoorwaarde voor een opslagaccount
Add-AzLogProfile -Location "Global","West US" -Name ExportLogProfile -StorageAccountId /subscriptions/40gpe80s-9sb7-4f07-9042-b1b6a92ja9fk/resourceGroups/activitylogRG/providers/Microsoft.Storage/storageAccounts/activitylogstorageaccountEen nieuw logboekprofiel toevoegen om het activiteitenlogboek te exporteren dat overeenkomt met de locatievoorwaarde voor een opslagaccount
Voorbeeld 2
Hiermee maakt u een nieuw activiteitenlogboekprofiel. (automatisch gegenereerd)
Add-AzLogProfile -Location 'Global' -Name ExportLogProfile -RetentionInDays <Int32> -ServiceBusRuleId <String> -StorageAccountId /subscriptions/40gpe80s-9sb7-4f07-9042-b1b6a92ja9fk/resourceGroups/activitylogRG/providers/Microsoft.Storage/storageAccounts/activitylogstorageaccountParameters
-Category
Hiermee geeft u de lijst met categorieën.
| Type: | List<T>[String] |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
| Type: | SwitchParameter |
| Aliassen: | cf |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-DefaultProfile
De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure
| Type: | IAzureContextContainer |
| Aliassen: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-Location
Hiermee geeft u de locatie van het logboekprofiel. Geldige waarden: voer de onderstaande cmdlet uit om de meest recente lijst met locaties op te halen. Get-AzLocation | DisplayName selecteren
| Type: | List<T>[String] |
| Position: | Named |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-Name
Hiermee geeft u de naam van het profiel.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-RetentionInDays
Hiermee geeft u het bewaarbeleid, in dagen. Dit is het aantal dagen dat de logboeken bewaard blijven in het opgegeven opslagaccount. Als u de gegevens voor altijd wilt bewaren, stelt u dit in op 0. Als deze niet is opgegeven, wordt deze standaard ingesteld op 0. Normale standaardopslag- of Event Hub-factureringstarieven zijn van toepassing op gegevensretentie.
| Type: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-ServiceBusRuleId
Hiermee geeft u de id van de Service Bus-regel.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-StorageAccountId
Hiermee geeft u de id van het opslagaccount. Id is de volledig gekwalificeerde resource-id van het opslagaccount, bijvoorbeeld /subscriptions/40gpe80s-9sb7-4f07-9042-b1b6a92ja9fk/resourceGroups/activitylogRG/providers/Microsoft.Storage/storageAccounts/activitylogstorageaccount
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
| Type: | SwitchParameter |
| Aliassen: | wi |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
Invoerwaarden
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]]