将工作项从一个团队移到另一个团队

项目
01/07/2025

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

添加团队或重新组织现有团队时，可能需要通过更新其区域路径将工作项从一个团队转移到另一个团队。 Azure DevOps 中的每个工作项都分配给区域路径，该路径确定团队所有权并影响工作项在积压工作和板上的显示方式。

“要求”类别下分类的工作项根据团队的区域路径分配显示在团队积压工作上。同样，将其他工作项分配给团队的区域路径支持基于团队所有权的查询和报告。

先决条件

权限：
- 若要查看、关注和编辑工作项，请在此节点中查看工作项，并在此节点权限中编辑工作项设置为“允许”。 默认情况下，参与者组具有这些权限。有关详细信息，请参阅设置工作跟踪权限。
若要将标记添加到工作项，请将项目级 “创建新标记定义 ”权限设置为“ 允许”。默认情况下，参与者组拥有此权限。
访问级别：
- 成为项目成员。
- 若要向工作项添加新标记或查看或关注拉取请求，请至少具有基本访问权限。
- 若要查看或关注工作项，至少 具有利益干系人 访问权限。有关详细信息，请参阅关于访问级别。
- 所有项目成员（包括读者组中的项目成员）都可以发送电子邮件，其中包含工作项。
注意
- 为希望参与讨论和评审进度的成员提供利益干系人访问权限。这些成员通常不参与代码，但想要查看工作项、积压工作、面板和仪表板。
- 默认情况下，公共项目中所有 参与者 和 利益干系人 都可以添加新和现有标记。在专用项目中，利益干系人只能添加现有标记。若要控制创建新标记的能力，请在项目级别设置 创建标记定义 权限。有关详细信息，请参阅更改项目级权限。

注意

为希望参与讨论和评审进度的成员提供利益干系人访问权限。这些成员通常不参与代码，但想要查看工作项、积压工作、面板和仪表板。

区域路径权限：查看和编辑区域路径节点下工作项。有关详细信息，请参阅“ 修改区域或迭代路径”下的工作项。
配置的区域路径：确保目标团队已正确配置其区域路径。否则，在传输工作项之前设置所需的区域路径。
一致的进程模型：Teams 应使用兼容的进程模型（继承的、托管的 XML 或本地 XML）来确保工作项的无缝移动。
备份工作项：建议在执行批量移动之前备份或导出工作项，以防止发生错误时数据丢失。
工具：若要使用 Azure CLI 命令，请安装 Azure CLI，如 Azure DevOps CLI 入门中所述。

权限：
- 若要查看、关注和编辑工作项，请在此节点中查看工作项，并在此节点权限中编辑工作项设置为“允许”。 默认情况下，参与者组具有这些权限。有关详细信息，请参阅设置工作跟踪权限。
若要将标记添加到工作项，请将项目级 “创建新标记定义 ”权限设置为“ 允许”。默认情况下，参与者组拥有此权限。
访问级别：
- 成为项目成员。
- 若要向工作项添加新标记或查看或关注拉取请求，请至少具有基本访问权限。
- 若要查看或关注工作项，至少 具有利益干系人 访问权限。有关详细信息，请参阅关于访问级别。
- 所有项目成员（包括读者组中的项目成员）都可以发送电子邮件，其中包含工作项。
注意
- 为希望参与讨论和评审进度的成员提供利益干系人访问权限。这些成员通常不参与代码，但想要查看工作项、积压工作、面板和仪表板。
- 默认情况下，公共项目中所有 参与者 和 利益干系人 都可以添加新和现有标记。在专用项目中，利益干系人只能添加现有标记。若要控制创建新标记的能力，请在项目级别设置 创建标记定义 权限。有关详细信息，请参阅更改项目级权限。

注意

为希望参与讨论和评审进度的成员提供利益干系人访问权限。这些成员通常不参与代码，但想要查看工作项、积压工作、面板和仪表板。

区域路径权限：有权查看和编辑区域路径节点下的工作项。有关详细信息，请参阅“ 修改区域或迭代路径”下的工作项。

在团队下移动工作项

若要在团队下移动工作项，请执行以下步骤：

为要重新分配的所有工作项创建查询。
多选这些属于每个团队的项，然后批量编辑区域路径。

Web 门户，“查询”页，批量修改所选工作项的屏幕截图。

批量修改后，批量保存。

批量保存已编辑的工作项的屏幕截图。

使用 Azure CLI 移动工作项

可以通过更新其区域路径，使用 az boards 工作项更新移动单个工作项。

az boards work-item update --id
                           [--area]
                           [--assigned-to]
                           [--description]
                           [--discussion]
                           [--fields]
                           [--iteration]
                           [--open]
                           [--reason]
                           [--state]
                           [--title]

参数

id：必需。要更新的工作项的 ID。
area：可选。区域的绝对路径。示例：--path \ProjectName\Area\AreaName。
assigned-to：可选。人员的姓名，工作项分配给了 Jamal。
description：可选。工作项的说明。
discussion：可选。要添加到工作项中的讨论的注释。
fields：可选。要设置的自定义字段的空格分隔“字段=值”对。
iteration：可选。迭代的绝对路径。示例：\ProjectName\Iteration\IterationName。
open：可选。在默认 Web 浏览器中打开工作项。
reason：可选。工作项状态的原因。
state：可选。工作项的状态，例如：“活动”。
title：可选。工作项的标题。

示例

使用 Azure DevOps CLI 一次只能移动一个工作项。在此示例中，我们移动 Fabrikam Fiber\Production Planning 区域路径下的工作项 ID=148。

