az connectedmachine extension

Note

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

Gérer une extension de machine virtuelle sur un serveur Azure Arc-Enabled.

Commandes

Nom	Description	Type	État
az connectedmachine extension create	Créez une opération pour créer ou mettre à jour l’extension.	Extension	GA
az connectedmachine extension delete	Opération de suppression pour supprimer l’extension.	Extension	GA
az connectedmachine extension image	Gérer les métadonnées d’extension de machine virtuelle disponibles pour les serveurs Azure Arc-Enabled.	Extension	GA
az connectedmachine extension image list	Répertorie toutes les versions d’extension basées sur l’emplacement, l’éditeur, l’extensionType.	Extension	GA
az connectedmachine extension image show	Obtenez des métadonnées d’extension en fonction de l’emplacement, de l’éditeur, de l’extensionType et de la version.	Extension	GA
az connectedmachine extension list	Obtenez toutes les extensions d’une machine non-Azure.	Extension	GA
az connectedmachine extension show	Obtenir l’opération pour obtenir l’extension.	Extension	GA
az connectedmachine extension update	Opération de mise à jour pour créer ou mettre à jour l’extension.	Extension	GA
az connectedmachine extension wait	Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition soit remplie.	Extension	GA

az connectedmachine extension create

Créez une opération pour créer ou mettre à jour l’extension.

az connectedmachine extension create --extension-name --name
                                     --machine-name
                                     --resource-group
                                     [--auto-upgrade-min --auto-upgrade-minor-version {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--enable-auto-upgrade --enable-automatic-upgrade {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--force-update-tag]
                                     [--instance-view]
                                     [--location]
                                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--protected-settings]
                                     [--publisher]
                                     [--settings]
                                     [--tags]
                                     [--type]
                                     [--type-handler-version]

Exemples

exemple de commande pour la création d’extension

az connectedmachine extension create --resource-group myResourceGroup --machine-name myMachine --extension-name CustomScriptExtension --location eastus2euap --publisher Microsoft.Compute --type-handler-version 1.10 --type CustomScriptExtension --settings "{commandToExecute:'powershell.exe -c "Get-Process | Where-Object { $_.CPU -gt 10000 }"'}"

Paramètres obligatoires

--extension-name --name -n

Nom de l’extension de machine.

--machine-name

Nom de l’ordinateur sur lequel l’extension doit être créée ou mise à jour.

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

--auto-upgrade-min --auto-upgrade-minor-version

Indique si l’extension doit utiliser une version mineure plus récente si elle est disponible au moment du déploiement. Une fois déployée, toutefois, l’extension ne met pas à niveau les versions mineures, sauf si elle est redéployée, même avec cette propriété définie sur true.

Propriété	Valeur
Groupe de paramètres:	Properties Arguments
Valeurs acceptées:	0, 1, f, false, n, no, t, true, y, yes

--enable-auto-upgrade --enable-automatic-upgrade

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

Propriété	Valeur
Groupe de paramètres:	Properties Arguments
Valeurs acceptées:	0, 1, f, false, n, no, t, true, y, yes

--force-update-tag

Comment le gestionnaire d’extensions doit être forcé de mettre à jour même si la configuration de l’extension n’a pas changé.

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

--instance-view

Vue de l’instance d’extension de machine. 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:	Properties Arguments

--location -l

Emplacement géographique où la ressource se trouve quand elle n’est pas spécifiée, l’emplacement du groupe de ressources sera utilisé.

Propriété	Valeur
Groupe de paramètres:	ExtensionParameters Arguments

--no-wait

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

Propriété	Valeur
Valeurs acceptées:	0, 1, f, false, n, no, t, true, y, yes

--protected-settings

L’extension peut contenir protectedSettings ou protectedSettingsFromKeyVault ou aucun paramètre protégé du tout. 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:	Properties Arguments

--publisher

Nom du serveur de publication du gestionnaire d’extensions.

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

--settings

Paramètres publics au format Json pour l’extension. 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:	Properties Arguments

--tags

Balises de ressource. 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:	ExtensionParameters Arguments

--type

Spécifie le type de l’extension ; un exemple est « CustomScriptExtension ».

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

--type-handler-version

Spécifie la version du gestionnaire de scripts.

Propriété	Valeur
Groupe de paramètres:	Properties 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/.

--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 connectedmachine extension delete

Opération de suppression pour supprimer l’extension.

az connectedmachine extension delete [--extension-name --name]
                                     [--ids]
                                     [--machine-name]
                                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--resource-group]
                                     [--subscription]
                                     [--yes]

Exemples

exemple de commande pour la suppression d’extension

az connectedmachine extension delete --resource-group myResourceGroup --machine-name myMachine --extension-name MMA

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.

--extension-name --name -n

Nom de l’extension de machine.

Propriété	Valeur
Groupe de paramètres:	Resource Id 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

--machine-name

Nom de l’ordinateur sur lequel l’extension doit être supprimée.

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
Valeurs acceptées:	0, 1, f, false, n, no, t, true, y, yes

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

Obtenez toutes les extensions d’une machine non-Azure.

az connectedmachine extension list --machine-name
                                   --resource-group
                                   [--expand]
                                   [--max-items]
                                   [--next-token]

Exemples

Exemple de commande pour la liste d’extensions

az connectedmachine extension list --machine-name myMachine --resource-group myResourceGroup

Paramètres obligatoires

--machine-name

Nom de l’ordinateur contenant 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>.

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.

--expand

Expression de développement à appliquer à l’opération.

--max-items

