Skip to content

Latest commit

 

History

History
368 lines (262 loc) · 18.5 KB

add-teams.md

File metadata and controls

368 lines (262 loc) · 18.5 KB
title titleSuffix description ms.subservice ms.custom ms.assetid ms.author author ms.topic monikerRange ms.date
Create or add a team
Azure DevOps
Learn how to create or add a team to a project in Azure DevOps to scale your development processes, collaborate effectively, and manage project resources.
azure-devops-settings
teams, devx-track-azurecli
9F1D0A0F-02D5-4E06-A5EC-C220472A0F66
chcomley
chcomley
tutorial
<= azure-devops
11/12/2024

Create or add a team

[!INCLUDE version-lt-eq-azure-devops]

This article explains how to create new teams, add members, configure team settings, and follow best practices for team management in Azure DevOps.

As your organization grows, add teams to manage specific products, services, or feature areas. Equip teams with tools to manage backlogs, plan sprints, configure dashboards, define alerts, and set team favorites.

Each new project includes a default team named after the project that you can rename or reassign as needed.

To maintain Agile practices while scaling teams, review Scale Agile to Large Teams. For more information on team-configurable tools, see About teams and Agile tools.

Note

This article explains how to add teams or team members to an Azure DevOps project. For information on Microsoft Teams or integrating it with Azure Boards, see Welcome to Microsoft Teams or Use the Azure Boards app in Microsoft Teams.

To move work items between teams, see Move work items from one team to another.

Prerequisites

::: moniker range="azure-devops"

  • Permissions:
  • Azure CLI: To use Azure CLI commands, install Azure CLI as described in Get started with Azure DevOps CLI.
    ::: moniker-end ::: moniker range="< azure-devops" Permissions:
  • To create a team or set the default team, you must be a member of the Project Administrators group. Only members of the Project Administrators group can add and delete teams.
  • To add members to a team or change its configuration, be a team administrator or member of the Project Administrators group. ::: moniker-end

Create a team and add team members

To create a team, do the following steps.

Note

When you create a team, you can automatically generate the Area Path as a child node of the main project. To establish a hierarchical team structure, first define the Area Paths at the project level, then create your teams, and assign the appropriate Area Paths to each team. For more information, see Configure a hierarchy of teams.

::: moniker range="azure-devops"

From the Azure CLI tool, you can list teams, create a team, update a team configuration, and delete a team.

::: moniker-end

[!INCLUDE note-new-teams-page]

New Teams UI

