Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The GetBuildProperties task outputs the initial values for the build properties.
Parameters
Parameter |
Description |
|---|---|
TeamFoundationServerUrl |
Specifies the Team Foundation Server URL. For example, http://MyServer:8080. |
BuildUri |
Specifies the build URI. |
BuildAgentName |
Output parameter. Specifies the build agent name. |
BuildAgentUri |
Output parameter. Specifies the build agent URI. |
BuildDirectory |
Output parameter. Specifies the build directory on the build agent. |
BuildDefinitionName |
Output parameter. Specifies the build definition name. |
BuildDefinitionUri |
Output parameter. Specifies the build definition URI. |
BuildNumber |
Output parameter. Specifies the build number. |
CompilationStatus |
Output parameter. Specifies the status of the compilation phase of this build. Possible values are Unknown or Failed. |
CompilationSuccess |
Output parameter. Deprecated. |
ConfigurationFolderUri |
Output parameter. Specifies the source control URI of the folder in which TFSBuild.proj and TFSBuild.rsp files are stored. |
Droplocation |
Output parameter. Specifies the shared folder where the build binaries and log files are stored. |
LabelName |
Output parameter. Specifies the name of the label that is being created for the build. |
LastChangedBy |
Output parameter. Specifies the user who changed this build most recently. |
LastChangedOn |
Output parameter. Specifies the date and time when this build was changed most recently. |
LogLocation |
Output parameter. Specifies the location of the log file for this build. |
MachineName |
Output parameter. Specifies the name for the build agent computer. |
MaxProcesses |
Output parameter. Specifies the maximum number of processes that can run on the build agent. |
Port |
Output parameter. Specifies the port that is used to communicate with Team Foundation application services. |
Quality |
Output parameter. Specifies the quality of this build. |
Reason |
Output parameter. Specifies the internal name that indicates whether the build was queued manually by a user or automatically by the build definition trigger). |
RequestedBy |
Output parameter. Specifies the person who requested the build. |
RequestedFor |
Output parameter. Specifies the person on whose behalf the build was requested. |
SourceGetVersion |
Output parameter. Indicates the version specification of the files that were downloaded from version control. |
StartTime |
Output parameter. Specifies the build start time. |
Status |
Output parameter. Specifies the overall status of this build. |
TeamProject |
Output parameter. Specifies the team project that owns this build. |
TestStatus |
Output parameter. Specifies the status of the test phase of this build. Possible values are Unknown or Failed. |
TestSuccess |
Output parameter. Deprecated. |
Remarks
The GetBuildProperties task is defined in the Microsoft.TeamFoundation.Build.Tasks.VersionControl.dll. The Microsoft.TeamFoundation.Build.targets file contains an instance of the GetBuildProperties task that Team Foundation Build uses as a default implementation for the InitializeBuildProperties target.
The <root>:\Program Files\MSBuild\Microsoft\VisualStudio\TeamBuild folder on the Team Foundation Build computer contains the Microsoft.TeamFoundation.Build.targets file.
Example
The following example shows the default instance of GetBuildProperties task defined in the Microsoft.TeamFoundation.Build.targets file.
<GetBuildProperties TeamFoundationServerUrl="$(TeamFoundationServerUrl)"
BuildUri="$(BuildUri)">
<Output TaskParameter="BuildAgentName" PropertyName="BuildAgentName" />
<Output TaskParameter="BuildAgentUri" PropertyName="BuildAgentUri" />
<Output TaskParameter="BuildDirectory" PropertyName="BuildDirectory" />
<Output TaskParameter="BuildDefinitionName" PropertyName="BuildDefinitionName" />
<Output TaskParameter="BuildDefinitionUri" PropertyName="BuildDefinitionUri" />
<Output TaskParameter="BuildNumber" PropertyName="BuildNumber" />
<Output TaskParameter="CompilationStatus" PropertyName="CompilationStatus" />
<Output TaskParameter="CompilationSuccess" PropertyName="CompilationSuccess" />
<Output TaskParameter="ConfigurationFolderUri" PropertyName="ConfigurationFolderUri" />
<Output TaskParameter="ConfigurationFolderGetTime" PropertyName="ConfigurationFolderGetTime" />
<Output TaskParameter="DropLocation" PropertyName="DropLocation" />
<Output TaskParameter="LabelName" PropertyName="FullLabelName" />
<Output TaskParameter="LastChangedBy" PropertyName="LastChangedBy" />
<Output TaskParameter="LastChangedOn" PropertyName="LastChangedOn" />
<Output TaskParameter="LogLocation" PropertyName="LogLocation" />
<Output TaskParameter="MachineName" PropertyName="MachineName" />
<Output TaskParameter="MaxProcesses" PropertyName="MaxProcesses" />
<Output TaskParameter="Port" PropertyName="Port" />
<Output TaskParameter="Quality" PropertyName="Quality" />
<Output TaskParameter="Reason" PropertyName="Reason" />
<Output TaskParameter="RequestedBy" PropertyName="RequestedBy" />
<Output TaskParameter="RequestedFor" PropertyName="RequestedFor" />
<Output TaskParameter="SourceGetVersion" PropertyName="SourceGetVersion" />
<Output TaskParameter="StartTime" PropertyName="StartTime" />
<Output TaskParameter="Status" PropertyName="Status" />
<Output TaskParameter="TeamProject" PropertyName="TeamProject" />
<Output TaskParameter="TestStatus" PropertyName="TestStatus" />
<Output TaskParameter="TestSuccess" PropertyName="TestSuccess" />
</GetBuildProperties>