Partager via

Add-AzLogProfile

  • Référence
Module:
Az.Monitor

Crée un profil de journal d’activité. Ce profil est utilisé pour archiver le journal d’activité dans un compte de stockage Azure ou le diffuser en continu vers un event hub Azure dans le même abonnement.

Syntaxe

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

L’applet de commande Add-AzLogProfile crée un profil de journal.

  • Compte de stockage : seul le compte de stockage standard (le compte de stockage Premium n’est pas pris en charge) est pris en charge. Il peut être de type ARM ou Classique. S’il est enregistré dans un compte de stockage, le coût de stockage du journal d’activité est facturé à des taux de stockage standard normaux. Il n’y a qu’un seul profil de journal par abonnement qui ne peut être utilisé qu’un seul compte de stockage par abonnement pour exporter le journal d’activité.
  • Event Hub : un seul profil de journal par abonnement peut être utilisé pour exporter le journal d’activité. Si le journal d’activité est diffusé en continu vers un hub d’événements, la tarification standard du hub d’événements s’applique. Dans le journal d’activité, les événements peuvent se rapporter à une région ou être « Global ». Global signifie essentiellement que ces événements sont indépendants de la région et sont indépendants de la région, en fait la majorité des événements tombent dans cette catégorie. Si le profil du journal d’activité est défini à partir du portail, il ajoute implicitement « Global » ainsi que toute autre région sélectionnée dans l’interface utilisateur. Lorsque vous utilisez l’applet de commande, l’emplacement en tant que « Global » doit être explicitement mentionné en dehors de toute autre région. Remarque :- L’échec de la définition de « Global » dans les emplacements entraîne l’exportation de la majorité du journal d’activité. Cette applet de commande implémente le modèle ShouldProcess, c’est-à-dire qu’il peut demander la confirmation de l’utilisateur avant de créer, de modifier ou de supprimer la ressource.

Exemples

Exemple 1 : Ajouter un nouveau profil de journal pour exporter le journal d’activité correspondant à la condition d’emplacement vers un compte de stockage

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

Paramètres

-Category

Spécifie la liste des catégories.

Type:List<T>[String]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Location

Spécifie l’emplacement du profil de journal. Valeurs valides : Exécutez l’applet de commande ci-dessous pour obtenir la dernière liste des emplacements. Get-AzLocation | Sélectionner DisplayName

Type:List<T>[String]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Spécifie le nom du profil.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-RetentionInDays

Spécifie la stratégie de rétention, en jours. Il s’agit du nombre de jours pendant lesquels les journaux sont conservés dans le compte de stockage spécifié. Pour conserver les données à jamais définies sur 0. S’il n’est pas spécifié, la valeur par défaut est 0. Les taux de facturation standard de stockage standard ou event Hub s’appliquent à la rétention des données.

Type:Nullable<T>[Int32]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ServiceBusRuleId

Spécifie l’ID de la règle Service Bus.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-StorageAccountId

Spécifie l’ID du compte de stockage. ID est l’ID de ressource complet du compte de stockage par exemple /subscriptions/40gpe80s-9sb7-4f07-9042-b1b6a92ja9fk/resourceGroups/activitylogRG/providers/Microsoft.Storage/storageAccounts/activitylogstorageaccounts

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

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

Sorties

PSLogProfile