az devcenter dev customization-task

Note

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

Gérer les tâches de personnalisation.

Commandes

Nom Description Type État
az devcenter dev customization-task list

Tâche de personnalisation de liste.

Extension GA
az devcenter dev customization-task show

Obtenir une tâche de personnalisation.

Extension GA
az devcenter dev customization-task show-logs

Afficher les journaux d’activité d’une tâche de personnalisation.

Extension GA
az devcenter dev customization-task validate

Valider les tâches de personnalisation.

Extension GA

az devcenter dev customization-task list

Tâche de personnalisation de liste.

az devcenter dev customization-task list --project --project-name
                                         [--dev-center --dev-center-name]
                                         [--endpoint]

Exemples

Liste à l’aide du centre de développement

az devcenter dev customization-task list --dev-center-name "ContosoDevCenter" --project-name "DevProject"

Liste à l’aide du point de terminaison

az devcenter dev customization-task list --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject"

Paramètres obligatoires

--project --project-name

Nom du projet. Utilisez az configure -d project=<project_name> pour configurer une valeur par défaut.

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.

--dev-center --dev-center-name -d

Nom du centre de développement. Utilisez az configure -d dev-center=<dev_center_name> pour configurer une valeur par défaut.

--endpoint

Point de terminaison d’API pour les ressources du développeur. Utilisez az configure -d endpoint=<endpoint_uri> pour configurer une valeur par défaut.

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 devcenter dev customization-task show

Obtenir une tâche de personnalisation.

az devcenter dev customization-task show --catalog-name
                                         --name --task-name
                                         --project --project-name
                                         [--dev-center --dev-center-name]
                                         [--endpoint]

Exemples

Utiliser le centre de développement

az devcenter dev customization-task show --dev-center-name "ContosoDevCenter" --project-name "DevProject" --task-name "choco" --catalog-name "myCatalog"

Utiliser le point de terminaison

az devcenter dev customization-task show --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --task-name "choco" --catalog-name "myCatalog"

Paramètres obligatoires

--catalog-name

Nom du catalogue.

--name --task-name -n

Nom de la tâche.

--project --project-name

Nom du projet. Utilisez az configure -d project=<project_name> pour configurer une valeur par défaut.

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.

--dev-center --dev-center-name -d

Nom du centre de développement. Utilisez az configure -d dev-center=<dev_center_name> pour configurer une valeur par défaut.

--endpoint

Point de terminaison d’API pour les ressources du développeur. Utilisez az configure -d endpoint=<endpoint_uri> pour configurer une valeur par défaut.

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 devcenter dev customization-task show-logs

Afficher les journaux d’activité d’une tâche de personnalisation.

az devcenter dev customization-task show-logs --customization-group-name --name
                                              --customization-task-id --task-id-t
                                              --dev-box --dev-box-name
                                              --project --project-name
                                              [--acquire-policy-token]
                                              [--change-reference]
                                              [--dev-center --dev-center-name]
                                              [--endpoint]
                                              [--user-id]

Exemples

Utiliser le centre de développement

az devcenter dev customization-task show-logs --dev-center-name "ContosoDevCenter" --project-name "DevProject" --dev-box-name "myDevBox" --customization-group-name "Provisioning" --customization-task-id "91835dc0-ef5a-4f58-9e3a-099aea8481f4" --user-id "00000000-0000-0000-0000-000000000000"

Utiliser le point de terminaison

az devcenter dev customization-task show-logs --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --dev-box-name "myDevBox" --customization-group-name "Provisioning" --customization-task-id "91835dc0-ef5a-4f58-9e3a-099aea8481f4" --user-id "00000000-0000-0000-0000-000000000000"

Paramètres obligatoires

--customization-group-name --name -n

Nom du groupe de personnalisation.

--customization-task-id --task-id-t

Nom de la zone de développement.

--dev-box --dev-box-name

Nom de la zone de développement.

--project --project-name

Nom du projet. Utilisez az configure -d project=<project_name> pour configurer une valeur par défaut.

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.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--dev-center --dev-center-name -d

Nom du centre de développement. Utilisez az configure -d dev-center=<dev_center_name> pour configurer une valeur par défaut.

--endpoint

Point de terminaison d’API pour les ressources du développeur. Utilisez az configure -d endpoint=<endpoint_uri> pour configurer une valeur par défaut.

--user-id

ID d’objet AAD de l’utilisateur. Si la valeur est « moi », l’identité est extraite du contexte d’authentification.

Propriété Valeur
Valeur par défaut: me
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 devcenter dev customization-task validate

Valider les tâches de personnalisation.

az devcenter dev customization-task validate --project --project-name
                                             --tasks
                                             [--acquire-policy-token]
                                             [--change-reference]
                                             [--dev-center --dev-center-name]
                                             [--endpoint]
                                             [--no-wait]

Exemples

Valider à l’aide du centre de développement

az devcenter dev customization-task validate --dev-center-name "ContosoDevCenter" --project-name "DevProject" --tasks "[{\"name\": \"catalogName/choco\", \"displayName\": \"Install VS Code\", \"parameters\": {\"packageName\": \"vscode\", \"packageVersion\": \"1.0.0\"}}, {\"name\": \"catalogName/write-to-file\", \"runAs\": \"User\"}]"

Valider à l’aide du point de terminaison

az devcenter dev customization-task validate --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --tasks "[{\"name\": \"catalogName/choco\", \"displayName\": \"Install VS Code\", \"parameters\": {\"packageName\": \"vscode\", \"packageVersion\": \"1.0.0\"}}, {\"name\": \"catalogName/write-to-file\", \"runAs\": \"User\"}]"

Paramètres obligatoires

--project --project-name

Nom du projet. Utilisez az configure -d project=<project_name> pour configurer une valeur par défaut.

--tasks

Objet Parameters pour les tâches. Valeur attendue : json-string/json-file/@json-file.

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.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--dev-center --dev-center-name -d

Nom du centre de développement. Utilisez az configure -d dev-center=<dev_center_name> pour configurer une valeur par défaut.

--endpoint

Point de terminaison d’API pour les ressources du développeur. Utilisez az configure -d endpoint=<endpoint_uri> pour configurer une valeur par défaut.

--no-wait

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

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

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