Delen via


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/activitylogstorageaccount

Een 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/activitylogstorageaccount

Parameters

-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

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

Uitvoerwaarden

PSLogProfile