Set-AzDiagnosticSetting
Définit les paramètres des journaux et des métriques pour la ressource.
Syntaxe
OldSetDiagnosticSetting (Par défaut)
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>]
NewSetDiagnosticSetting
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.
Propriétés du paramètre
Type: List<T> [ String ]
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
OldSetDiagnosticSetting
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: False
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
Propriétés du paramètre
Type: SwitchParameter
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False Alias: cf
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure
Propriétés du paramètre
Type: IAzureContextContainer
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False Alias: AzContext, AzureRmContext, AzureCredential
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-Enabled
Indique s’il faut activer les diagnostics.
Spécifiez $True pour activer les diagnostics ou $False pour désactiver les diagnostics.
Propriétés du paramètre
Type: Boolean
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
OldSetDiagnosticSetting
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: False
-EventHubAuthorizationRuleId
ID de règle d’autorisation event Hub
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
OldSetDiagnosticSetting
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: False
-EventHubName
Nom du hub d’événements
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
OldSetDiagnosticSetting
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: 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é.
Propriétés du paramètre
Type: SwitchParameter
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
OldSetDiagnosticSetting
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: False
Objet d’entrée (possible à partir du pipeline.) Le nom et resourceId seront extraits de cet objet.
NewSetDiagnosticSetting
Position: Named Obligatoire: True Valeur du pipeline: True Valeur du pipeline par nom de propriété: False Valeur des arguments restants: 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.
Propriétés du paramètre
Type: List<T> [ String ]
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
OldSetDiagnosticSetting
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: False
-Name
Nom du paramètre de diagnostic. La valeur par défaut est service .
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
OldSetDiagnosticSetting
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: False
-ResourceId
Spécifie l’ID de la ressource.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
OldSetDiagnosticSetting
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: False
-RetentionEnabled
Indique si la rétention des informations de diagnostic est activée.
Propriétés du paramètre
Type: Nullable<T> [ Boolean ]
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
OldSetDiagnosticSetting
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: False
-RetentionInDays
Spécifie la stratégie de rétention, en jours.
Propriétés du paramètre
Type: Nullable<T> [ Int32 ]
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
OldSetDiagnosticSetting
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: False
-ServiceBusRuleId
ID de règle Service Bus.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
OldSetDiagnosticSetting
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: False
-StorageAccountId
Spécifie l’ID du compte de stockage dans lequel enregistrer les données.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
OldSetDiagnosticSetting
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: 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.
Propriétés du paramètre
Type: List<T> [ String ]
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
OldSetDiagnosticSetting
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: False
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.
Propriétés du paramètre
Type: SwitchParameter
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False Alias: Wi
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-WorkspaceId
ID de ressource de l’espace de travail Log Analytics pour envoyer des journaux/métriques à
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
OldSetDiagnosticSetting
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: False
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters .
Sorties