az boards work-item

Nota

Questo riferimento fa parte dell'estensione azure-devops per l'interfaccia della riga di comando di Azure (versione 2.30.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az boards work-item . Altre informazioni sulle estensioni.

Gestire gli elementi di lavoro.

Comandi

Nome Descrizione Tipo Stato
az boards work-item create

Creare un elemento di lavoro.

Estensione Disponibilità generale
az boards work-item delete

Eliminare un elemento di lavoro.

Estensione Disponibilità generale
az boards work-item relation

Gestire le relazioni tra elementi di lavoro.

Estensione Disponibilità generale
az boards work-item relation add

Aggiungere relazioni all'elemento di lavoro.

Estensione Disponibilità generale
az boards work-item relation list-type

Elencare le relazioni tra elementi di lavoro supportate nell'organizzazione.

Estensione Disponibilità generale
az boards work-item relation remove

Rimuovere le relazioni dall'elemento di lavoro.

Estensione Disponibilità generale
az boards work-item relation show

Ottiene l'elemento di lavoro, riempie le relazioni con il nome descrittivo.

Estensione Disponibilità generale
az boards work-item show

Mostra i dettagli per un elemento di lavoro.

Estensione Disponibilità generale
az boards work-item update

Aggiornare gli elementi di lavoro.

Estensione Disponibilità generale

az boards work-item create

Creare un elemento di lavoro.

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

Parametri necessari

--title

Titolo dell'elemento di lavoro.

--type

Nome del tipo di elemento di lavoro ,ad esempio Bug.

Parametri facoltativi

--area

Area a cui è assegnato l'elemento di lavoro (ad esempio Demo).

--assigned-to

Nome della persona a cui viene assegnato l'elemento di lavoro, ad esempio fabrikam.

--description -d

Descrizione dell'elemento di lavoro.

--detect

Rilevare automaticamente l'organizzazione.

valori accettati: false, true
--discussion

Commento da aggiungere a una discussione in un elemento di lavoro.

--fields -f

Spaziare coppie "field=value" separate per i campi personalizzati da impostare. In caso di più campi: "field1=value1" "field2=value2". Per altri dettagli sui campi, vedere https://aka.ms/azure-devops-cli-field-api .

--iteration

Percorso di iterazione dell'elemento di lavoro (ad esempio Demos\Iteration 1).

--open

Aprire l'elemento di lavoro nel Web browser predefinito.

valore predefinito: False
--org --organization

URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--project -p

Nome o ID del progetto. È possibile configurare il progetto predefinito usando az devops configure -d project=NAME_OR_ID. Obbligatorio se non è configurato come predefinito o selezionato tramite git config.

--reason

Motivo dello stato dell'elemento di lavoro.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az boards work-item delete

Eliminare un elemento di lavoro.

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

Parametri necessari

--id

ID univoco dell'elemento di lavoro.

Parametri facoltativi

--destroy

Eliminare definitivamente questo elemento di lavoro.

valore predefinito: False
--detect

Rilevare automaticamente l'organizzazione.

valori accettati: false, true
--org --organization

URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--project -p

Nome o ID del progetto. È possibile configurare il progetto predefinito usando az devops configure -d project=NAME_OR_ID. Obbligatorio se non è configurato come predefinito o selezionato tramite git config.

--yes -y

Indica che non è richiesta la conferma.

valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az boards work-item show

Mostra i dettagli per un elemento di lavoro.

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

Parametri necessari

--id

ID dell'elemento di lavoro.

Parametri facoltativi

--as-of

Dettagli dell'elemento di lavoro a partire da una data e un'ora specifiche. Specificare una stringa di data o di data. Presuppone il fuso orario locale. Esempio: '2019-01-20', '2019-01-20 00:20:00'. Per l'ora UTC, aggiungere 'UTC' alla stringa di data e ora '2019-01-20 00:20:00 UTC'.

--detect

Rilevare automaticamente l'organizzazione.

valori accettati: false, true
--expand

Parametri di espansione per gli attributi dell'elemento di lavoro.

valori accettati: all, fields, links, none, relations
valore predefinito: all
--fields -f

Elenco delimitato da virgole di campi richiesti. Esempio:System.Id,System.AreaPath. Per altri dettagli sui campi, vedere https://aka.ms/azure-devops-cli-field-api .

--open

Aprire l'elemento di lavoro nel Web browser predefinito.

valore predefinito: False
--org --organization

URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az boards work-item update

Aggiornare gli elementi di lavoro.

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

Parametri necessari

--id

ID dell'elemento di lavoro da aggiornare.

Parametri facoltativi

--area

Area a cui è assegnato l'elemento di lavoro (ad esempio Demo).

--assigned-to

Nome della persona a cui viene assegnato l'elemento di lavoro, ad esempio fabrikam.

--description -d

Descrizione dell'elemento di lavoro.

--detect

Rilevare automaticamente l'organizzazione.

valori accettati: false, true
--discussion

Commento da aggiungere a una discussione in un elemento di lavoro.

--fields -f

Spaziare coppie "field=value" separate per i campi personalizzati da impostare. Per altri dettagli sui campi, vedere https://aka.ms/azure-devops-cli-field-api .

--iteration

Percorso di iterazione dell'elemento di lavoro (ad esempio Demos\Iteration 1).

--open

Aprire l'elemento di lavoro nel Web browser predefinito.

valore predefinito: False
--org --organization

URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--reason

Motivo dello stato dell'elemento di lavoro.

--state

Stato dell'elemento di lavoro (ad esempio attivo).

--title

Titolo dell'elemento di lavoro.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.