Partager via


az boards work-item

Note

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

Gérer les éléments de travail.

Commandes

Nom Description Type État
az boards work-item create

Créez un élément de travail.

Extension GA
az boards work-item delete

Supprimez un élément de travail.

Extension GA
az boards work-item relation

Gérer les relations entre les éléments de travail.

Extension GA
az boards work-item relation add

Ajoutez des relations à l’élément de travail.

Extension GA
az boards work-item relation list-type

Répertorier les relations d’élément de travail prises en charge dans l’organisation.

Extension GA
az boards work-item relation remove

Supprimez la ou les relations de l’élément de travail.

Extension GA
az boards work-item relation show

Obtenir un élément de travail, remplir les relations avec un nom convivial.

Extension GA
az boards work-item show

Afficher les détails d’un élément de travail.

Extension GA
az boards work-item update

Mettez à jour les éléments de travail.

Extension GA

az boards work-item create

Créez un élément de travail.

az boards work-item create --title
                           --type
                           [--area]
                           [--assigned-to]
                           [--description]
                           [--detect {false, true}]
                           [--discussion]
                           [--fields]
                           [--iteration]
                           [--open]
                           [--org --organization]
                           [--project]
                           [--reason]

Paramètres obligatoires

--title

Titre de l’élément de travail.

--type

Nom du type d’élément de travail (par exemple, Bogue).

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.

--area

Zone à laquelle l’élément de travail est affecté (par exemple, démonstrations).

--assigned-to

Nom de la personne à laquelle l’élément de travail est affecté (par exemple, fabrikam).

--description -d

Description de l’élément de travail.

--detect

Détectez automatiquement l’organisation.

Propriété Valeur
Valeurs acceptées: false, true
--discussion

Commentaire à ajouter à une discussion dans un élément de travail.

--fields -f

Paires « field=value » séparées par espace pour les champs personnalisés que vous souhaitez définir. Dans le cas de plusieurs champs : « field1=value1 » « field2=value2 ». Pour plus d’informations sur les champs, consultez https://aka.ms/azure-devops-cli-field-api.

--iteration

Chemin d’itération de l’élément de travail (par exemple, Demos\Itération 1).

--open

Ouvrir l’élément de travail dans le navigateur web par défaut.

Propriété Valeur
Valeur par défaut: False
--org --organization

URL de organization Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide d’az devops configure -d organization=ORG_URL. Obligatoire s’il n’est pas configuré comme valeur par défaut ou récupéré par le biais de la configuration git. Exemple : https://dev.azure.com/MyOrganizationName/.

--project -p

Nom ou ID du projet. Vous pouvez configurer le projet par défaut à l’aide de az devops configure -d project=NAME_OR_ID. Obligatoire si ce paramètre n’est pas configuré par défaut ou récupéré avec git config.

--reason

Raison de l’état de l’élément de travail.

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 boards work-item delete

Supprimez un élément de travail.

az boards work-item delete --id
                           [--destroy]
                           [--detect {false, true}]
                           [--org --organization]
                           [--project]
                           [--yes]

Paramètres obligatoires

--id

ID unique de l’élément de travail.

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.

--destroy

Supprimez définitivement cet élément de travail.

Propriété Valeur
Valeur par défaut: False
--detect

Détectez automatiquement l’organisation.

Propriété Valeur
Valeurs acceptées: false, true
--org --organization

URL de organization Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide d’az devops configure -d organization=ORG_URL. Obligatoire s’il n’est pas configuré comme valeur par défaut ou récupéré par le biais de la configuration git. Exemple : https://dev.azure.com/MyOrganizationName/.

--project -p

Nom ou ID du projet. Vous pouvez configurer le projet par défaut à l’aide de az devops configure -d project=NAME_OR_ID. Obligatoire si ce paramètre n’est pas configuré par défaut ou récupéré avec git config.

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

--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 boards work-item show

Afficher les détails d’un élément de travail.

az boards work-item show --id
                         [--as-of]
                         [--detect {false, true}]
                         [--expand {all, fields, links, none, relations}]
                         [--fields]
                         [--open]
                         [--org --organization]

Paramètres obligatoires

--id

L'ID de l'élément de travail.

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.

--as-of

Détails de l’élément de travail à partir d’une date et d’une heure particulières. Fournissez une chaîne de date ou d’heure de date. Suppose le fuseau horaire local. Exemple : « 2019-01-20 », « 2019-01-20 00:20:00 ». Pour UTC, ajoutez « UTC » à la chaîne d’heure de date, « 2019-01-20 00:20:00 UTC ».

--detect

Détectez automatiquement l’organisation.

Propriété Valeur
Valeurs acceptées: false, true
--expand

Paramètres de développement pour les attributs d’élément de travail.

Propriété Valeur
Valeur par défaut: all
Valeurs acceptées: all, fields, links, none, relations
--fields -f

Liste séparée par des virgules des champs demandés. Example:System.Id,System.AreaPath. Pour plus d’informations sur les champs, consultez https://aka.ms/azure-devops-cli-field-api.

--open

Ouvrir l’élément de travail dans le navigateur web par défaut.

Propriété Valeur
Valeur par défaut: False
--org --organization

URL de organization Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide d’az devops configure -d organization=ORG_URL. Obligatoire s’il n’est pas configuré comme valeur par défaut ou récupéré par le biais de la configuration git. Exemple : https://dev.azure.com/MyOrganizationName/.

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 boards work-item update

Mettez à jour les éléments de travail.

az boards work-item update --id
                           [--area]
                           [--assigned-to]
                           [--description]
                           [--detect {false, true}]
                           [--discussion]
                           [--fields]
                           [--iteration]
                           [--open]
                           [--org --organization]
                           [--reason]
                           [--state]
                           [--title]

Paramètres obligatoires

--id

ID de l’élément de travail à mettre à jour.

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.

--area

Zone à laquelle l’élément de travail est affecté (par exemple, démonstrations).

--assigned-to

Nom de la personne à laquelle l’élément de travail est affecté (par exemple, fabrikam).

--description -d

Description de l’élément de travail.

--detect

Détectez automatiquement l’organisation.

Propriété Valeur
Valeurs acceptées: false, true
--discussion

Commentaire à ajouter à une discussion dans un élément de travail.

--fields -f

Paires « field=value » séparées par espace pour les champs personnalisés que vous souhaitez définir. Pour plus d’informations sur les champs, consultez https://aka.ms/azure-devops-cli-field-api.

--iteration

Chemin d’itération de l’élément de travail (par exemple, Demos\Itération 1).

--open

Ouvrir l’élément de travail dans le navigateur web par défaut.

Propriété Valeur
Valeur par défaut: False
--org --organization

URL de organization Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide d’az devops configure -d organization=ORG_URL. Obligatoire s’il n’est pas configuré comme valeur par défaut ou récupéré par le biais de la configuration git. Exemple : https://dev.azure.com/MyOrganizationName/.

--reason

Raison de l’état de l’élément de travail.

--state

État de l’élément de travail (par exemple actif).

--title

Titre de l’élément de travail.

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