チームを名前変更または削除する

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

組織が変更されると、チームの名前を変更または削除することが必要になる場合があります。

チームの名前を変更すると、新しい名前が Azure DevOps 全体に反映されます。 次のチーム 成果物の名前が自動的に変更されます。

• チーム セキュリティ グループ
• チームのバックログとボード
• チーム ダッシュボード

ヒント

古いチーム セキュリティ グループ名を参照するすべてのクエリを更新します。

チームを削除または削除すると、そのすべての構成設定が削除されます。 これらの設定には、チーム ダッシュボード、バックログ、ボードが含まれます。 チームに割り当てられている作業項目に対して定義されたデータは変更されません。 一度削除すると、チーム構成を回復することはできません。

前提条件

アクセス許可:

• チーム管理者またはプロジェクト管理者グループ: チームの名前を変更するには、チーム管理者または Project Administrators グループのメンバーである必要があります。
• プロジェクト管理者グループ: チームを削除するには、 Project Administrators グループのメンバーである必要があります。

チームの名前を変更する

Note

New Teams ページのユーザー インターフェイスを有効にするには管理または機能の有効化を参照してください。

[新しい Teams] ページ

1. Web ポータルでプロジェクトから Project settings>Teams を選択します。

   

2. 名前を変更するチームを選択し、 Settings を選択します。

3. Team の詳細で、チームの新しい名前を入力します。 必要に応じて、新しい説明を追加します。

   

4. 変更内容を保存します。

現在のページ

1. Web ポータルでプロジェクトから Project settings>Teams を選択します。

   

2. 名前を変更するチームを選択します。 [チーム プロファイル] で、新しい名前を入力し、必要に応じて説明を更新します。 変更内容を保存します。

   

その他のチーム機能を構成するには、 チームの管理とチーム ツールの構成に関するを参照してください。

Azure DevOps CLI

Azure DevOps チームの更新を使用して、チームまたはその説明の名前を変更できます。 詳細については、「 Azure DevOps CLI の概要」を参照してください。

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

パラメーター

• team: 省略可能。 チームの名前または ID。
• description: 省略可能。 チームに適用する説明。
• name: 省略可能。 チームの名前を変更するために適用する名前。
• org: 省略可能。 組織の URL。 az devops configure -d org=URL を使用して、既定の組織を構成できます。 既定として構成されていない場合、または git config を使って取得されていない場合は必須です。
• project: 省略可能。 プロジェクトの名前または 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. 新しい既定値としてチームの横にある [その他オプション] を選択し、[チームプロジェクトの既定値として設定] を選択します。

チームの削除

既定のチームを除く任意のチームを削除できます。 1 つのプロジェクトに対して少なくとも 1 つのチームを定義する必要があります。

重要

チームを削除すると、すべてのチーム構成設定 (ダッシュボード、バックログ、ボード) が削除されます。 作業項目データは変更されません。 一度削除すると、チーム構成を回復することはできません。

Note

New Teams ページのユーザー インターフェイスを有効にするには管理または機能の有効化を参照してください。

[新しい Teams] ページ

1. Web ポータルでプロジェクトから、前のセクションに示すように Project settings>Teams を選択します。

2. 削除するチームを選択し、 Settings を選択します。

3. 下にスクロールし、[チームの削除] 選択。

   

4. 確認ボックスで Delete を選択して削除操作を完了します。

   

現在のページ

1. Web ポータルでプロジェクトから、削除するチームの Project settings>Teams>... を選択し、 Delete を選択します。

   

   重要

   チームを削除すると、チーム ダッシュボード、バックログ、ボードなど、すべてのチーム構成設定が削除されます。 チームに割り当てられた作業項目に対して定義されたデータは変更されません。 一度削除すると、チーム構成を回復することはできません。

2. 削除操作を完了するには、次の例に示すように、作業項目の種類の名前を入力する必要があります。

   

Azure DevOps CLI

devops チームの削除を使用して、チームを削除できます。

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

パラメーター

• id: 必須。 削除するチームの ID。
• project: 省略可能。 プロジェクトの名前または 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
• チーム (REST API)
• 作業項目 (REST API)