Partager via

az vmss extension

Gérer les extensions sur un groupe de machines virtuelles identiques.

Commandes

Nom Description Type État
az vmss extension delete

Supprimez une extension d’un vmSS.

 Core GA
az vmss extension image

Recherchez les extensions de machine virtuelle disponibles pour un abonnement et une région.

 Core GA
az vmss extension image list

Répertoriez les informations sur les extensions disponibles.

 Core GA
az vmss extension image list-names

Répertorier les types d’images d’extension de machine virtuelle.

 Core GA
az vmss extension image list-versions

Répertorier les versions d’image d’extension de machine virtuelle.

 Core GA
az vmss extension image show

Obtenir une image d’extension de machine virtuelle.

 Core GA
az vmss extension list

Répertorier les extensions associées à un vmSS.

 Core GA
az vmss extension set

Ajoutez une extension à une machine virtuelle ou mettez à jour une extension existante.

 Core GA
az vmss extension show

Affichez les détails d’une extension VMSS.

 Core GA
az vmss extension upgrade

Mettez à niveau toutes les extensions pour toutes les instances VMSS vers la dernière version.

 Core GA

az vmss extension delete

Modifier

Supprimez une extension d’un vmSS.

az vmss extension delete --name
                         --resource-group
                         --vmss-name
                         [--no-wait]

Exemples

Supprimez une extension d’un vmSS. (autogenerated)

az vmss extension delete --name MyExtension --resource-group MyResourceGroup --vmss-name MyVmss

Paramètres obligatoires

--name -n

Nom de l’extension.

--resource-group -g

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

--vmss-name

Nom du groupe identique. Vous pouvez configurer la valeur par défaut à l’aide az configure --defaults vmss=<name>de .

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.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

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/.

--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 vmss extension list

Modifier

Répertorier les extensions associées à un vmSS.

az vmss extension list --resource-group
                       --vmss-name

Exemples

Répertorier les extensions associées à un vmSS. (autogenerated)

az vmss extension list --resource-group MyResourceGroup --vmss-name MyVmss

Paramètres obligatoires

--resource-group -g

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

--vmss-name

Nom du groupe identique. Vous pouvez configurer la valeur par défaut à l’aide az configure --defaults vmss=<name>de .

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 vmss extension set

Modifier

Ajoutez une extension à une machine virtuelle ou mettez à jour une extension existante.

Obtenir les détails de l’extension à partir de az vmss extension image list.

az vmss extension set --name
                      --publisher
                      --resource-group
                      --vmss-name
                      [--enable-auto-upgrade {false, true}]
                      [--extension-instance-name]
                      [--force-update]
                      [--no-auto-upgrade {false, true}]
                      [--no-auto-upgrade-minor-version {false, true}]
                      [--no-wait]
                      [--protected-settings]
                      [--provision-after-extensions]
                      [--settings]
                      [--version]

Exemples

Définissez une extension qui dépend de deux extensions définies précédemment. Autrement dit, lorsqu’une instance VMSS est créée ou réimagenée, l’extension customScript est provisionnée uniquement après toutes les extensions dont elle dépend a été provisionnée. L’extension n’a pas besoin de dépendre des autres extensions pour les configurations préalables.

az vmss extension set --vmss-name my-vmss --name customScript --resource-group my-group \
    --version 2.0 --publisher Microsoft.Azure.Extensions \
    --provision-after-extensions NetworkWatcherAgentLinux VMAccessForLinux  \
    --settings '{"commandToExecute": "echo testing"}'

Ajoutez une extension et activez la mise à niveau automatique par la plateforme s’il existe une version plus récente de l’extension disponible.

az vmss extension set -n extName --publisher publisher --vmss-name my-vmss -g my-group \ --enable-auto-upgrade true

Paramètres obligatoires

--name -n

Nom de l’extension.

Propriété Valeur
Valeur de: az vm extension image list
--publisher

Nom de l’éditeur d’extension.

--resource-group -g

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

--vmss-name

Nom du groupe identique. Vous pouvez configurer la valeur par défaut à l’aide az configure --defaults vmss=<name>de .

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.

--enable-auto-upgrade

Indiquez que l’extension doit être automatiquement mise à niveau par la plateforme s’il existe une version plus récente de l’extension disponible.

Propriété Valeur
Valeurs acceptées: false, true
--extension-instance-name

Nom de l’instance d’extension, qui peut être personnalisé. Valeur par défaut : nom de l’extension.

--force-update

Forcez la mise à jour même si la configuration de l’extension n’a pas changé.

Propriété Valeur
Valeur par défaut: False
--no-auto-upgrade
Déprécié

L’option « --no-auto-upgrade » a été déconseillée et sera supprimée dans une prochaine version. Utilisez plutôt « --no-auto-upgrade-minor-version ».

Si elle est définie, le service d’extension ne sélectionne pas ou ne met pas automatiquement à niveau vers la dernière version mineure, même si l’extension est redéployée.

Propriété Valeur
Valeur par défaut: False
Valeurs acceptées: false, true
--no-auto-upgrade-minor-version

Si elle est définie, le service d’extension ne sélectionne pas ou ne met pas automatiquement à niveau vers la dernière version mineure, même si l’extension est redéployée.

Propriété Valeur
Valeur par défaut: False
Valeurs acceptées: false, true
--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--protected-settings

Paramètres protégés au format JSON pour les informations sensibles telles que les informations d’identification. Un chemin d’accès au fichier JSON est également accepté.

--provision-after-extensions

Liste séparée par l’espace des noms d’extensions après laquelle cette extension doit être provisionnée. Ces extensions doivent déjà être définies sur la machine virtuelle.

--settings

Paramètres d’extension au format JSON. Un chemin d’accès au fichier JSON est également accepté.

--version

Version de l’extension. Pour épingler la version de l’extension à cette valeur, spécifiez --no-auto-upgrade-minor-version.

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 vmss extension show

Modifier

Affichez les détails d’une extension VMSS.

az vmss extension show --name
                       --resource-group
                       --vmss-name

Exemples

Affichez les détails d’une extension VMSS. (autogenerated)

az vmss extension show --name MyExtension --resource-group MyResourceGroup --vmss-name MyVmss

Paramètres obligatoires

--name -n

Nom de l’extension.

--resource-group -g

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

--vmss-name

Nom du groupe identique. Vous pouvez configurer la valeur par défaut à l’aide az configure --defaults vmss=<name>de .

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 vmss extension upgrade

Modifier

Mettez à niveau toutes les extensions pour toutes les instances VMSS vers la dernière version.

az vmss extension upgrade [--ids]
                          [--name]
                          [--no-wait]
                          [--resource-group]
                          [--subscription]

Exemples

Mettez à niveau toutes les extensions vers la dernière version.

az vmss extension upgrade -g MyResourceGroup -n MyVmss

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

Nom du groupe identique. Vous pouvez configurer la valeur par défaut à l’aide az configure --defaults vmss=<name>de .

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

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--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