az lab vm

  • Préversion
  • Référence

Le groupe de commandes « lab » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Gérer des machines virtuelles dans un laboratoire Azure DevTest.

Commandes

Nom Description Type État
az lab vm apply-artifacts

Appliquez des artefacts à une machine virtuelle dans Azure DevTest Lab.

 Core Aperçu
az lab vm claim

Revendiquer une machine virtuelle à partir du laboratoire.

 Core Aperçu
az lab vm create

Créer une machine virtuelle dans un labo.

 Core Aperçu
az lab vm delete

Supprimez la machine virtuelle.

 Core Aperçu
az lab vm list

Répertoriez les machines virtuelles dans un laboratoire Azure DevTest.

 Core Aperçu
az lab vm show

Obtenir une machine virtuelle.

 Core Aperçu
az lab vm start

Démarrer une machine virtuelle.

 Core Aperçu
az lab vm stop

Arrêter une machine virtuelle Cette opération peut prendre un certain temps.

 Core Aperçu

az lab vm apply-artifacts

Modifier
Préversion

Le groupe de commandes « lab » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Appliquez des artefacts à une machine virtuelle dans Azure DevTest Lab.

az lab vm apply-artifacts --lab-name
                          --name
                          --resource-group
                          [--artifacts]

Exemples

Appliquez des artefacts à une machine virtuelle dans Azure DevTest Lab. (généré automatiquement)

az lab vm apply-artifacts --artifacts '@artifacts.json' --lab-name MyLab --name MyVirtualMachine --resource-group MyResourceGroup

Paramètres obligatoires

--lab-name

Nom du labo.

--name -n

Nom de la machine virtuelle.

--resource-group -g

Nom du groupe de ressources du laboratoire.

Paramètres facultatifs

--artifacts

Tableau encodé JSON d’artefacts à appliquer. Utilisez « @{file} » pour charger à partir d’un fichier.

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 lab vm claim

Modifier
Préversion

Le groupe de commandes « lab » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Revendiquer une machine virtuelle à partir du laboratoire.

az lab vm claim [--ids]
                [--lab-name]
                [--name]
                [--resource-group]
                [--subscription]

Exemples

Revendiquer n’importe quelle machine virtuelle disponible dans le labo.

az lab vm claim -g {ResourceGroup} --lab-name {LabName}

Revendiquer une machine virtuelle spécifique dans le labo.

az lab vm claim -g {ResourceGroup} --lab-name {LabName} --name {VMName}

Revendiquez plusieurs machines virtuelles dans le labo par ID.

az lab vm claim --ids \
    /subscriptions/{SubID}/resourcegroups/{ResourceGroup}/providers/microsoft.devtestlab/labs/{LabName}/virtualmachines/{VMName1} \
    /subscriptions/{SubID}/resourcegroups/{ResourceGroup}/providers/microsoft.devtestlab/labs/{LabName}/virtualmachines/{VMName2}

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

--lab-name

Nom du lab.

--name -n

Nom de la machine virtuelle à revendiquer.

--resource-group -g

Nom du groupe de ressources du laboratoire.

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

az lab vm create

Modifier
Préversion

Le groupe de commandes « lab » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Créer une machine virtuelle dans un labo.

az lab vm create --lab-name
                 --name
                 --resource-group
                 [--admin-password]
                 [--admin-username]
                 [--allow-claim]
                 [--artifacts]
                 [--authentication-type]
                 [--disk-type]
                 [--expiration-date]
                 [--formula]
                 [--generate-ssh-keys]
                 [--image]
                 [--image-type]
                 [--ip-configuration]
                 [--notes]
                 [--saved-secret]
                 [--size]
                 [--ssh-key]
                 [--subnet]
                 [--tags]
                 [--vnet-name]

Exemples

Créez une machine virtuelle dans le labo à partir d’une image de galerie.

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --image "Ubuntu Server 16.04 LTS" --image-type gallery --size Standard_DS1_v2

Créez une machine virtuelle dans le labo à partir d’une image de galerie avec l’authentification SSH.

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --image "Ubuntu Server 16.04 LTS" --image-type gallery --size Standard_DS1_v2 --authentication-type ssh

Créez une machine virtuelle pouvant être revendiquée dans le labo à partir d’une image de galerie avec l’authentification par mot de passe.

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --image "Ubuntu Server 16.04 LTS" --image-type gallery --size Standard_DS1_v2 --allow-claim

Créez une machine virtuelle Windows dans le labo à partir d’une image de galerie avec l’authentification par mot de passe.

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --image "Windows Server 2008 R2 SP1" --image-type gallery --size Standard_DS1_v2

Créez une machine virtuelle dans le labo à partir d’une image personnalisée.

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --image "jenkins_custom" --image-type custom --size Standard_DS1_v2

Créez une machine virtuelle dans le labo avec une adresse IP publique.

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --image "Ubuntu Server 16.04 LTS" --image-type gallery --size Standard_DS1_v2 --ip-configuration public

Créez une machine virtuelle à partir d’une formule.

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --formula MyFormula --artifacts '@artifacts.json'

Paramètres obligatoires

--lab-name

Nom du lab.

--name -n

Nom de la machine virtuelle.

--resource-group -g

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

Paramètres facultatifs

--admin-password

Mot de passe de l’administrateur de machine virtuelle.

--admin-username

Nom d’utilisateur de l’administrateur de machine virtuelle.

