Partager via

az maintenance configuration

Note

Cette référence fait partie de l’extension de maintenance pour Azure CLI (version 2.67.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une az maintenance configuration commande. Apprenez-en davantage sur les extensions.

Gérer la configuration de la maintenance avec la maintenance.

Commandes

Nom Description Type État
az maintenance configuration create

Créez un enregistrement de configuration.

 Extension GA
az maintenance configuration delete

Supprimer l’enregistrement de configuration.

 Extension GA
az maintenance configuration list

Répertorier les enregistrements de configuration au sein d’un abonnement et d’un groupe de ressources.

 Extension GA
az maintenance configuration show

Obtenir l’enregistrement de configuration.

 Extension GA
az maintenance configuration update

Mettre à jour l’enregistrement de configuration.

 Extension GA

az maintenance configuration create

Créez un enregistrement de configuration.

az maintenance configuration create --name --resource-name
                                    --resource-group
                                    [--duration --maintenance-window-duration]
                                    [--expiration-date-time --maintenance-window-expiration-date-time]
                                    [--extension-properties]
                                    [--install-patches-linux-parameters --linux-parameters]
                                    [--install-patches-windows-parameters --windows-parameters]
                                    [--location]
                                    [--maintenance-scope {Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance}]
                                    [--maintenance-window-recur-every --recur-every]
                                    [--maintenance-window-start-date-time --start-date-time]
                                    [--maintenance-window-time-zone --time-zone]
                                    [--namespace]
                                    [--reboot-setting {Always, IfRequired, Never}]
                                    [--tags]
                                    [--visibility {Custom, Public}]

Exemples

MaintenanceConfigurations_CreateOrUpdateForResource

az maintenance configuration create --location "westus2" --maintenance-scope "OSImage" --maintenance-window-duration "05:00" --maintenance-window-expiration-date-time "9999-12-31 00:00" --maintenance-window-recur-every "Day" --maintenance-window-start-date-time "2020-04-30 08:00" --maintenance-window-time-zone "Pacific Standard Time" --namespace "Microsoft.Maintenance" --visibility "Custom" --resource-group "examplerg" --resource-name "configuration1"

Paramètres obligatoires

--name --resource-name -n

Nom de la configuration de maintenance.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--duration --maintenance-window-duration

Durée de la fenêtre de maintenance au format HH :mm. Si elle n’est pas fournie, la valeur par défaut est utilisée en fonction de l’étendue de maintenance fournie. Exemple : 05:00.

Propriété Valeur
Groupe de paramètres: MaintenanceWindow Arguments
--expiration-date-time --maintenance-window-expiration-date-time

Date d’expiration effective de la fenêtre de maintenance au format aaaa-MM-DD hh :mm. La fenêtre sera créée dans le fuseau horaire fourni et ajustée aux économies d’été en fonction de ce fuseau horaire. La date d’expiration doit être définie sur une date ultérieure. S’il n’est pas fourni, il est défini sur la date maximale de datetime 9999-12-31 23:59:59.

Propriété Valeur
Groupe de paramètres: MaintenanceWindow Arguments
--extension-properties

Obtient ou définit l’extensionProperties de la syntaxe abrégée de support maintenanceConfiguration, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--install-patches-linux-parameters --linux-parameters

Paramètres d’entrée spécifiques à la mise à jour corrective de la machine Linux. Pour les machines Windows, ne passez pas cette propriété. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: InstallPatches Arguments
--install-patches-windows-parameters --windows-parameters

Paramètres d’entrée spécifiques à la mise à jour corrective d’une machine Windows. Pour les machines Linux, ne transmettez pas cette propriété. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: InstallPatches Arguments
--location -l

Obtient ou définit l’emplacement de la ressource.

Propriété Valeur
Groupe de paramètres: Configuration Arguments
--maintenance-scope

Obtient ou définit maintenanceScope de la configuration.

Propriété Valeur
Groupe de paramètres: Properties Arguments
Valeurs acceptées: Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance
--maintenance-window-recur-every --recur-every

Fréquence à laquelle une fenêtre maintenance est censée se reproduire. Le taux peut être exprimé sous forme de planifications quotidiennes, hebdomadaires ou mensuelles. La planification quotidienne est mise en forme sous forme de récurrité : [Fréquence en tant qu’entier]['Jour(s)']. Si aucune fréquence n’est fournie, la fréquence par défaut est 1. Les exemples de planification quotidienne sont recurEvery : Day, recurEvery : 3Days. La planification hebdomadaire est mise en forme sous forme de récurrité : [Fréquence en tant qu’entier]['Semaine(s)'] [Liste séparée par des virgules facultatives du lundi au dimanche]. Les exemples de planification hebdomadaire sont recurEvery : 3Weeks, recurEvery : Week Saturday,Sunday. Les planifications mensuelles sont mises en forme comme [Fréquence sous forme d’entier]['Mois(s)'] [Liste séparée par des virgules des jours du mois] ou [Fréquence sous forme d’entier]['Mois(s)'] [Semaine du mois (Premier, Deuxième, Troisième, Quatrième, Last)] [Lundi-dimanche en semaine] [Décalage facultatif (Non. jours)]. La valeur de décalage doit être comprise entre -6 et 6 inclus. Les exemples de planification mensuelle sont recurEvery : Month, recurEvery : 2Months, recurEvery : Month day23,day24, recurEvery : Month Last Sunday, recurEvery : Month Fourth Monday, recurEvery : Month Last Sunday Offset-3, recurEvery : Month Third Sunday Offset6.

Propriété Valeur
Groupe de paramètres: MaintenanceWindow Arguments
--maintenance-window-start-date-time --start-date-time

Date de début effective de la fenêtre de maintenance au format aaaa-MM-DD hh :mm. La date de début peut être définie sur la date actuelle ou la date ultérieure. La fenêtre sera créée dans le fuseau horaire fourni et ajustée aux économies d’été en fonction de ce fuseau horaire.

Propriété Valeur
Groupe de paramètres: MaintenanceWindow Arguments
--maintenance-window-time-zone --time-zone

Nom du fuseau horaire. Vous pouvez obtenir la liste des fuseaux horaires en exécutant [System.TimeZoneInfo] ::GetSystemTimeZones() dans PowerShell. Exemple : Heure standard du Pacifique, UTC, W. Europe Standard Time, Corée Standard Time, Cen. Heure standard de l’Australie.

Propriété Valeur
Groupe de paramètres: MaintenanceWindow Arguments
--namespace

Obtient ou définit l’espace de noms de la ressource.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--reboot-setting

Préférence de redémarrage possible définie par l’utilisateur en fonction de laquelle il serait décidé de redémarrer l’ordinateur ou non une fois l’opération corrective terminée.

Propriété Valeur
Groupe de paramètres: InstallPatches Arguments
Valeurs acceptées: Always, IfRequired, Never
--tags

Obtient ou définit des balises de la syntaxe abrégée de la ressource, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: Configuration Arguments
--visibility

Obtient ou définit la visibilité de la configuration. La valeur par défaut est « Custom ».

Propriété Valeur
Groupe de paramètres: Properties Arguments
Valeurs acceptées: Custom, Public
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az maintenance configuration delete

Supprimer l’enregistrement de configuration.

az maintenance configuration delete [--ids]
                                    [--name --resource-name]
                                    [--resource-group]
                                    [--subscription]
                                    [--yes]

Exemples

MaintenanceConfigurations_DeleteForResource

az maintenance configuration delete --resource-group "examplerg" --resource-name "example1"

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--name --resource-name -n

Nom de la configuration de maintenance.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--yes -y

N’invitez pas à confirmer.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az maintenance configuration list

Répertorier les enregistrements de configuration au sein d’un abonnement et d’un groupe de ressources.

az maintenance configuration list [--resource-group]

Exemples

MaintenanceConfigurations_List

az maintenance configuration list

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az maintenance configuration show

Obtenir l’enregistrement de configuration.

az maintenance configuration show [--ids]
                                  [--name --resource-name]
                                  [--resource-group]
                                  [--subscription]

Exemples

MaintenanceConfigurations_GetForResource

az maintenance configuration show --resource-group "examplerg" --resource-name "configuration1"

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--name --resource-name -n

Nom de la configuration de maintenance.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az maintenance configuration update

Mettre à jour l’enregistrement de configuration.

az maintenance configuration update [--duration --maintenance-window-duration]
                                    [--expiration-date-time --maintenance-window-expiration-date-time]
                                    [--extension-properties]
                                    [--ids]
                                    [--install-patches-linux-parameters --linux-parameters]
                                    [--install-patches-windows-parameters --windows-parameters]
                                    [--location]
                                    [--maintenance-scope {Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance}]
                                    [--maintenance-window-recur-every --recur-every]
                                    [--maintenance-window-start-date-time --start-date-time]
                                    [--maintenance-window-time-zone --time-zone]
                                    [--name --resource-name]
                                    [--namespace]
                                    [--reboot-setting {Always, IfRequired, Never}]
                                    [--resource-group]
                                    [--subscription]
                                    [--tags]
                                    [--visibility {Custom, Public}]

Exemples

MaintenanceConfigurations_UpdateForResource

az maintenance configuration update --location "westus2" --maintenance-scope "OSImage" --maintenance-window-duration "05:00" --maintenance-window-expiration-date-time "9999-12-31 00:00" --maintenance-window-recur-every "Month Third Sunday" --maintenance-window-start-date-time "2020-04-30 08:00" --maintenance-window-time-zone "Pacific Standard Time" --namespace "Microsoft.Maintenance" --visibility "Custom" --resource-group "examplerg" --resource-name "configuration1"

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--duration --maintenance-window-duration

Durée de la fenêtre de maintenance au format HH :mm. Si elle n’est pas fournie, la valeur par défaut est utilisée en fonction de l’étendue de maintenance fournie. Exemple : 05:00.

Propriété Valeur
Groupe de paramètres: MaintenanceWindow Arguments
--expiration-date-time --maintenance-window-expiration-date-time

Date d’expiration effective de la fenêtre de maintenance au format aaaa-MM-DD hh :mm. La fenêtre sera créée dans le fuseau horaire fourni et ajustée aux économies d’été en fonction de ce fuseau horaire. La date d’expiration doit être définie sur une date ultérieure. S’il n’est pas fourni, il est défini sur la date maximale de datetime 9999-12-31 23:59:59.

Propriété Valeur
Groupe de paramètres: MaintenanceWindow Arguments
--extension-properties

Obtient ou définit l’extensionProperties de la syntaxe abrégée de support maintenanceConfiguration, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--install-patches-linux-parameters --linux-parameters

Paramètres d’entrée spécifiques à la mise à jour corrective de la machine Linux. Pour les machines Windows, ne passez pas cette propriété. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: InstallPatches Arguments
--install-patches-windows-parameters --windows-parameters

Paramètres d’entrée spécifiques à la mise à jour corrective d’une machine Windows. Pour les machines Linux, ne transmettez pas cette propriété. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: InstallPatches Arguments
--location -l

Obtient ou définit l’emplacement de la ressource.

Propriété Valeur
Groupe de paramètres: Configuration Arguments
--maintenance-scope

Obtient ou définit maintenanceScope de la configuration.

Propriété Valeur
Groupe de paramètres: Properties Arguments
Valeurs acceptées: Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance
--maintenance-window-recur-every --recur-every

Fréquence à laquelle une fenêtre maintenance est censée se reproduire. Le taux peut être exprimé sous forme de planifications quotidiennes, hebdomadaires ou mensuelles. La planification quotidienne est mise en forme sous forme de récurrité : [Fréquence en tant qu’entier]['Jour(s)']. Si aucune fréquence n’est fournie, la fréquence par défaut est 1. Les exemples de planification quotidienne sont recurEvery : Day, recurEvery : 3Days. La planification hebdomadaire est mise en forme sous forme de récurrité : [Fréquence en tant qu’entier]['Semaine(s)'] [Liste séparée par des virgules facultatives du lundi au dimanche]. Les exemples de planification hebdomadaire sont recurEvery : 3Weeks, recurEvery : Week Saturday,Sunday. Les planifications mensuelles sont mises en forme comme [Fréquence sous forme d’entier]['Mois(s)'] [Liste séparée par des virgules des jours du mois] ou [Fréquence sous forme d’entier]['Mois(s)'] [Semaine du mois (Premier, Deuxième, Troisième, Quatrième, Last)] [Lundi-dimanche en semaine] [Décalage facultatif (Non. jours)]. La valeur de décalage doit être comprise entre -6 et 6 inclus. Les exemples de planification mensuelle sont recurEvery : Month, recurEvery : 2Months, recurEvery : Month day23,day24, recurEvery : Month Last Sunday, recurEvery : Month Fourth Monday, recurEvery : Month Last Sunday Offset-3, recurEvery : Month Third Sunday Offset6.

Propriété Valeur
Groupe de paramètres: MaintenanceWindow Arguments
--maintenance-window-start-date-time --start-date-time

Date de début effective de la fenêtre de maintenance au format aaaa-MM-DD hh :mm. La date de début peut être définie sur la date actuelle ou la date ultérieure. La fenêtre sera créée dans le fuseau horaire fourni et ajustée aux économies d’été en fonction de ce fuseau horaire.

Propriété Valeur
Groupe de paramètres: MaintenanceWindow Arguments
--maintenance-window-time-zone --time-zone

Nom du fuseau horaire. Vous pouvez obtenir la liste des fuseaux horaires en exécutant [System.TimeZoneInfo] ::GetSystemTimeZones() dans PowerShell. Exemple : Heure standard du Pacifique, UTC, W. Europe Standard Time, Corée Standard Time, Cen. Heure standard de l’Australie.

Propriété Valeur
Groupe de paramètres: MaintenanceWindow Arguments
--name --resource-name -n

Nom de la configuration de maintenance.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--namespace

Obtient ou définit l’espace de noms de la ressource.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--reboot-setting

Préférence de redémarrage possible définie par l’utilisateur en fonction de laquelle il serait décidé de redémarrer l’ordinateur ou non une fois l’opération corrective terminée.

Propriété Valeur
Groupe de paramètres: InstallPatches Arguments
Valeurs acceptées: Always, IfRequired, Never
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--tags

Obtient ou définit des balises de la syntaxe abrégée de la ressource, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: Configuration Arguments
--visibility

Obtient ou définit la visibilité de la configuration. La valeur par défaut est « Custom ».

Propriété Valeur
Groupe de paramètres: Properties Arguments
Valeurs acceptées: Custom, Public
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False