重命名或删除团队

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

随着组织的发展，可能需要重命名或删除团队，以便更好地与新角色、项目或组织结构保持一致。

重命名团队时，新名称会自动在整个 Azure DevOps 中传播，确保一致性并避免混淆。 以下团队项目会自动重命名：

• 团队安全组
• 团队积压工作和版块
• 团队仪表板

自动重命名可维护访问控制、项目跟踪和仪表板配置，而无需手动更新。 删除团队会删除其配置，并将其成员重新分配给其他团队，确保工作流连续性和组织清晰。

提示

更新引用旧团队安全组名称的任何查询。

删除团队会删除所有配置设置，包括仪表板、积压工作和版块。 工作项数据保持不变。 删除后无法恢复团队配置。

先决条件

权限：

• 若要重命名团队，请成为团队管理员或项目管理员组的成员。
• 若要删除或删除团队，请成为项目管理员组的成员。

重命名团队

注意

若要为 “新建 Teams”页启用用户界面，请参阅 “管理”或“启用功能”。

“新建 Teams”页

1. 在 Web 门户中的项目中，选择“项目设置>Teams”。

   

2. 选择要重命名的团队，然后选择“ 设置”。

3. 在“团队详细信息”下，输入团队的新名称。 （可选）添加新说明。

   

4. 保存所做更改。

当前页

1. 在 Web 门户中的项目中，选择“项目设置>Teams”。

   

2. 选择要重命名的团队。 在“团队配置文件”下，输入新名称并根据需要更新说明。 保存所做更改。

   

若要配置其他团队功能，请参阅 “管理团队”和“配置团队工具”。

Azure DevOps CLI

可以使用 Azure DevOps 团队更新重命名团队或其说明。 有关详细信息，请参阅 Azure DevOps CLI 入门。

az devops team update --team
                      [--description]
                      [--name]
                      [--org]
                      [--project]

参数

• 团队：可选。 团队的名称或 ID。
• description：可选。 应用于团队的说明。
• name：可选。 要应用于重命名团队的名称。
• org：可选。 组织的 URL。 可以使用 配置默认组织 az devops configure -d org=URL。 如果未配置为默认或通过 git 配置进行选取，则为必需。
• 项目：可选。 项目的名称或 ID。 示例：--project“Fabrikam Fiber”。可以使用 .. 配置默认项目 az devops configure -d project=NAME_OR_ID。 如果未配置为默认或通过 git 配置进行选取，则为必需。

示例

例如，以下命令将帐户管理团队重命名为组织管理。 有关添加输出格式，请参阅 Azure CLI 命令的输出格式。

