Partager via


az extension

Gérez et mettez à jour les extensions CLI.

Commandes

Nom Description Type Statut
az extension add

Ajouter une extension.

Core GA
az extension list

Répertoriez les extensions installées.

Core GA
az extension list-available

Répertorier les extensions disponibles publiquement.

Core GA
az extension list-versions

Répertorier les versions disponibles pour une extension.

Core GA
az extension remove

Supprimer une extension.

Core GA
az extension show

Afficher une extension.

Core GA
az extension update

Mettez à jour une extension.

Core GA

az extension add

Ajouter une extension.

Pour en savoir plus sur l’installation automatique des extensions, visitez https://aka.ms/AzExtDynamicInstall.

az extension add [--allow-preview {false, true}]
                 [--name]
                 [--pip-extra-index-urls]
                 [--pip-proxy]
                 [--source]
                 [--system]
                 [--upgrade]
                 [--version]
                 [--yes]

Exemples

Ajouter une extension par nom

az extension add --name anextension

Ajouter une extension à partir de l’URL

az extension add --source https://contoso.com/anextension-0.0.1-py2.py3-none-any.whl

Ajouter une extension à partir d’un disque local

az extension add --source ~/anextension-0.0.1-py2.py3-none-any.whl

Ajouter une extension à partir d’un disque local et utiliser le proxy pip pour les dépendances

az extension add --source ~/anextension-0.0.1-py2.py3-none-any.whl --pip-proxy https://user:pass@proxy.server:8080

Ajouter une extension au répertoire système

az extension add --name anextension --system

Ajouter une version spécifique de l’extension

az extension add --name anextension --version 1.0.0

Mettre à niveau l’extension si elle est déjà installée

az extension add --upgrade --name anextension

Paramètres facultatifs

--allow-preview

Incluez les packages en préversion pour l’installation de l’extension, le cas échéant.

valeurs acceptées: false, true
--name -n

Nom de l’extension.

--pip-extra-index-urls

Liste séparée par des espaces d’URL supplémentaires d’index de package à utiliser, qui doit pointer vers un référentiel conforme à PEP 503 (l’API de référentiel simple) ou un répertoire local du même format.

--pip-proxy

Proxy pour pip à utiliser pour les dépendances d’extension sous la forme de [user :passwd@]proxy.server :port.

--source -s

Chemin de fichier ou URL vers une extension.

--system

Utilisez un répertoire système pour l’extension.

Le chemin d’accès par défaut est le dossier azure-cli-extensions sous l’interface CLI exécutant le chemin de bibliothèque d’environnement Python, configurable par variable d’environnement AZURE_EXTENSION_SYS_DIR. Sur Windows, vous devrez peut-être ouvrir votre interpréteur de commandes en tant que Administration istrateur pour s’exécuter avec l’autorisation appropriée.

--upgrade

Mettez à jour l’extension si déjà installée, sinon installez simplement l’extension.

--version

Version spécifique d’une extension.

valeur par défaut: latest
--yes -y

Ne pas demander de confirmation.

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

Répertoriez les extensions installées.

az extension list
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 extension list-available

Répertorier les extensions disponibles publiquement.

az extension list-available [--show-details]

Exemples

Répertorier toutes les extensions disponibles publiquement

az extension list-available

Répertorier les détails d’une extension particulière

az extension list-available --show-details --query anextension

Paramètres facultatifs

--show-details -d

Afficher les données brutes de l’index d’extension.

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

Répertorier les versions disponibles pour une extension.

az extension list-versions --name

Exemples

Répertorier les versions disponibles pour une extension

az extension list-versions --name anextension

Paramètres obligatoires

--name -n

Nom de l’extension.

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 extension remove

Supprimer une extension.

az extension remove --name

Exemples

Supprimer une extension. (généré automatiquement)

az extension remove --name MyExtension

Paramètres obligatoires

--name -n

Nom de l’extension.

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

Afficher une extension.

az extension show --name

Exemples

Afficher une extension. (généré automatiquement)

az extension show --name MyExtension

Paramètres obligatoires

--name -n

Nom de l’extension.

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 extension update

Mettez à jour une extension.

az extension update --name
                    [--allow-preview {false, true}]
                    [--pip-extra-index-urls]
                    [--pip-proxy]

Exemples

Mettre à jour une extension par nom

az extension update --name anextension

Mettre à jour une extension par nom et utiliser le proxy pip pour les dépendances

az extension update --name anextension --pip-proxy https://user:pass@proxy.server:8080

Paramètres obligatoires

--name -n

Nom de l’extension.

Paramètres facultatifs

--allow-preview

Incluez les packages en préversion pour l’installation de l’extension, le cas échéant.

valeurs acceptées: false, true
--pip-extra-index-urls

Liste séparée par des espaces d’URL supplémentaires d’index de package à utiliser, qui doit pointer vers un référentiel conforme à PEP 503 (l’API de référentiel simple) ou un répertoire local du même format.

--pip-proxy

Proxy pour pip à utiliser pour les dépendances d’extension sous la forme de [user :passwd@]proxy.server :port.

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.