az connectedmachine run-command
Remarque
Cette référence fait partie de l’extension connectedmachine pour Azure CLI (version 2.57.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az connectedmachine run-command . Apprenez-en davantage sur les extensions.
Ce groupe de commandes est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus
Gérer les commandes d’exécution sur un serveur avec Azure Arc.
Commandes
Nom | Description | Type | État |
---|---|---|---|
az connectedmachine run-command create |
Créez une commande d’exécution. |
Extension | Aperçu |
az connectedmachine run-command delete |
Supprimez une commande d’exécution. |
Extension | Aperçu |
az connectedmachine run-command list |
Obtenez toutes les commandes d’exécution d’une machine non-Azure. |
Extension | Aperçu |
az connectedmachine run-command show |
Obtenir une commande d’exécution. |
Extension | Aperçu |
az connectedmachine run-command update |
Mettez à jour une commande d’exécution. |
Extension | Aperçu |
az connectedmachine run-command wait |
Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition soit remplie. |
Extension | Aperçu |
az connectedmachine run-command create
Le groupe de commandes « az connectedmachine run-command » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus
Créez une commande d’exécution.
az connectedmachine run-command create --machine-name
--name
--resource-group
[--async-execution {0, 1, f, false, n, no, t, true, y, yes}]
[--command-id]
[--error-blob-id]
[--error-blob-uri]
[--location]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--output-blob-id]
[--output-blob-uri]
[--parameters]
[--protected-parameters]
[--run-as-password]
[--run-as-user]
[--script]
[--script-uri]
[--script-uri-id]
[--tags]
[--timeout-in-seconds]
Exemples
Exemple de commande pour run-command create
az connectedmachine run-command create --resource-group myResourceGroup --location "WestUS" --async false --parameters "[{"name":"param1","value":"value1"}]" --password "<runAsPassword>" --user "user1" --script "Write-Host Hello World!" --timeout 3600 --name myRunCommand --machine-name myMachine --subscription mySubscription
az connectedmachine run-command create --resource-group myResourceGroup --location "WestUS" --script "Write-Host Hello World!" --name myRunCommand --machine-name myMachine --output-uri "outputuri" --subscription mySubscription
Paramètres obligatoires
Nom de la machine hybride.
Nom de la commande d’exécution.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres facultatifs
facultatif. Si la valeur est true, l’approvisionnement se termine dès que le script démarre et n’attend pas la fin du script.
Spécifie l’ID de commande du script intégré prédéfini.
Identité managée affectée par l’utilisateur qui a accès à l’objet blob de stockage errorBlobUri. Utilisez un objet vide en cas d’identité affectée par le système. Vérifiez que l’identité managée a reçu l’accès au conteneur de l’objet blob avec l’attribution de rôle « Contributeur aux données blob de stockage ». En cas d’identité affectée par l’utilisateur, veillez à l’ajouter sous l’identité de la machine virtuelle. Pour plus d’informations sur l’identité managée et la commande d’exécution, reportez-vous https://aka.ms/ManagedIdentity à https://aka.ms/RunCommandManaged la syntaxe abrégée, au fichier json et au fichier yaml-file. Essayez « ?? » pour en montrer plus.
Spécifie l’objet blob de stockage Azure dans lequel le flux d’erreurs de script sera chargé. Utilisez un URI SAP avec lecture, ajout, création, accès en écriture OU utiliser l’identité managée pour fournir à la machine virtuelle l’accès à l’objet blob. Reportez-vous au paramètre errorBlobManagedIdentity.
Emplacement géographique où la ressource se trouve quand elle n’est pas spécifiée, l’emplacement du groupe de ressources sera utilisé.
Ne pas attendre la fin de l’opération de longue durée.
Identité managée affectée par l’utilisateur qui a accès à l’objet blob de stockage outputBlobUri. Utilisez un objet vide en cas d’identité affectée par le système. Vérifiez que l’identité managée a reçu l’accès au conteneur de l’objet blob avec l’attribution de rôle « Contributeur aux données blob de stockage ». En cas d’identité affectée par l’utilisateur, veillez à l’ajouter sous l’identité de la machine virtuelle. Pour plus d’informations sur l’identité managée et la commande d’exécution, reportez-vous https://aka.ms/ManagedIdentity à https://aka.ms/RunCommandManaged la syntaxe abrégée, au fichier json et au fichier yaml-file. Essayez « ?? » pour en montrer plus.
Spécifie l’objet blob de stockage Azure dans lequel le flux de sortie de script sera chargé. Utilisez un URI SAP avec lecture, ajout, création, accès en écriture OU utiliser l’identité managée pour fournir à la machine virtuelle l’accès à l’objet blob. Reportez-vous au paramètre outputBlobManagedIdentity.
Paramètres utilisés par le script. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.
Paramètres utilisés par le script. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.
Spécifie le mot de passe du compte d’utilisateur sur l’ordinateur lors de l’exécution de la commande d’exécution.
Spécifie le compte d’utilisateur sur l’ordinateur lors de l’exécution de la commande d’exécution.
Spécifie le contenu du script à exécuter sur l’ordinateur.
Spécifie l’emplacement de téléchargement du script. Il peut s’agir de l’URI SAP d’un objet blob de stockage Azure avec accès en lecture ou URI public.
Identité managée affectée par l’utilisateur qui a accès à scriptUri en cas d’objet blob de stockage Azure. Utilisez un objet vide en cas d’identité affectée par le système. Vérifiez que l’objet blob de stockage Azure existe et que l’identité managée a été attribuée au conteneur de l’objet blob avec l’attribution de rôle « Lecteur de données blob du stockage ». En cas d’identité affectée par l’utilisateur, veillez à l’ajouter sous l’identité de la machine virtuelle. Pour plus d’informations sur l’identité managée et exécuter la commande, consultez https://aka.ms/ManagedIdentity et https://aka.ms/RunCommandManaged. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.
Balises de ressource. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.
Délai d’expiration en secondes pour exécuter la commande d’exécution.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
az connectedmachine run-command delete
Le groupe de commandes « az connectedmachine run-command » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus
Supprimez une commande d’exécution.
az connectedmachine run-command delete [--ids]
[--machine-name]
[--name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
[--yes]
Exemples
Exemple de commande pour run-command delete
az connectedmachine run-command delete --resource-group myResourceGroup --machine-name myMachine --name myRunCommand
Paramètres facultatifs
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 ».
Nom de la machine hybride.
Nom de la commande d’exécution.
Ne pas attendre la fin de l’opération de longue durée.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Ne pas demander de confirmation.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
az connectedmachine run-command list
Le groupe de commandes « az connectedmachine run-command » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus
Obtenez toutes les commandes d’exécution d’une machine non-Azure.
az connectedmachine run-command list --machine-name
--resource-group
[--expand]
[--max-items]
[--next-token]
Exemples
Exemple de commande pour la liste de commandes run-command
az connectedmachine run-command list --resource-group myResourceGroup --machine-name myMachine --subscription mySubscription
Paramètres obligatoires
Nom de la machine hybride.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres facultatifs
Expression de développement à appliquer à l’opération.
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
l’argument d’une commande suivante.
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.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
az connectedmachine run-command show
Le groupe de commandes « az connectedmachine run-command » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus
Obtenir une commande d’exécution.
az connectedmachine run-command show [--ids]
[--machine-name]
[--name]
[--resource-group]
[--subscription]
Exemples
Exemple de commande pour run-command show
az connectedmachine run-command show --resource-group myResourceGroup --machine-name myMachine --name myRunCommand
Paramètres facultatifs
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 ».
Nom de la machine hybride.
Nom de la commande d’exécution.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
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
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
az connectedmachine run-command update
Le groupe de commandes « az connectedmachine run-command » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus
Mettez à jour une commande d’exécution.
az connectedmachine run-command update [--add]
[--async-execution {0, 1, f, false, n, no, t, true, y, yes}]
[--command-id]
[--error-blob-id]
[--error-blob-uri]
[--force-string {0, 1, f, false, n, no, t, true, y, yes}]
[--ids]
[--machine-name]
[--name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--output-blob-id]
[--output-blob-uri]
[--parameters]
[--protected-parameters]
[--remove]
[--resource-group]
[--run-as-password]
[--run-as-user]
[--script]
[--script-uri]
[--script-uri-id]
[--set]
[--subscription]
[--tags]
[--timeout-in-seconds]
Exemples
Exemple de commande pour la mise à jour de run-command
az connetcedmachine run-command update --resource-group myResourceGroup --name myRunCommand --machine-name myMachine --subscription mySubscription --tags Tag1=Value1
Paramètres facultatifs
Ajoutez un objet à une liste d’objets en spécifiant un chemin d’accès et des paires clé-valeur. Exemple : --add property.listProperty <key=value, string or JSON string>
.
facultatif. Si la valeur est true, l’approvisionnement se termine dès que le script démarre et n’attend pas la fin du script.
Spécifie l’ID de commande du script intégré prédéfini.
Identité managée affectée par l’utilisateur qui a accès à l’objet blob de stockage errorBlobUri. Utilisez un objet vide en cas d’identité affectée par le système. Vérifiez que l’identité managée a reçu l’accès au conteneur de l’objet blob avec l’attribution de rôle « Contributeur aux données blob de stockage ». En cas d’identité affectée par l’utilisateur, veillez à l’ajouter sous l’identité de la machine virtuelle. Pour plus d’informations sur l’identité managée et la commande d’exécution, reportez-vous https://aka.ms/ManagedIdentity à https://aka.ms/RunCommandManaged la syntaxe abrégée, au fichier json et au fichier yaml-file. Essayez « ?? » pour en montrer plus.
Spécifie l’objet blob de stockage Azure dans lequel le flux d’erreurs de script sera chargé. Utilisez un URI SAP avec lecture, ajout, création, accès en écriture OU utiliser l’identité managée pour fournir à la machine virtuelle l’accès à l’objet blob. Reportez-vous au paramètre errorBlobManagedIdentity.
Lorsque vous utilisez « set » ou « add », conservez les littéraux de chaîne au lieu de tenter de convertir en JSON.
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 ».
Nom de la machine hybride.
Nom de la commande d’exécution.
Ne pas attendre la fin de l’opération de longue durée.
Identité managée affectée par l’utilisateur qui a accès à l’objet blob de stockage outputBlobUri. Utilisez un objet vide en cas d’identité affectée par le système. Vérifiez que l’identité managée a reçu l’accès au conteneur de l’objet blob avec l’attribution de rôle « Contributeur aux données blob de stockage ». En cas d’identité affectée par l’utilisateur, veillez à l’ajouter sous l’identité de la machine virtuelle. Pour plus d’informations sur l’identité managée et la commande d’exécution, reportez-vous https://aka.ms/ManagedIdentity à https://aka.ms/RunCommandManaged la syntaxe abrégée, au fichier json et au fichier yaml-file. Essayez « ?? » pour en montrer plus.
Spécifie l’objet blob de stockage Azure dans lequel le flux de sortie de script sera chargé. Utilisez un URI SAP avec lecture, ajout, création, accès en écriture OU utiliser l’identité managée pour fournir à la machine virtuelle l’accès à l’objet blob. Reportez-vous au paramètre outputBlobManagedIdentity.
Paramètres utilisés par le script. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.
Paramètres utilisés par le script. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.
Supprimez une propriété ou un élément d’une liste. Exemple : --remove property.list <indexToRemove>
OR --remove propertyToRemove
.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Spécifie le mot de passe du compte d’utilisateur sur l’ordinateur lors de l’exécution de la commande d’exécution.
Spécifie le compte d’utilisateur sur l’ordinateur lors de l’exécution de la commande d’exécution.
Spécifie le contenu du script à exécuter sur l’ordinateur.
Spécifie l’emplacement de téléchargement du script. Il peut s’agir de l’URI SAP d’un objet blob de stockage Azure avec accès en lecture ou URI public.
Identité managée affectée par l’utilisateur qui a accès à scriptUri en cas d’objet blob de stockage Azure. Utilisez un objet vide en cas d’identité affectée par le système. Vérifiez que l’objet blob de stockage Azure existe et que l’identité managée a été attribuée au conteneur de l’objet blob avec l’attribution de rôle « Lecteur de données blob du stockage ». En cas d’identité affectée par l’utilisateur, veillez à l’ajouter sous l’identité de la machine virtuelle. Pour plus d’informations sur l’identité managée et exécuter la commande, consultez https://aka.ms/ManagedIdentity et https://aka.ms/RunCommandManaged. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.
Mettez à jour un objet en spécifiant un chemin d’accès et une valeur de propriété à définir. Exemple : --set property1.property2=<value>
.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Balises de ressource. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.
Délai d’expiration en secondes pour exécuter la commande d’exécution.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
az connectedmachine run-command wait
Le groupe de commandes « az connectedmachine run-command » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus
Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition soit remplie.
az connectedmachine run-command wait [--created]
[--custom]
[--deleted]
[--exists]
[--ids]
[--interval]
[--machine-name]
[--name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
Paramètres facultatifs
Attendez la création avec « provisioningState » sur « Succeeded ».
Attendez que la condition réponde à une requête JMESPath personnalisée. Par exemple, provisioningState !='InProgress', instanceView.statuses[ ?code=='PowerState/running'].
Attendez la suppression.
Attendez que la ressource existe.
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 ».
Intervalle d’interrogation en secondes.
Nom de la machine hybride.
Nom de la commande d’exécution.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Délai maximal d’attente en secondes.
Attendez la mise à jour avec provisioningState sur « Réussi ».
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.