Partager via

az vmss extension

  • Référence

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. (généré automatiquement)

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 en utilisant 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

--no-wait

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

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

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

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

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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. (généré automatiquement)

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 en utilisant 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

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

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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.

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 en utilisant 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

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

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

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.

Valeurs acceptées: false, true
Valeur par défaut: False
--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.

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

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

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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

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

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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. (généré automatiquement)

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 en utilisant 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

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

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). 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 ».

--name -n

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

--no-wait

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

Valeur par défaut: False
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subscription

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

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

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

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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