取消保留命令 (Team Foundation 版本控制)

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Visual Studio 2022 |Visual Studio 2019 |Visual Studio 2017 |Visual Studio 2015 |Visual Studio 2013

unshelve 命令会将搁置的文件修订、签入笔记、注释和工作项关联还原到当前工作区,或者从服务器中删除现有货架集。

先决条件

若要使用 unshelve 命令,必须具有“允许”的“读取”权限,并且必须具有“签出”权限,才能将货架集中的项目设置为“允许”。 此外,若要删除货架集,你必须是其所有者,或者将 “管理”搁置的全局 权限设置为 “允许”。 有关详细信息,请参阅 默认 TFVC 权限

语法

tf unshelve [/move] [shelvesetname[;username]] itemspec 
[/recursive] [/noprompt][/login:username,[password]]

参数

参数

Argument

说明

shelvesetname

要还原的架子集的名称。

ownername

货架集所有者的名称。

Itemspec

标识要取消保留到当前工作区中的文件或文件夹修订。 如果不包括此参数,则默认情况下,指定货架集中的所有挂起更改均未保存。 不允许使用服务器路径。

有关 Team Foundation 如何分析 itemspecs 以确定哪些项目在范围内的详细信息,请参阅 使用 Team Foundation 版本控制命令、使用选项修改命令功能的方式

注意

可以指定多个 Itemspec 参数。

username

提供 /login 选项的值。 可以将用户名值指定为 DOMAIN\UserNameUserName

选项

选项

说明

/move

成功完成未维护操作后,从 Server for Team Foundation 版本控制中删除指定的货架集。 此选项不能与 itemspec 结合使用。

还可以使用 “搁置 ”命令删除货架集。

/recursive

如果指定,则以递归方式匹配 itemspec。

/noprompt

如果指定,则不会提示输入。

/login

指定使用Azure DevOps对用户进行身份验证的用户名和密码。

注解

tf 命令行实用工具的未保留命令检索所有搁置文件修订或从 Team Foundation 服务器到当前工作区的所有搁置文件修订的已定义子集。

若要取消保留某个项,目标工作区中不得对其执行挂起的修订。

取消保留货架集时,Team Foundation 会将每个搁置的修订还原到目标工作区中,前提是修订与工作区中已挂起的更改不冲突。 有关在未维护过程中发生的情况的更多详细信息,请参阅 “使用货架集”。

可以使用 unshelve 命令将单个文件修订从货架集还原到工作区。 在取消保护后,应运行 get,以协调自创建货架集以来签入服务器的任何更改。

有关如何查找 tf 命令行实用工具的详细信息,请参阅 使用 Team Foundation 版本控制命令

回收搁置更改

如果要将搁置修订集成到当前工作区中,以便进行正在进行的修订,请取消保留所需的货架集。 最佳做法是在取消保护后获取最新版本的版本控制文件。

取消保留并查看其他用户的代码

还可以取消保留货架集,以便查看其他用户工作区中的更改。 为此,若要取消保留,有两个选项。

  • 如果搁置的项目及其相关项尚未修订,或仅从创建货架集后轻量修订,则可以从货架集所有者工作区中检索所有相关项目的基版本。 为此,请使用以下命令的一些变体: tf get \* /version;Wworkspacename其中 workspacename 是其他用户在其中创建了货架集的工作区的名称。

  • 如果已过大量时间,或者自创建货架集以来工作区中已有多个修订,请从服务器检索自创建货架集的日期和时间起所有相关项的版本。

通过将用户名追加到架子集名称,可以取消保留其他用户的搁置更改。 但是,如果拥有 AdminShelvedChangesets 权限,则只能从其他用户创建的Team Foundation Server中删除货架集。

如果尝试取消保留目标工作区中存在挂起更改的项目,Team Foundation 不会合并项目之间的差异,也不会检索修订到工作区中。

可以使用 tf shelve /delete.. 有关详细信息,请参阅 Shelve 命令。 若要在取消保护整个货架集后自动删除货架集,请使用 tf unshelve /move

示例

以下示例打开 “取消保留 ”对话框,以便可以在当前工作区中找到并取消保留货架集。 在取消保留操作完成后,还可以在对话框中选择删除货架集。

c:\>tf unshelve

以下示例将货架集buddytest_1256解开到当前工作区中,并将其从Team Foundation Server中删除。

c:\>tf unshelve /move buddytest_1256