Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
As your organization changes, you may need to rename or remove a team.
When you rename a team, the new name propagates throughout Azure DevOps. The following team artifacts are automatically renamed:
Team security group
Team backlogs and boards
Team dashboards
Tip
Update any queries that reference the old team security group name.
When you remove or delete a team, all of its configuration settings get deleted. These settings include team dashboards, backlogs, and boards. Data defined for work items that are assigned to the team are left unchanged. Once deleted, you can't recover the team configurations.
az devops team update --team
[--description]
[--name]
[--org]
[--project]
Parameters
team: Optional. Name or ID of a team.
description: Optional. Description to apply to the team.
name: Optional. Name to apply to rename the team.
org: Optional. URL of organization. You can configure the default organization using az devops configure -d org=URL. Required if not configured as default or picked up via git config.
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.
Example
For example, the following command renames the Account Management team to Organization Management. For addition output formats, see Output formats for Azure CLI commands.
Azure DevOps CLI commands aren't supported for Azure DevOps Server on-premises.
Set a team as the default
When a project is created, a default team is created based on the project name.
To change the default, open Project Settings>Teams, choose
More options next to the team you want as the new default, and select Set team as project default.
Delete a team
You can delete any team except the default team. At least one team must be defined for a project.
Important
Deleting a team deletes all team configuration settings, including team dashboards, backlogs, and boards. Data defined for work items assigned to the team are left unchanged. Once deleted, you can't recover the team configurations.
From the web portal, choose Project settings and open Teams as shown in the previous section.
Choose the team you want to delete and then scroll down to the Delete Team section. Choose Delete Team.
Choose Delete in the confirmation box to complete the delete operation.
The New Teams user interface isn't supported for Azure DevOps Server 2020 and earlier versions.
To delete a team, choose Project Settings > Teams > … for the team you want to delete, and select the Delete option.
Important
Deleting a team deletes all team configuration settings, including team dashboards, backlogs, and boards. Data defined for work items assigned to the team are left unchanged. Once deleted, you can't recover the team configurations.
To complete the delete operation, you must enter the name of the WIT as shown.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.