重新命名或移除小組

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

隨著組織的發展，您可能需要重新命名或移除小組，以更符合新的角色、專案或組織結構。

當您重新命名小組時，新名稱會自動在整個 Azure DevOps 中傳播，確保一致性並避免混淆。 下列小組成品會自動重新命名：

• 小組安全組
• 小組待辦專案和面板
• 小組儀錶板

自動重新命名會維護訪問控制、專案追蹤和儀錶板設定，而不需手動更新。 拿掉小組會刪除其設定，並將其成員重新指派給其他小組，以確保工作流程持續性和組織清晰。

提示

更新參考舊小組安全組名稱的任何查詢。

刪除小組會移除所有組態設定，包括儀錶板、待辦專案和面板。 工作項目數據保持不變。 刪除之後無法復原小組組態。

必要條件

權限：

• 若要重新命名小組，請為小組管理員或 Project Administrators 群組的成員。
• 若要移除或刪除小組，請成為 Project Administrators 群組的成員。

重新命名小組

注意

若要啟用 [新增 Teams] 頁面的使用者介面，請參閱管理或啟用功能。

新增 Teams 頁面

1. 從入口網站中的項目，選取 [項目設定>Teams]。

   

2. 選擇您要重新命名的小組，然後選取 [ 設定]。

3. 在 [小組詳細數據] 底 下，輸入小組的新名稱。 選擇性地新增描述。

   

4. 儲存您的變更。

目前頁面

1. 從入口網站中的項目，選取 [項目設定>Teams]。

   

2. 選擇您想要重新命名的小組。 在 [小組配置檔] 底下，輸入新的名稱，並選擇性地更新描述。 儲存您的變更。

   

若要設定其他小組功能，請參閱 管理小組和設定小組工具。

Azure DevOps CLI

您可以使用 Azure DevOps 小組更新來重新命名小組或其描述。 如需詳細資訊，請參閱 開始使用 Azure DevOps CLI。

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

參數

• team：選擇性。 小組的名稱或標識碼。
• 描述：選擇性。 要套用至小組的描述。
• name：選擇性。 要套用的名稱以重新命名小組。
• org：選擇性。 組織的 URL。 您可以使用 來設定預設組織 az devops configure -d org=URL。 如果未設定為預設，或透過 git 組態挑選，則為必要專案。
• 項目：選擇性。 項目的名稱或識別碼。 範例：-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. 從入口網站中的項目，選取 [項目設定>Teams]，如上一節所示。

2. 選取您想要刪除的小組，然後選取 [ 設定]。

3. 向下捲動並選取 [ 刪除小組]。

   

4. 在確認方塊中選取 [ 刪除 ]，以完成刪除作業。

   

目前頁面

1. 從入口網站中的項目，針對您想要刪除的小組選取 [項目設定>Teams>...]，然後選取 [刪除]。

   

   重要

   刪除小組會刪除所有小組組態設定，包括小組儀錶板、待辦專案和面板。 針對指派給小組的工作專案所定義的數據會保持不變。 刪除之後，您無法復原小組組態。

2. 若要完成刪除作業，您必須輸入工作項目類型的名稱，如下列範例所示。

   

Azure DevOps CLI

您可以使用 az devops team delete 刪除小組。

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

參數

• id：必要。 要刪除之小組的標識碼。
• 項目：選擇性。 項目的名稱或識別碼。 範例：-project “Fabrikam Fiber”。
• 是：選擇性。 指定 不要提示確認。

範例

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