Set-AzDiagnosticSetting
Définit les paramètres des journaux et des métriques pour la ressource.
Syntax
Set-AzDiagnosticSetting
-ResourceId <String>
[-Name <String>]
[-StorageAccountId <String>]
[-ServiceBusRuleId <String>]
[-EventHubName <String>]
[-EventHubAuthorizationRuleId <String>]
[-Enabled <Boolean>]
[-Category <System.Collections.Generic.List`1[System.String]>]
[-MetricCategory <System.Collections.Generic.List`1[System.String]>]
[-Timegrain <System.Collections.Generic.List`1[System.String]>]
[-RetentionEnabled <Boolean>]
[-WorkspaceId <String>]
[-ExportToResourceSpecific]
[-RetentionInDays <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzDiagnosticSetting
-InputObject <PSServiceDiagnosticSettings>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Set-AzDiagnosticSetting active ou désactive chaque fois que le grain et la catégorie de journal pour la ressource particulière. Les journaux et les métriques sont stockés dans le compte de stockage spécifié. 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 : Activer toutes les métriques et tous les journaux d’activité d’une ressource
PS C:\>Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $True
Cette commande active toutes les métriques et journaux disponibles pour Resource01.
Exemple 2 : Désactiver toutes les métriques et tous les journaux
PS C:\>Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $False
Cette commande désactive toutes les métriques et journaux disponibles pour la ressource Resource01.
Exemple 3 : Activer/désactiver plusieurs catégories de métriques
PS C:\>Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $False -MetricCategory MetricCategory1,MetricCategory2
StorageAccountId : <storageAccountId>
StorageAccountName : <storageAccountName>
Metrics
Enabled : False
Category : MetricCategory1
Timegrain : PT1M
Enabled : False
Category : MetricCategory2
Timegrain : PT1H
Enabled : True
Category : MetricCategory3
Timegrain : PT1H
Logs
Enabled : True
Category : Category1
Enabled : True
Category : Category2
Enabled : True
Category : Category3
Enabled : False
Category : Category4
Cette commande désactive les catégories de métriques appelées Category1 et Category2. Toutes les autres catégories restent les mêmes.
Exemple 4 : Activer/désactiver plusieurs catégories de journaux
PS C:\>Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $True -Category Category1,Category2
StorageAccountId : <storageAccountId>
StorageAccountName : <storageAccountName>
Metrics
Enabled : False
Category : MetricCategory1
Timegrain : PT1M
Enabled : False
Category : MetricCategory2
Timegrain : PT1H
Enabled : True
Category : MetricCategory3
Timegrain : PT1H
Logs
Enabled : True
Category : Category1
Enabled : True
Category : Category2
Enabled : True
Category : Category3
Enabled : False
Category : Category4
Cette commande active Category1 et Category2. Toutes les autres catégories de métriques et de journaux restent identiques.
Exemple 4 : Activer un grain de temps et plusieurs catégories
PS C:\>Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $True -Category Category1,Category2 -Timegrain PT1M
Cette commande active uniquement Category1, Category2 et time grain PT1M. Tous les autres grains et catégories de temps sont inchangés.
Exemple 5 : Utilisation du pipeline
PS C:\>Get-AzDiagnosticSetting -ResourceId "Resource01" | Set-AzDiagnosticSetting -Enabled $True -Category Category1,Category2
Cette commande utilise le pipeline PowerShell pour définir (aucune modification apportée) un paramètre de diagnostic.
Paramètres
-Category
Spécifie la liste des catégories de journaux à activer ou désactiver, en fonction de la valeur Enabled. Si aucune catégorie n’est spécifiée, cette commande fonctionne sur toutes les catégories prises en charge.
Type: | List<T>[String] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Enabled
Indique s’il faut activer les diagnostics. Spécifiez $True pour activer les diagnostics ou $False pour désactiver les diagnostics.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EventHubAuthorizationRuleId
ID de règle d’autorisation event Hub
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EventHubName
Nom du hub d’événements
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ExportToResourceSpecific
Indicateur indiquant que l’exportation vers LA doit être effectuée vers une table spécifique à une ressource, une table de schémas dédiée ou fixe, par opposition à la table de schéma dynamique par défaut appelée AzureDiagnostics.
Cet argument est effectif uniquement lorsque l’argument -workspaceId est également donné.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InputObject
Objet d’entrée (possible à partir du pipeline.) Le nom et resourceId seront extraits de cet objet.
Type: | PSServiceDiagnosticSettings |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MetricCategory
Liste des catégories de métriques. Si aucune catégorie n’est spécifiée, cette commande fonctionne sur toutes les catégories prises en charge.
Type: | List<T>[String] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Nom du paramètre de diagnostic. La valeur par défaut est service.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceId
Spécifie l’ID de la ressource.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RetentionEnabled
Indique si la rétention des informations de diagnostic est activée.
Type: | Nullable<T>[Boolean] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RetentionInDays
Spécifie la stratégie de rétention, en jours.
Type: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServiceBusRuleId
ID de règle Service Bus.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageAccountId
Spécifie l’ID du compte de stockage dans lequel enregistrer les données.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Timegrain
Spécifie les grains de temps à activer ou désactiver pour les métriques, en fonction de la valeur Enabled. Si vous ne spécifiez pas de grain de temps, cette commande fonctionne sur tous les grains de temps disponibles.
Type: | List<T>[String] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WorkspaceId
ID de ressource de l’espace de travail Log Analytics pour envoyer des journaux/métriques à
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Entrées
List<T>[[System.String, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]
Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]
Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]