az devops team update --team "Account Management" --name "Organization Management" --description "Management team focused on creating and maintaining customer services for organizations"
{
  "description": "Management team focused on creating and maintaining customer services for organizations",
  "id": "7f099146-29a2-4798-9949-77c9f5f79653",
  "identity": {
    "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-227716950-993605186-2584159299-2630527068-1-4146437839-3810360391-2614259327-2922617790",
    "id": "7f099146-29a2-4798-9949-77c9f5f79653",
    "isActive": true,
    "isContainer": true,
    "masterId": "7f099146-29a2-4798-9949-77c9f5f79653",
    "memberOf": [],
    "members": [],
    "metaTypeId": 255,
    "properties": {
      "Account": {
        "$type": "System.String",
        "$value": "Account Management"
      },
      "Description": {
        "$type": "System.String",
        "$value": "Management team focused on creating and maintaining customer services"
      },
      "Domain": {
        "$type": "System.String",
        "$value": "vstfs:///Classification/TeamProject/56af920d-393b-4236-9a07-24439ccaa85c"
      },
      "LocalScopeId": {
        "$type": "System.String",
        "$value": "56af920d-393b-4236-9a07-24439ccaa85c"
      },
      "Microsoft.TeamFoundation.Team": {
        "$type": "System.String",
        "$value": "True"
      },
      "SchemaClassName": {
        "$type": "System.String",
        "$value": "Group"
      },
      "ScopeId": {
        "$type": "System.String",
        "$value": "e03662ad-bec4-4a33-bb0f-86e365ee2d88"
      },
      "ScopeName": {
        "$type": "System.String",
        "$value": "Fabrikam Fiber"
      },
      "ScopeType": {
        "$type": "System.String",
        "$value": "TeamProject"
      },
      "SecuringHostId": {
        "$type": "System.String",
        "$value": "380ed149-33d0-4d78-a7ed-89921802f389"
      },
      "SecurityGroup": {
        "$type": "System.String",
        "$value": "SecurityGroup"
      },
      "SpecialType": {
        "$type": "System.String",
        "$value": "Generic"
      },
      "VirtualPlugin": {
        "$type": "System.String",
        "$value": ""
      }
    },
    "providerDisplayName": "[Fabrikam Fiber]\\Account Management",
    "resourceVersion": 2,
    "subjectDescriptor": "vssgp.Uy0xLTktMTU1MTM3NDI0NS0yMjc3MTY5NTAtOTkzNjA1MTg2LTI1ODQxNTkyOTktMjYzMDUyNzA2OC0xLTQxNDY0Mzc4MzktMzgxMDM2MDM5MS0yNjE0MjU5MzI3LTI5MjI2MTc3OTA"
  },
  "identityUrl": "https://spsprodeus21.vssps.visualstudio.com/A380ed149-33d0-4d78-a7ed-89921802f389/_apis/Identities/7f099146-29a2-4798-9949-77c9f5f79653",
  "name": "Organization Management",
  "projectId": "56af920d-393b-4236-9a07-24439ccaa85c",
  "projectName": "Fabrikam Fiber",
  "url": "https://dev.azure.com/fabrikam/_apis/projects/56af920d-393b-4236-9a07-24439ccaa85c/teams/7f099146-29a2-4798-9949-77c9f5f79653"
}

将团队设置为默认值

创建项目时，还会根据项目名称创建默认团队。

1. 打开 项目设置>Teams。
2. 选择要 作为新默认值的团队旁边的更多选项 ，然后选择“ 将团队设置为项目默认值”。

删除团队

可以删除除默认团队以外的任何团队。 必须为项目定义至少一个团队。

重要

删除团队会删除所有团队配置设置（仪表板、积压工作板、版块）。 工作项数据保持不变。 删除后，无法恢复团队配置。

注意

若要为 “新建 Teams”页启用用户界面，请参阅 “管理”或“启用功能”。

“新建 Teams”页

1. 在 Web 门户中的项目中，选择“项目设置>Teams”，如上一部分所示。

2. 选择要删除的团队，然后选择“ 设置”。

3. 向下滚动并选择“ 删除团队”。

   

4. 在确认框中选择“删除”以完成删除操作。

   

当前页

1. 在 Web 门户中的项目中，选择要删除的团队的项目设置>Teams>，然后选择“删除”。

   

   重要

   删除团队会删除所有团队配置设置，包括团队仪表板、积压工作和板。 为分配给团队的工作项定义的数据保持不变。 删除后，无法恢复团队配置。

2. 若要完成删除操作，必须输入工作项类型的名称，如以下示例所示。

   

Azure DevOps CLI

可以使用 az devops team delete 删除团队。

az devops team delete --id
                      [--project]
                      [--yes]

参数

• id：必需。 要删除的团队的 ID。
• 项目：可选。 项目的名称或 ID。 示例：--project“Fabrikam Fiber”。
• yes：可选。 指定不提示确认。

示例

az devops team delete --id 5385556a-254d-4ad4-bd11-71955e3a7070 --project "Fabrikam Fiber"
Are you sure you want to delete this team? (y/n): y

相关文章

• 添加团队
• 了解团队和敏捷工具
• 使用 Azure DevOps Teams CLI
• 使用 Teams REST API
• 使用工作项 REST API