az boards work-item update --id 148 --area "Fabrikam Fiber\Production Planning" --output yaml

以下 YAML 输出提供有关为工作项定义的每个字段的信息。

fields:
  Microsoft.VSTS.Common.Priority: 2
  Microsoft.VSTS.Common.StackRank: 1500000001.0
  Microsoft.VSTS.Common.StateChangeDate: '2021-11-23T22:26:28.27Z'
  Microsoft.VSTS.Common.ValueArea: Business
  System.AreaPath: Fabrikam Fiber\Production Planning
  System.AssignedTo:
    _links:
      avatar:
        href: https://fabrikamprime.visualstudio.com/_apis/GraphProfile/MemberAvatars/aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    descriptor: aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    displayName: Jamal Hartnett
    id: d291b0c4-a05c-4ea6-8df1-4b41d5f39eff
    imageUrl: https://fabrikamprime.visualstudio.com/_apis/GraphProfile/MemberAvatars/aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    uniqueName: fabrikamfiber4@hotmail.com
    url: https://spsprodeus27.vssps.visualstudio.com/A5d5b8da6-3db7-4829-baf9-1e500c21cc12/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff
  System.BoardColumn: Backlog
  System.ChangedBy:
   _links:
      avatar:
        href: https://fabrikamprime.visualstudio.com/_apis/GraphProfile/MemberAvatars/aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    descriptor: aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    displayName: Jamal Hartnett
    id: d291b0c4-a05c-4ea6-8df1-4b41d5f39eff
    imageUrl: https://fabrikamprime.visualstudio.com/_apis/GraphProfile/MemberAvatars/aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    uniqueName: fabrikamfiber4@hotmail.com
    url: https://spsprodeus27.vssps.visualstudio.com/A5d5b8da6-3db7-4829-baf9-1e500c21cc12/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff
  System.ChangedDate: '2022-05-19T22:58:52.93Z'
  System.CommentCount: 0
  System.CreatedBy:
   _links:
      avatar:
        href: https://fabrikamprime.visualstudio.com/_apis/GraphProfile/MemberAvatars/aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    descriptor: aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    displayName: Jamal Hartnett
    id: d291b0c4-a05c-4ea6-8df1-4b41d5f39eff
    imageUrl: https://fabrikamprime.visualstudio.com/_apis/GraphProfile/MemberAvatars/aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    uniqueName: fabrikamfiber4@hotmail.com
    url: https://spsprodeus27.vssps.visualstudio.com/A5d5b8da6-3db7-4829-baf9-1e500c21cc12/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff
  System.CreatedDate: '2021-11-23T22:26:28.27Z'
  System.Description: <div>This user story is for documentation purposes.&nbsp; </div>
  System.IterationPath: Fabrikam Fiber\Release 2\Sprint 1
  System.Reason: New
  System.State: New
  System.TeamProject: Fabrikam Fiber
  System.Title: Test the Request feedback functionality
  System.WorkItemType: User Story
  WEF_10182DA5BCCD4CE2A43629FFBD290EF2_Kanban.Column: Backlog
id: 148
relations:
- attributes:
    isLocked: false
    name: Child
  rel: System.LinkTypes.Hierarchy-Forward
  url: https://fabrikamprime.visualstudio.com/854a3f67-9962-43d1-a968-2e5f2eb66c99/_apis/wit/workItems/152
- attributes:
    isLocked: false
    name: Child
  rel: System.LinkTypes.Hierarchy-Forward
  url: https://fabrikamprime.visualstudio.com/854a3f67-9962-43d1-a968-2e5f2eb66c99/_apis/wit/workItems/153
- attributes:
    isLocked: false
    name: Child
  rel: System.LinkTypes.Hierarchy-Forward
  url: https://fabrikamprime.visualstudio.com/854a3f67-9962-43d1-a968-2e5f2eb66c99/_apis/wit/workItems/151
- attributes:
    isLocked: false
    name: Child
  rel: System.LinkTypes.Hierarchy-Forward
  url: https://fabrikamprime.visualstudio.com/854a3f67-9962-43d1-a968-2e5f2eb66c99/_apis/wit/workItems/149
rev: 5
url: https://fabrikamprime.visualstudio.com/854a3f67-9962-43d1-a968-2e5f2eb66c99/_apis/wit/workItems/148

验证可见性

将工作项从一个团队移动到另一个团队后，如果没有看到工作项，请执行以下操作：

刷新：如果新添加的工作项未显示，请刷新面板或选择显示更多项。
验证团队：检查是否选择了正确的团队，以确保项目出现在积压工作中。
验证区域路径：验证移动的工作项是否分配给与团队积压工作对应的正确区域路径。每个团队都有特定的区域路径，用于确定哪些工作项出现在待办事项列表上。此操作对于确保积压工作中的可见性至关重要。
验证迭代路径：检查该冲刺的迭代路径。冲刺积压工作仅显示分配给所选冲刺的迭代路径的工作项。
验证工作项类型和筛选器：检查积压工作项筛选器以及工作项类型是否已正确分类，以确保显示所有相关项目。

有关详细信息，请参阅设置项目的积压工作和面板。

通过

将工作项从一个团队移到另一个团队

先决条件

在团队下移动工作项

使用 Azure CLI 移动工作项

参数

示例

验证可见性

反馈

其他资源

通过

将工作项从一个团队移到另一个团队

先决条件

在团队下移动工作项

使用 Azure CLI 移动工作项

参数

示例

验证可见性

相关文章

反馈

其他资源