az devops team

Note

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

Manage teams.

Commands

az devops team create

Create a team.

az devops team delete

Delete a team.

az devops team list

List all teams in a project.

az devops team list-member

List members of a team.

az devops team show

Show team details.

az devops team update

Update a team's name and/or description.

az devops team create

Create a team.

az devops team create --name
                      [--description]
                      [--detect {false, true}]
                      [--org]
                      [--project]

Required Parameters

--name

Name of the new team.

Optional Parameters

--description

Description of the new team.

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

az devops team delete

Delete a team.

az devops team delete --id
                      [--detect {false, true}]
                      [--org]
                      [--project]
                      [--yes]

Required Parameters

--id

The id of the team to delete.

Optional Parameters

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

--yes -y

Do not prompt for confirmation.

default value: False

az devops team list

List all teams in a project.

az devops team list [--detect {false, true}]
                    [--org]
                    [--project]
                    [--skip]
                    [--top]

Optional Parameters

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

--skip

Number of teams to skip.

--top

Maximum number of teams to return.

az devops team list-member

List members of a team.

az devops team list-member --team
                           [--detect {false, true}]
                           [--org]
                           [--project]
                           [--skip]
                           [--top]

Required Parameters

--team

The name or id of the team to show members of.

Optional Parameters

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

--skip

Number of members to skip.

--top

Maximum number of members to return.

az devops team show

Show team details.

az devops team show --team
                    [--detect {false, true}]
                    [--org]
                    [--project]

Required Parameters

--team

The name or id of the team to show.

Optional Parameters

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

az devops team update

Update a team's name and/or description.

az devops team update --team
                      [--description]
                      [--detect {false, true}]
                      [--name]
                      [--org]
                      [--project]

Required Parameters

--team

The name or id of the team to be updated.

Optional Parameters

--description

New description of the team.

--detect

Automatically detect organization.

accepted values: false, true
--name

New name of the team.

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