Start 命令 (Team Foundation Build)
更新：2007 年 11 月
使用 start 命令，运行配置的 Team Foundation Build 生成定义。
必需的权限
若要使用 start 命令，必须将 Team Foundation Server“启动生成”安全权限设置为“允许”。另外，应用层服务帐户和 Team Foundation Build 服务帐户必须具有对生成放置位置的读/写权限。有关更多信息，请参见 Team Foundation Server 权限。
.gif "说明") 说明： |
|---|
即使您是使用管理凭据登录的，也必须使用提升的权限打开命令提示窗口，才能在正在运行 Windows Server 2008 的服务器上执行此功能。若要使用提升的权限打开命令提示窗口，请单击“开始”，右击“命令提示符”，然后单击“以管理员身份运行”。有关更多信息，请参见 Microsoft 网站。 |
TFSBuild start /server:teamFoundationServer
/builddefinition:definitionSpec [/droplocations:dl] [/getoption:go]
[/customgetversion:versionSpec] [/priority:p] [/requestedfor:userName]
[/msbuildarguments:args] [/silent] [/queue]
TFSBuild start teamFoundationServer teamProject definitionName
[/droplocation:dl] [/getoption:go] [priority:p]
[/customversion:versionSpec] [/requestedfor:userName]
[/msbuildarguments:args] [/silent] [/queue]
参数
参数 |
说明 |
|---|---|
teamFoundationServer |
正在生成的解决方案签入的 Team Foundation 服务器 URL。 |
teamProject |
具有要生成的解决方案的团队项目的名称。 |
definitionName |
团队项目中要用于生成的生成定义的名称。 |
dl |
一旦生成完成，生成二进制文件和日志文件的公共文件夹的路径就会存储下来。例如，//server/share。该参数与 /droplocations 选项一起使用。 |
go |
与 /getoption 选项一起使用。值为 LatestOnQueue、LatestOnBuild 和 Custom 时有效。 |
versionSpec |
当 /getoption 设置为“Custom”时生成的文件版本。该参数与 /customgetversion 选项一起使用。 可以通过以下方式指定版本：
|
p |
生成定义要使用的队列优先级。该参数与 /priority 选项一起使用。 有效值为：Low、BelowNormal、Normal、AboveNormal 和 High。 |
userName |
正在请求生成的用户。 |
args |
要传递到 MSBuild 的命令行参数。 |
选项 |
说明 |
||
|---|---|---|---|
/droplocation |
可选。指定发生生成过程的目录。可以缩写为 /d。默认情况下使用“生成定义”中指定的生成目录。
|
||
/getoption |
可选。指定要从版本控制中获取的文件。 |
||
/customgetversion |
可选。当 /getoption 的值指定为“Custom”时，指定要获取的文件的自定义版本。 |
||
/priority |
可选。指定生成队列优先级。 |
||
/requestedfor |
可选。指定为其请求生成的人员。 |
||
/msbuildarguments |
可选。指定要传递到 MSBuild 的命令行参数。 常规格式为： /msbuildarguments:"/p:SomeProperty=SomeValue /t:MySpecialTarget" |
||
/silent |
可选。如果指定此选项，则在生成运行时，输出不会写入命令提示符窗口。 |
||
/queue |
将生成启动请求插入到生成队列中，然后立即返回。 |
备注
可以将 Team Foundation 命令行命令 TFSBuild start 与任务计划程序服务结合使用来执行定期或每夜生成。
如果生成多个解决方案，在确定它们的生成顺序时，应考虑一个解决方案与另一个解决方案之间的依赖关系。例如，如果 Solution2 依赖 Solution1，则设置 Solution1 在 Solution2 之前生成。
默认情况下，放置目录不会自动作为共享创建。因此，它不适用于发布生成和测试结果。必须手动建立共享，向 Windows 目录添加写权限，并为运行 Team Build Service 的帐户添加共享权限以放置生成，为测试人员帐户添加共享权限以发布测试结果。
示例
下面的示例在 server01 上的 AdventureWorks 团队项目中生成 Nightlies 生成类型。得到的生成位于 BuildDrop 目录中。
>TFSBuild start http://server01:8080 /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops"
下面的示例在 server01 上的 AdventureWorks 团队项目中生成 Nightlies 生成类型。得到的生成位于 BuildDrop 目录中。使用 /msbuildarguments 选项，可以传入 MSBuild“Diagnostic”详细级别。有关更多信息，请参见 MSBuild 命令行参考。
>TFSBuild start http://server01:8080 /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops" /msbuildarguments:"/flp:verbosity=diag"