az boards

Note

This reference is part of the azure-devops extension for Azure CLI and requires version 2.2.0 or higher. The extension will automatically install the first time you run an az boards command. Learn more about extensions.

Manage Azure Boards.

This command group is a part of the azure-devops extension.

Commands

az boards area

Manage area paths.

az boards area project

Manage areas for a project.

az boards area project create

Create area.

az boards area project delete

Delete area.

az boards area project list

List areas for a project.

az boards area project show

Show area details for a project.

az boards area project update

Update area.

az boards area team

Manage areas for a team.

az boards area team add

Add area to a team.

az boards area team list

List areas for a team.

az boards area team remove

Remove area from a team.

az boards area team update

Update team area.

az boards iteration

Manage iterations.

az boards iteration project

Manage iterations for a project.

az boards iteration project create

Create iteration.

az boards iteration project delete

Delete iteration.

az boards iteration project list

List iterations for a project.

az boards iteration project show

Show iteration details for a project.

az boards iteration project update

Update project iteration.

az boards iteration team

Manage iterations for a team.

az boards iteration team add

Add iteration to a team.

az boards iteration team list

List iterations for a team.

az boards iteration team list-work-items

List work-items for an iteration.

az boards iteration team remove

Remove iteration from a team.

az boards iteration team set-backlog-iteration

Set backlog iteration for a team.

az boards iteration team set-default-iteration

Set default iteration for a team.

az boards iteration team show-backlog-iteration

Show backlog iteration for a team.

az boards iteration team show-default-iteration

Show default iteration for a team.

az boards query

Query for a list of work items.

az boards work-item

Manage work items.

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 query

Query for a list of work items.

Only supports flat queries.

az boards query [--detect {false, true}]
                [--id]
                [--org]
                [--path]
                [--project]
                [--wiql]

Optional Parameters

--detect

Automatically detect organization.

accepted values: false, true
--id

The ID of an existing query. Required unless --path or --wiql are specified.

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

--path

The path of an existing query. Ignored if --id is specified.

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

--wiql

The query in Work Item Query Language format. Ignored if --id or --path is specified.