::: moniker range="azure-devops"

  1. Sign in to your organization (https://dev.azure.com/{Your_Organization}).
  2. Select Project settings > Teams.

Screenshot of Open Project settings, and then Teams buttons on New Teams page.

  1. Select New team.

    :::image type="content" source="media/add-team/new-team-button-new-teams-preview.png" alt-text="Screenshot of choose New Team button, New Teams preview feature enabled.":::

  2. Enter a team name and the names of project members who you want to assign to the team. Optionally, enter a description. Add at least one name as a team Administrator. Select Create an area path with the name of the team, or leave it unchecked and assign the Area Path for the team after it gets created. You can choose an existing area path or add a new one at that time.

    :::image type="content" source="media/add-team/create-new-team-dialog-new-teams-preview.png" alt-text="Screenshot of Create a new team dialog, New Teams preview feature enabled.":::

    [!NOTE] Consider adding one or more users as team administrators. Team administrators have the necessary permissions to add team members and configure all team settings—including backlogs, boards, and Taskboards. For more information, see Manage and configure team tools.

  3. When you're ready, select Create.

  4. Select the team to add a team image, or configure other team elements.

  5. Select Settings to upload an image, change the team name, add a team administrator, or delete the team.

    :::image type="content" source="media/add-team/team-settings-dialog-new-teams-preview.png" alt-text="Screenshot of Team Settings dialog, New Teams preview feature enabled.":::

  6. Choose Save.

  7. Select Iterations and areas to set the Area Paths and Iteration Paths for the team to use.

    :::image type="content" source="media/add-team/team-settings-select-iterations-areas-new-teams-preview.png" alt-text="Screenshot of team settings, Iterations and areas highlighted, New Teams preview feature enabled.":::

    For more information, see the following articles:

::: moniker-end

::: moniker range="< azure-devops" Select the Current UI tab. The New Teams Page UI is only available for Azure DevOps Services. ::: moniker-end

Current UI

  1. Sign in to your organization (https://dev.azure.com/{Your_Organization}).

  2. Select Project settings > Teams.

    Screenshot of Open Project settings button, and then Teams button selection on Current page

  3. Select New team. Give the team a name, and optionally a description. Choose a security group to add team members to.

    Screenshot of New team subteam with its own area path on Current page

  4. When you're ready, select Create team. As the creator of the team, you automatically get added as the team administrator. You can remove yourself as an administrator and assign others to that role in the following steps.

  5. Select the team to add team administrators, team members, configure iterations and areas. The Team Profile opens.

From the team profile, you can do the following tasks:
- Add and remove team administrators - Manage team notifications - Set default team dashboard permissions - Define area paths and assign to a team
- Define iteration paths, also known as sprints, and configure team iterations.

Azure DevOps CLI

::: moniker range="azure-devops"

You can add a team using Azure DevOps team create. To get started, see Get started with Azure DevOps CLI.

[!div class="tabbedCodeSnippets"]

az devops team create --name [--description] [--project]

Parameters

  • name: Required. Name of the new team.
  • description: Optional. Description of the new team enclosed within parenthesis.
  • project: Optional. Name or ID of the project. Example: --project "Fabrikam Fiber".

Example

The following command adds a team named Production Planning to the fabrikamprime organization, Fabrikam Fiber project, and returns many properties assigned to the team in YAML output format.

[!div class="tabbedCodeSnippets"]

az devops team create --name "Production Planning" --description "Team tasked with planning operations and new processes." --output yaml
description: Team tasked with planning operations and new processes.

The YAML output listed as follows provides information on each of the attributes defined for the team.

[!div class="tabbedCodeSnippets"]

id: d3ee0804-601e-459b-ba31-c70d0153ee6b
identity:
  descriptor: Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1732201093-1654247747-2842177119-783707289-1-3902693433-3854875975-3003387648-1936292500
  id: d3ee0804-601e-459b-ba31-c70d0153ee6b
  isActive: true
  isContainer: true
  masterId: d3ee0804-601e-459b-ba31-c70d0153ee6b
  memberOf: []
  members: []
  metaTypeId: 255
  properties:
    Account:
      $type: System.String
      $value: Production Planning
    Description:
      $type: System.String
      $value: Team tasked with planning operations and new processes.
    Domain:
      $type: System.String
      $value: vstfs:///Classification/TeamProject/854a3f67-9962-43d1-a968-2e5f2eb66c99
    LocalScopeId:
      $type: System.String
      $value: 854a3f67-9962-43d1-a968-2e5f2eb66c99
    Microsoft.TeamFoundation.Team:
      $type: System.Boolean
      $value: true
    SchemaClassName:
      $type: System.String
      $value: Group
    ScopeId:
      $type: System.String
      $value: f0bedec1-eaee-4e51-ba15-01716ab2095e
    ScopeName:
      $type: System.String
      $value: Fabrikam Fiber
    ScopeType:
      $type: System.String
      $value: TeamProject
    SecuringHostId:
      $type: System.String
      $value: 5d5b8da6-3db7-4829-baf9-1e500c21cc12
    SecurityGroup:
      $type: System.String
      $value: SecurityGroup
    SpecialType:
      $type: System.String
      $value: Generic
    VirtualPlugin:
      $type: System.String
      $value: ''
  providerDisplayName: '[Fabrikam Fiber]\Production Planning'
  resourceVersion: 2
  subjectDescriptor: vssgp.Uy0xLTktMTU1MTM3NDI0NS0xNzMyMjAxMDkzLTE2NTQyNDc3NDctMjg0MjE3NzExOS03ODM3MDcyODktMS0zOTAyNjkzNDMzLTM4NTQ4NzU5NzUtMzAwMzM4NzY0OC0xOTM2MjkyNTAw
identityUrl: https://spsprodeus27.vssps.visualstudio.com/A5d5b8da6-3db7-4829-baf9-1e500c21cc12/_apis/Identities/d3ee0804-601e-459b-ba31-c70d0153ee6b
name: Production Plan
projectId: 854a3f67-9962-43d1-a968-2e5f2eb66c99
projectName: Fabrikam Fiber
url: https://fabrikamprime.visualstudio.com/_apis/projects/854a3f67-9962-43d1-a968-2e5f2eb66c99/teams/d3ee0804-601e-459b-ba31-c70d0153ee6b

::: moniker-end

[!INCLUDE note-cli-not-supported]

Upon creation of a team, the following items are automatically configured:

  • Security group with the team name containing the members assigned to the team, for example, [Fabrikam Fiber]\Production Planning. You can use this name to filter queries or to @mention all members of the team.
  • Default notifications assigned to the team. For more information, see Manage notifications for a team, project, or organization.
  • Default dashboard named Overview assigned to the team. To configure the dashboard, see Add widgets to a dashboard.

Important

Configuring the Area Paths and Iteration Paths used by the team is essential for many of the Azure Board tools to work, such as Backlogs, Boards, Sprints, and Delivery Plans. Team tools aren't available until the team's default area path is set. Area Paths and Iteration Paths are first configured for the project and then assigned or selected by the team.

If you are moving from one team to two or more teams, you may want to review and revise the Area Paths assigned to the default project team.

To configure other team features, see Manage teams and configure team tools.

Set the default project team

Each project has a default team assigned. You can change which project is assigned as the default with the following procedures.

New Teams UI

::: moniker range="azure-devops"

  1. Open Project settings > Teams as indicated in the previous section.

  2. Choose :::image type="icon" source="../../media/icons/more-actions.png" border="false"::: More options for the team you want to designate as the default, and choose Set team as project default.

    Screenshot of Teams page, More options menu selection, New Teams Page enabled.
    ::: moniker-end

::: moniker range="< azure-devops" Choose the Current UI tab. The New Teams Page UI is only available for Azure DevOps Services. ::: moniker-end

Current UI

::: moniker range=">= azure-devops-2019"

  1. Open Project settings > Teams as indicated in the previous section. ::: moniker-end

  2. Choose :::image type="icon" source="../../media/icons/actions-icon.png" border="false"::: to open the context menu for the team you want to designate as the default, and choose Set team as project default.

    Screenshot of Teams page, More options menu selection, New Teams Page enabled.

Azure DevOps CLI

::: moniker range="azure-devops" There isn't an Azure CLI command to set the default team project. ::: moniker-end

[!INCLUDE note-cli-not-supported]

::: moniker range="azure-devops"

List teams with Azure CLI

You can list teams using Azure DevOps team list. To learn how to list team members, see Add users to a team or project, List team members.

[!div class="tabbedCodeSnippets"]

az devops team list [--project]
                    [--skip]
                    [--top]

Tip

If you don't specify a top number, 100 teams are returned. To list all teams in a project, specify a number for top which is greater than the current number of teams defined.

Parameters

  • project: Optional. Name or ID of the project. Example: --project "Fabrikam Fiber." 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: Optional. Number of teams to skip.
  • top: Optional. Maximum number of teams to return.

Example

For example, the following command returns the 11 teams defined in the Fabrikam Fiber project. For addition output formats, see Output formats for Azure CLI commands.

Each team is assigned a unique ID.

[!div class="tabbedCodeSnippets"]

az devops team list --project "Fabrikam Fiber" --output table

The following table output provides information on each of the attributes defined for the team.

[!div class="tabbedCodeSnippets"]

ID                                    Name                Description
------------------------------------  ------------------  ----------------------------------------------------------------------------
7f099146-29a2-4798-9949-77c9f5f79653  Account Management  Management team focused on creating and maintaining customer services
2017b37a-486b-4222-ac84-b8b9eefa540e  Customer Profile    Feature team focused on securing account data
a90cd8f0-8e0d-42d6-aeb2-13442b826730  Email               Feature team delivering email apps
a48cb46f-7366-4f4b-baf5-b3632398ed1e  Fabrikam Team       The default project team. Was Fabrikam Fiber Team
e42fccbc-d96f-4c98-8168-7a85ecede548  Internet            Feature team developing web apps
b70aa504-33b4-4d17-a85d-0fbf4829a154  Phone               Feature team delivering phone apps
43e6bd2e-696f-492c-bbf7-9cde9cd420ea  Service Delivery    Management team responsible for ensure high performance delivery of services
8920d2ec-eed1-4792-8934-82a57abce7c2  Service Status      Feature team focused on monitoring and addressing service issues
9c676c8c-1910-4f73-b7b9-a946b5c551ae  Shopping Cart       Feature team managing shopping cart apps
64b86488-e105-4901-ba43-ffd48137bb93  TV                  Feature team developing TV apps
cda2b9b0-0335-4a0d-8bd0-67611d64ce9d  Voice               Feature team focused on voice communications

::: moniker-end

Grant team members permissions

For teams to work autonomously, give them permissions that they don't have by default. Suggested tasks include providing team administrators or team leads permissions to:

For more information on setting permissions and access for select users, see Set permissions and access for work tracking.

::: moniker range="< azure-devops-2022"

If your deployment is integrated with SQL Server Reports, you need to Grant permissions to view or create SQL Server reports to team members.

::: moniker-end

Next steps

[!div class="nextstepaction"] Move work items from one team to another team or Manage teams and configure team tools

Related articles

REST API Resources