CreateWorkspaceTask 任务

更新:2007 年 11 月

CreateWorkspaceTask 任务用 TFSBuild.proj 文件中指定的名称和映射文件创建一个工作区。

参数

参数

说明

TeamFoundationServerUrl

指定 Team Foundation Server URL。例如,http://MyServer:8080。

BuildUri

指定生成 URI。

BuildDirectory

指定生成目录。

SourcesDirectory

指定源文件的解决方案根目录。

Name

指定工作区名称。

默认情况下,Team Foundation Build 创建的获取源文件的工作区为 $(COMPUTERNAME)$(TeamProject)$(BuildType)。

重写 TFSBuild.proj 文件中的 WorkspaceName 属性以使用自定义的工作区名称。

说明:

WorkspaceName 属性还可以用于生成 VersionToLabel 属性。因此,如果您以编程方式重写 WorkspaceName,请确保也要重写 VersionToLabel。

Comment

默认情况下,由 Team Foundation Build 创建的工作区的注释为“Workspace created by Team Build”[工作区由 Team Build 创建]。

若要指定另一个注释,请重写 TFSBuild.proj 文件中的 CreateWorkspaceTaskComment 属性。

Name

字符串输出参数。它指定属性 WorkspaceName 的值。

Owner

字符串输出参数。它指定属性 WorkspaceOwner 的值。

备注

CreateWorkspaceTask 任务在 Microsoft.TeamFoundation.Build.Tasks.VersionControl.dll 中定义。Microsoft.TeamFoundation.Build.targets 文件包含 CreateWorkspaceTask 任务的一个实例,Team Foundation Build 使用该实例作为 InitializeWorkspace 目标的默认实现。

Team Foundation Build 计算机上的 <根>:\Program Files\MSBuild\Microsoft\VisualStudio\TeamBuild 文件夹包含 Microsoft.TeamFoundation.Build.targets 文件。

示例

下面的示例演示 Microsoft.TeamFoundation.Build.targets 文件中定义的 CreateWorkspaceTask 任务的默认实例。

<CreateWorkspaceTask
    TeamFoundationServerUrl="$(TeamFoundationServerUrl)"
    BuildUri="$(BuildUri)"
    BuildDirectory="$(BuildDirectory)"
    SourcesDirectory="$(SolutionRoot)"
    Name="$(WorkspaceName)"
    Comment="$(CreateWorkspaceTaskComment)">
    <Output TaskParameter="Name" PropertyName="WorkspaceName" />
    <Output TaskParameter="Owner" PropertyName="WorkspaceOwner" />
    </CreateWorkspaceTask>

请参见

任务

演练:通过命令行使用 Team Foundation 版本控制

如何:创建映射的工作区

如何:掩蔽或取消掩蔽工作区中的文件夹

如何:自定义内部版本号

概念

了解 Team Foundation Build 配置文件

使用版本控制工作区

Team Foundation Build 任务

参考

Workspace 命令

其他资源

自定义 Team Foundation Build

Team Foundation Build 目标、任务和属性