Valeur par défaut: your_system_user_login_name
--allow-claim

Indicateur indiquant si la machine virtuelle doit être créée comme pouvant être revendiquée.

Valeur par défaut: False
--artifacts

Tableau encodé JSON d’artefacts à appliquer. Utilisez « @{file} » pour charger à partir d’un fichier.

--authentication-type

Type d’authentification autorisé pour la machine virtuelle. Les valeurs autorisées sont : mot de passe, ssh.

Valeur par défaut: password
--disk-type

Stockage type à utiliser pour la machine virtuelle. Les valeurs autorisées sont : Premium, Standard, StandardSSD.

--expiration-date

Date d’expiration au format UTC(aaaa-MM-ddTHH :mm :ss) de la machine virtuelle.

--formula

Nom de la formule. Utiliser az lab formula list pour les formules disponibles.

Utilisez az lab formula l’indicateur --export-artifacts pour exporter et mettre à jour des artefacts, puis transmettez les résultats via l’argument --artifacts .

--generate-ssh-keys

Génère les fichiers de clés SSH publiques et privées s’ils sont manquants.

--image

Nom de l’image du système d’exploitation (nom de l’image de la galerie ou nom/ID d’image personnalisé).

Utiliser az lab gallery-image list pour les images de galerie disponibles ou az lab custom-image list pour les images personnalisées disponibles.

--image-type

Type de l’image. Les valeurs autorisées sont : galerie, personnalisée.

--ip-configuration

Type de configuration IP à utiliser pour la machine virtuelle. Les valeurs autorisées sont les suivantes : partagé, public, privé.

Si elle est omise, elle est sélectionnée en fonction du réseau virtuel de la machine virtuelle.

--notes

Remarques relatives à la machine virtuelle.

--saved-secret

Nom du secret enregistré à utiliser pour l’authentification.

Lorsque cette valeur est fournie, elle est utilisée à la place d’autres méthodes d’authentification.

--size

Taille de la machine virtuelle à créer. Consultez https://azure.microsoft.com/pricing/details/virtual-machines/ les informations de taille.

--ssh-key

Chemin du fichier de clé publique SSH ou de clé publique. Permet --generate-ssh-keys de générer des clés SSH.

--subnet

Nom du sous-réseau auquel ajouter la machine virtuelle.

--tags

Balises séparées par espace au key[=value] format.

Les balises peuvent être effacées en leur affectant la valeur vide « ».

--vnet-name

Nom du réseau virtuel auquel ajouter la machine virtuelle.

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 lab vm delete

Modifier
Préversion

Le groupe de commandes « lab » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Supprimez la machine virtuelle.

Cet opérateur peut prendre un certain temps.

az lab vm delete --lab-name
                 --name
                 --resource-group

Paramètres obligatoires

--lab-name

Nom du lab.

--name

Nom de la machine virtuelle.

--resource-group -g

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

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 lab vm list

Modifier
Préversion

Le groupe de commandes « lab » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Répertoriez les machines virtuelles dans un laboratoire Azure DevTest.

az lab vm list --lab-name
               --resource-group
               [--all]
               [--claimable]
               [--environment]
               [--expand]
               [--filters]
               [--object-id]
               [--order-by]
               [--top]

Exemples

Répertoriez les machines virtuelles dans un laboratoire Azure DevTest. (généré automatiquement)

az lab vm list --lab-name MyLab --resource-group MyResourceGroup

Paramètres obligatoires

--lab-name

Nom du lab.

--resource-group -g

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

Paramètres facultatifs

--all

Répertoriez toutes les machines virtuelles du labo. Ne peut pas être utilisé avec --filters.

--claimable

Répertorier uniquement les machines virtuelles pouvant être revendiquées dans le labo. Ne peut pas être utilisé avec --filters.

--environment

Nom ou ID de l’environnement dans lequel répertorier les machines virtuelles. Ne peut pas être utilisé avec --filters.

--expand

Requête de développement.

--filters

Filtre à appliquer.

--object-id

ID d’objet du propriétaire pour lequel répertorier les machines virtuelles.

--order-by

Expression de classement pour les résultats à l’aide de la notation OData.

--top

Nombre maximal de ressources à retourner.

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 lab vm show

Modifier
Préversion

Le groupe de commandes « lab » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Obtenir une machine virtuelle.

az lab vm show --lab-name
               --name
               --resource-group
               [--expand]

Paramètres obligatoires

--lab-name

Nom du lab.

--name

Nom de la machine virtuelle.

--resource-group -g

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

Paramètres facultatifs

--expand

Spécifiez la requête $expand. Exemple : 'properties($expand=artifacts,computeVm,networkInterface,applicableSchedule)'.

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 lab vm start

Modifier
Préversion

Le groupe de commandes « lab » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Démarrer une machine virtuelle.

Cet opérateur peut prendre un certain temps.

az lab vm start --lab-name
                --name
                --resource-group

Paramètres obligatoires

--lab-name

Nom du lab.

--name

Nom de la machine virtuelle.

--resource-group -g

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

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 lab vm stop

Modifier
Préversion

Le groupe de commandes « lab » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Arrêter une machine virtuelle Cette opération peut prendre un certain temps.

az lab vm stop --lab-name
               --name
               --resource-group

Paramètres obligatoires

--lab-name

Nom du lab.

--name

Nom de la machine virtuelle.

--resource-group -g

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

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.