Nombre total d’éléments à retourner dans la sortie de la commande. Si le nombre total d’éléments disponibles est supérieur à la valeur spécifiée, un jeton est fourni dans la sortie de la commande. Pour reprendre la pagination, fournissez la valeur du jeton dans --next-token argument d’une commande suivante.

Propriété	Valeur
Groupe de paramètres:	Pagination Arguments

--next-token

Jeton pour spécifier où commencer la pagination. Il s’agit de la valeur du jeton d’une réponse tronquée précédemment.

Propriété	Valeur
Groupe de paramètres:	Pagination 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/.

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

Obtenir l’opération pour obtenir l’extension.

az connectedmachine extension show [--extension-name --name]
                                   [--ids]
                                   [--machine-name]
                                   [--resource-group]
                                   [--subscription]

Exemples

exemple de commande pour l’extension show

az connectedmachine extension show --resource-group myResourceGroup --machine-name myMachine --extension-name CustomScriptExtension

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.

--extension-name --name -n

Nom de l’extension de machine.

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

--ids

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

--machine-name

Nom de l’ordinateur contenant l’extension.

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

Opération de mise à jour pour créer ou mettre à jour l’extension.

az connectedmachine extension update [--auto-upgrade-min --auto-upgrade-minor-version {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--enable-auto-upgrade --enable-automatic-upgrade {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--extension-name --name]
                                     [--force-update-tag]
                                     [--ids]
                                     [--machine-name]
                                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--protected-settings]
                                     [--publisher]
                                     [--resource-group]
                                     [--settings]
                                     [--subscription]
                                     [--tags]
                                     [--type]
                                     [--type-handler-version]

Exemples

exemple de commande pour la mise à jour de l’extension

az connectedmachine extension update --name CustomScriptExtension --type CustomScriptExtension --publisher Microsoft.Compute --type-handler-version 1.10 --machine-name myMachine --resource-group myResourceGroup

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.

--auto-upgrade-min --auto-upgrade-minor-version

Propriété	Valeur
Groupe de paramètres:	Properties Arguments
Valeurs acceptées:	0, 1, f, false, n, no, t, true, y, yes

--enable-auto-upgrade --enable-automatic-upgrade

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

Propriété	Valeur
Groupe de paramètres:	Properties Arguments
Valeurs acceptées:	0, 1, f, false, n, no, t, true, y, yes

--extension-name --name -n

Nom de l’extension de machine.

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

--force-update-tag

Comment le gestionnaire d’extensions doit être forcé de mettre à jour même si la configuration de l’extension n’a pas changé.

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

--ids

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

--machine-name

Nom de l’ordinateur sur lequel l’extension doit être créée ou mise à jour.

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
Valeurs acceptées:	0, 1, f, false, n, no, t, true, y, yes

--protected-settings

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

--publisher

Nom du serveur de publication du gestionnaire d’extensions.

Propriété	Valeur
Groupe de paramètres:	Properties 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

--settings

Paramètres publics au format Json pour l’extension. 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:	Properties 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

Les balises de ressource prennent en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété	Valeur
Groupe de paramètres:	ExtensionParameters Arguments

--type

Spécifie le type de l’extension ; un exemple est « CustomScriptExtension ».

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

--type-handler-version

Spécifie la version du gestionnaire de scripts.

Propriété	Valeur
Groupe de paramètres:	Properties 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 connectedmachine extension wait

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition soit remplie.

az connectedmachine extension wait [--created]
                                   [--custom]
                                   [--deleted]
                                   [--exists]
                                   [--extension-name --name]
                                   [--ids]
                                   [--interval]
                                   [--machine-name]
                                   [--resource-group]
                                   [--subscription]
                                   [--timeout]
                                   [--updated]

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.

--created

Attendez la création avec « provisioningState » sur « Succeeded ».

Propriété	Valeur
Groupe de paramètres:	Wait Condition Arguments
Valeur par défaut:	False

--custom

Attendez que la condition réponde à une requête JMESPath personnalisée. Par exemple, provisioningState !='InProgress', instanceView.statuses[ ?code=='PowerState/running'].

Propriété	Valeur
Groupe de paramètres:	Wait Condition Arguments

--deleted

Attendez la suppression.

Propriété	Valeur
Groupe de paramètres:	Wait Condition Arguments
Valeur par défaut:	False

--exists

Attendez que la ressource existe.

Propriété	Valeur
Groupe de paramètres:	Wait Condition Arguments
Valeur par défaut:	False

--extension-name --name -n

Nom de l’extension de machine.

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

--ids

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

--interval

Intervalle d’interrogation en secondes.

Propriété	Valeur
Groupe de paramètres:	Wait Condition Arguments
Valeur par défaut:	30

--machine-name

Nom de l’ordinateur contenant l’extension.

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

--timeout

Délai maximal d’attente en secondes.

Propriété	Valeur
Groupe de paramètres:	Wait Condition Arguments
Valeur par défaut:	3600

--updated

Attendez la mise à jour avec provisioningState sur « Réussi ».

Propriété	Valeur
Groupe de paramètres:	Wait Condition Arguments
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

Commentaires

Cette page a-t-elle été utile ?

Partager via

az connectedmachine extension

Commandes

az connectedmachine extension create

Exemples

Paramètres obligatoires

Paramètres facultatifs

az connectedmachine extension delete

Exemples

Paramètres facultatifs

az connectedmachine extension list

Exemples

Paramètres obligatoires

Paramètres facultatifs

az connectedmachine extension show

Exemples

Paramètres facultatifs

az connectedmachine extension update

Exemples

Paramètres facultatifs

az connectedmachine extension wait

Paramètres facultatifs

Commentaires