az boards work-item

Manage work items.

Commands

az boards work-item create

Create a work item.

az boards work-item delete

Delete a work item.

az boards work-item relation

Manage work item relations.

az boards work-item relation add

Add relation(s) to work item.

az boards work-item relation list-type

List work item relations supported in the organization.

az boards work-item relation remove

Remove relation(s) from work item.

az boards work-item relation show

Get work item, fill relations with friendly name.

az boards work-item show

Show details for a work item.

az boards work-item update

Update work items.

az boards work-item create

Create a work item.

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

Required Parameters

--title

Title of the work item.

--type

Name of the work item type (e.g. Bug).

Optional Parameters

--area

Area the work item is assigned to (e.g. Demos).

--assigned-to

Name of the person the work item is assigned-to (e.g. fabrikam).

--description -d

Description of the work item.

--detect

Automatically detect organization.

accepted values: false, true
--discussion

Comment to add to a discussion in a work item.

--fields -f

Space separated "field=value" pairs for custom fields you would like to set. Refer https://aka.ms/azure-devops-cli-field-api for more details on fields.

--iteration

Iteration path of the work item (e.g. DemosIteration 1).

--open

Open the work item in the default web browser.

--org --organization

Azure DevOps organization URL. You can configure the default organization using az devops configure -d organization=ORG_URL. Required if not configured as default or picked up via git config. Example: https://dev.azure.com/MyOrganizationName/.

--project -p

Name or ID of the project. You can configure the default project using az devops configure -d project=NAME_OR_ID. Required if not configured as default or picked up via git config.

--reason

Reason for the state of the work item.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

az boards work-item delete

Delete a work item.

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

Required Parameters

--id

Unique id of the work item.

Optional Parameters

--destroy

Permanently delete this work item.

--detect

Automatically detect organization.

accepted values: false, true
--org --organization

Azure DevOps organization URL. You can configure the default organization using az devops configure -d organization=ORG_URL. Required if not configured as default or picked up via git config. Example: https://dev.azure.com/MyOrganizationName/.

--project -p

Name or ID of the project. You can configure the default project using az devops configure -d project=NAME_OR_ID. Required if not configured as default or picked up via git config.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--yes -y

Do not prompt for confirmation.

az boards work-item show

Show details for a work item.

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

Required Parameters

--id

The ID of the work item.

Optional Parameters

--as-of

Work item details as of a particular date and time. Provide a date or date time string. Assumes local time zone. Example: '2019-01-20', '2019-01-20 00:20:00'. For UTC, append 'UTC' to the date time string, '2019-01-20 00:20:00 UTC'.

--detect

Automatically detect organization.

accepted values: false, true
--expand

The expand parameters for work item attributes.

accepted values: all, fields, links, none, relations
default value: all
--fields -f

Comma-separated list of requested fields. Example:System.Id,System.AreaPath. Refer https://aka.ms/azure-devops-cli-field-api for more details on fields.

--open

Open the work item in the default web browser.

--org --organization

Azure DevOps organization URL. You can configure the default organization using az devops configure -d organization=ORG_URL. Required if not configured as default or picked up via git config. Example: https://dev.azure.com/MyOrganizationName/.

--query-examples

Recommend JMESPath string for you. You can copy one of the query and paste it after --query parameter within double quotation marks to see the results. You can add one or more positional keywords so that we can give suggestions based on these key words.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

az boards work-item update

Update work items.

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

Required Parameters

--id

The id of the work item to update.

Optional Parameters

--area

Area the work item is assigned to (e.g. Demos).

--assigned-to

Name of the person the work item is assigned-to (e.g. fabrikam).

--description -d

Description of the work item.

--detect

Automatically detect organization.

accepted values: false, true
--discussion

Comment to add to a discussion in a work item.

--fields -f

Space separated "field=value" pairs for custom fields you would like to set. Refer https://aka.ms/azure-devops-cli-field-api for more details on fields.

--iteration

Iteration path of the work item (e.g. DemosIteration 1).

--open

Open the work item in the default web browser.

--org --organization

Azure DevOps organization URL. You can configure the default organization using az devops configure -d organization=ORG_URL. Required if not configured as default or picked up via git config. Example: https://dev.azure.com/MyOrganizationName/.

--reason

Reason for the state of the work item.

--state

State of the work item (e.g. active).

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--title

Title of the work item.