Workspace 命令

项目
08/18/2008

更新：2007 年 11 月

允许您创建、删除、查看或修改与工作区关联的属性和映射。

必需的权限

若要修改或删除现有工作区，您必须是其所有者或者将全局“管理工作区”权限设置为“允许”。若要创建工作区，您必须将全局“创建工作区”权限设置为“允许”。若要为其他用户创建工作区，您必须将“管理工作区”权限设置为“允许”。有关更多信息，请参见 Team Foundation Server 权限。

tf workspace /new [/noprompt] [/template:workspacename[;workspaceowner]]
 [/computer:computername] [/comment:(“comment”|@comment file)]
 [/s:servername] [workspacename[;workspaceowner]]

tf workspace /delete [/server:servername] workspacename[;workspaceowner]

tf workspace [/server:servername] [/comment: (“comment”|@comment file)] [/newname:workspacename]
 [workspacename[;workspaceowner]]

参数

参数	说明
workspacename	指定要创建、编辑、删除或显示其相关信息的工作区的名称。
workspaceowner	指定工作区的用户名。当执行该命令的人员不是工作区所有者时需要此参数。
computername	向 /computer 选项提供值。
comment	向 /comment 选项提供值。
@commentfile	指定文件路径，应从该路径读取注释。
servername	用户提供的 /server 选项的值。例如，teamfoundation2。

选项	说明
/new	创建一个新工作区。
/template	指定一个现有工作区，该工作区将用作创建新工作区的模板。新工作区使用现有工作区的映射。
/delete	删除指定的工作区。
/computer	指定要创建工作区的计算机的名称。此选项为高级选项。
/comment	提供注释，对工作区做出说明。
/server	标识 Team Foundation Server。创建新工作区以及尝试从未映射到工作区的目录启动 workspace 命令时，此选项是必须的。
/newname	重命名现有工作区。
/noprompt	在不显示对话框的情况下执行指定的工作区命令。

备注

工作区是服务器上文件和文件夹的本地副本，以及您在本地进行的任何更改。当您添加、编辑、删除、移动、重命名或以其他方式更改任何受版本控制的项时，所做的更改在您的工作区中是独立的，您可以在该工作区内执行和测试更改。当您执行签入时，挂起的更改将提交到服务器，并且您的工作区以外的其他用户可以使用它们。

有关如何查找 tf 命令行实用工具的更多信息，请参见 Tf 命令行实用工具命令。

创建一个新工作区

必须首先创建一个工作区或将现有工作区与当前目录相关联，才能向版本控制服务器中添加文件或从该服务器签出项，并对它们进行编辑。有关更多信息，请参见如何：创建映射的工作区。

若要将当前目录作为计算机上现有工作区的工作文件夹，请键入 tf workspaceworkspacename，其中 workspacename 是现有工作区的名称。将出现“编辑工作区”对话框。单击“单击此处输入一个新的工作文件夹”，在“源代码管理文件夹”框中键入要映射当前目录的服务器路径，在“本地文件夹”框中键入当前目录，再单击“确定”。

创建新的工作区时，您可以指定“模板工作区”作为 /new 选项的一部分。指定模板工作区时，Team Foundation 在当前计算机上创建一个新的工作区，设置所有者为当前所有者，并将下列工作区属性从模板工作区复制到新工作区：映射和注释。如果未指定名称，系统将使用基于当前计算机名称的名称。使用模板创建工作区时，Team Foundation 不检索从服务器映射的文件。使用 Get 命令将新的工作区与服务器上的最新版本同步。

单个文件夹映射

您可以选择仅将某个版本控制文件夹的直属子级映射到本地工作区。为此，请在“添加工作区”对话框的“源代码管理文件夹”框中添加星号通配符。例如，$/folder/*。否则，在默认情况下，版本控制文件夹的所有子级都将以递归方式映射到本地工作区。

版本控制层次结构中的单文件夹映射对下载到客户端计算机的项数进行了限制，因此它非常有用。限制下载文件数的另一个方法是，掩蔽那些工作区中不需要的文件。有关更多信息，请参见如何：掩蔽或取消掩蔽工作区中的文件夹。这缩短了下载时间并节省了客户端计算机上的磁盘空间。

删除工作区

如果删除包含挂起更改的工作区，作为删除过程的一部分，Team Foundation 会取消这些挂起更改。删除工作区不会删除客户端计算机上包含在该工作区中的文件和文件夹。

编辑工作区

可以更改下列工作区属性：

工作区名称
注释
工作文件夹映射

如果未提供工作区规范，则使用当前文件夹的工作区。

示例

下面的示例将打开“添加工作区”对话框并创建新的工作区。您可以使用“添加工作区”对话框来编辑源代码管理文件夹、所有者、计算机、注释和本地文件夹。

c:\projects>tf workspace /new /server:teamserver2

下面的示例创建名为 Beta1 的新工作区，并分配 jenh 作为工作区所有者。您必须拥有 AdminWorkspaces 权限才能将新工作区的所属权分配给其他用户。有关安全权限的更多信息，请参见 Team Foundation Server 权限。

c:\projects>tf workspace /new Beta1;jenh

下面的示例使用 jenh 拥有的 Beta1 工作区作为模板创建一个新工作区。

c:\projects>tf workspace /new /template:Beta1;jenh /server:teamserver2

下面的示例从系统中移除 Beta1 工作区。

c:\projects>tf workspace /delete Beta1

下面的示例编辑当前工作区的属性。

c:\projects>tf workspace

下面的示例打开所有者为用户 jenh 的 Beta1 工作区，以便您可以看到其属性和映射。如果您具有 AdminWorkspaces 权限，则可以更改该工作区的属性和映射。

c:\projects> tf workspace Beta1;jenh

请参见

通过