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

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 を使用する
• Teams REST API を使用する
• 作業項目 REST API を使用する