Partager via

az boards work-item

  • Référence

Remarque

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 . En savoir plus 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 d’é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]
                           [--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

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

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

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

URL de l’organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=ORG_URL. Obligatoire si la valeur n’est pas configurée par défaut ni récupérée via git config. 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 s’il n’est pas configuré par défaut ou récupéré via la configuration git.

--reason

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

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

Supprimez un élément de travail.

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

Paramètres obligatoires

--id

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

Paramètres facultatifs

--destroy

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

Valeur par défaut: False
--detect

Détectez automatiquement l’organisation.

Valeurs acceptées: false, true
--org --organization

URL de l’organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=ORG_URL. Obligatoire si la valeur n’est pas configurée par défaut ni récupérée via git config. 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 s’il n’est pas configuré par défaut ou récupéré via la configuration git.

--yes -y

Ne pas demander de confirmation.

Valeur par défaut: False
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 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]

Paramètres obligatoires

--id

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

Paramètres facultatifs

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

Valeurs acceptées: false, true
--expand

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

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

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

--open

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

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

URL de l’organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=ORG_URL. Obligatoire si la valeur n’est pas configurée par défaut ni récupérée via git config. Exemple : https://dev.azure.com/MyOrganizationName/.

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 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]
                           [--reason]
                           [--state]
                           [--title]

Paramètres obligatoires

--id

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

Paramètres facultatifs

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

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

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

URL de l’organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=ORG_URL. Obligatoire si la valeur n’est pas configurée par défaut ni récupérée via git config. 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 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.