Add-AzLogProfile
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/activitylogstorageaccountAjouter un nouveau profil de journal pour exporter le journal d’activité correspondant à la condition d’emplacement vers un compte de stockage
Exemple 2
Crée un profil de journal d’activité. (généré automatiquement)
Add-AzLogProfile -Location 'Global' -Name ExportLogProfile -RetentionInDays <Int32> -ServiceBusRuleId <String> -StorageAccountId /subscriptions/40gpe80s-9sb7-4f07-9042-b1b6a92ja9fk/resourceGroups/activitylogRG/providers/Microsoft.Storage/storageAccounts/activitylogstorageaccountParamè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 la commande cmdlet.
| 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
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]]
