Execute Batch File After Tfs Build Properties

Автор:
Execute Batch File After Tfs Build Properties Average ratng: 7,8/10 8051 reviews
-->

MSBuild is the build platform for Microsoft and Visual Studio. This walkthrough introduces you to the building blocks of MSBuild and shows you how to write, manipulate, and debug MSBuild projects. You will learn about:

2 Responses to How to run batch file after TFS build Prashant says: February 9, 2014 at 11:43 am Hi Chan, Can you send me xaml template that does this batch file execute i have batch file to be executed on remote server after TFS build and publish website. Just hoping there's an obvious TFS build workflow setting I missed. Jan 16, 2015  In the previous blog post: Deployment to several databases using SQL Server Data Tools and Team foundation Server I illustrated how it is possible to use TFS and a batch file to deploy a database to several SQL Server instances or to deploy several SQL Server databases to several instances. The main way to achieve that in the previous post was using a batch file.

You can run MSBuild from Visual Studio, or from the Command Window. In this walkthrough, you create an MSBuild project file using Visual Studio. You edit the project file in Visual Studio, and use the Command Window to build the project and examine the results.

Create an MSBuild project

The Visual Studio project system is based on MSBuild. This makes it easy to create a new project file using Visual Studio. In this section, you create a Visual C# project file. You can choose to create a Visual Basic project file instead. In the context of this walkthrough, the difference between the two project files is minor.

To create a project file

  1. Open Visual Studio and create a project.

    Press Esc to close the start window. Type Ctrl + Q to open the search box, type winforms, then choose Create a new Windows Forms App (.NET Framework). In the dialog box that appears, choose Create.

    In the Name box, type BuildApp. Enter a Location for the solution, for example, D:. Accept the defaults for Solution, Solution Name (BuildApp), and Framework.

    From the top menu bar, choose File > New > Project. In the left pane of the New Project dialog box, expand Visual C# > Windows Desktop, then choose Windows Forms App (.NET Framework). Then choose OK.

    In the Name box, type BuildApp. Enter a Location for the solution, for example, D:. Accept the defaults for Create directory for solution (selected), Add to Source Control (not selected), and Solution Name (BuildApp).

  2. Click OK or Create to create the project file.

Examine the project file

In the previous section, you used Visual Studio to create a Visual C# project file. The project file is represented in Solution Explorer by the project node named BuildApp. You can use the Visual Studio code editor to examine the project file.

To examine the project file

  1. In Solution Explorer, click the project node BuildApp.

  2. In the Properties browser, notice that the Project File property is BuildApp.csproj. All project files are named with the suffix proj. If you had created a Visual Basic project, the project file name would be BuildApp.vbproj.

  3. Right-click the project node again, then click Edit BuildApp.csproj.

    The project file appears in the code editor.

Note

For some project types, such as C++, you need to unload the project (right-click on the project file and choose Unload project) before you can open and edit the project file.

Targets and tasks

Project files are XML-formatted files with the root node Project.

Newer .NET Core (SDK-style) projects have a Sdk attribute.

If the project is not an SDK-style project, you must specify the xmlns namespace in the Project element. If ToolsVersion is present in a new project, it must be '15.0'.

The work of building an application is done with Target and Task elements.

  • A task is the smallest unit of work, in other words, the 'atom' of a build. Tasks are independent executable components which may have inputs and outputs. There are no tasks currently referenced or defined in the project file. You add tasks to the project file in the sections below. For more information, see the Tasks topic.

  • A target is a named sequence of tasks. For more information, see the Targets topic.

  • [it might be a named sequence of tasks, but critically, it represents something to be built or done, so it should be defined in a goal-oriented way]

The default target is not defined in the project file. Instead, it is specified in imported projects. The Import element specifies imported projects. For example, in a C# project, the default target is imported from the file Microsoft.CSharp.targets.

Imported files are effectively inserted into the project file wherever they are referenced.

In SDK-style projcts, you don't see this import element, since the SDK attribute causes this file to be imported implicitly.

MSBuild keeps track of the targets of a build, and guarantees that each target is built no more than once.

Add a target and a task

Add a target to the project file. Add a task to the target that prints out a message.

To add a target and a task

  1. Add these lines to the project file, just after the Import statement:

    This creates a target named HelloWorld. Notice that you have IntelliSense support while editing the project file.

  2. Add lines to the HelloWorld target, so that the resulting section looks like this:

  3. Save the project file.

The Message task is one of the many tasks that ships with MSBuild. For a complete list of available tasks and usage information, see Task reference.

The Message task takes the string value of the Text attribute as input and displays it on the output device (or writes it to one or more logs, if applicable). The HelloWorld target executes the Message task twice: first to display 'Hello', and then to display 'World'.

Build the target

If you try to build this project from Visual Studio, it won't build the target you defined. That's because Visual Studio chooses the default target, which is still the one in the imported .targets file.

Run MSBuild from the Developer Command Prompt for Visual Studio to build the HelloWorld target defined above. Use the -target or -t command-line switch to select the target.

Note

We will refer to the Developer Command Prompt as the Command Window in the sections below.

To build the target:

  1. Open the Command Window.

    (Windows 10) In the search box on the taskbar, start typing the name of the tool, such as dev or developer command prompt. This brings up a list of installed apps that match your search pattern.

    If you need to find it manually, the file is LaunchDevCmd.bat in the <visualstudio installation folder><version>Common7Tools folder.

  2. From the command window, navigate to the folder containing the project file, in this case, D:BuildAppBuildApp.

  3. Run msbuild with the command switch -t:HelloWorld. This selects and builds the HelloWorld target:

  4. Examine the output in the Command window. You should see the two lines 'Hello' and 'World':

Note

If instead you see The target 'HelloWorld' does not exist in the project then you probably forgot to save the project file in the code editor. Save the file and try again.

By alternating between the code editor and the command window, you can change the project file and quickly see the results.

Build properties

Build properties are name-value pairs that guide the build. Several build properties are already defined at the top of the project file:

All properties are child elements of PropertyGroup elements. The name of the property is the name of the child element, and the value of the property is the text element of the child element. For example,

defines the property named TargetFrameworkVersion, giving it the string value 'v4.5'.

Build properties may be redefined at any time. If

appears later in the project file, or in a file imported later in the project file, then TargetFrameworkVersion takes the new value 'v3.5'.

Examine a property value

To get the value of a property, use the following syntax, where PropertyName is the name of the property:

Use this syntax to examine some of the properties in the project file.

To examine a property value

  1. From the code editor, replace the HelloWorld target with this code:

  2. Save the project file.

  3. From the Command Window, enter and execute this line:

  4. Examine the output. You should see these two lines (your .NET Framework version may differ):

Conditional properties

Many properties like Configuration are defined conditionally, that is, the Condition attribute appears in the property element. Conditional properties are defined or redefined only if the condition evaluates to 'true'. Note that undefined properties are given the default value of an empty string. For example,

means 'If the Configuration property has not been defined yet, define it and give it the value 'Debug'.

Almost all MSBuild elements can have a Condition attribute. For more discussion about using the Condition attribute, see Conditions.

Reserved properties

MSBuild reserves some property names to store information about the project file and the MSBuild binaries. MSBuildToolsPath is an example of a reserved property. Reserved properties are referenced with the $ notation like any other property. For more information, see How to: Reference the name or location of the project file and MSBuild reserved and well-known properties.

Environment variables

You can reference environment variables in project files the same way as build properties. For example, to use the PATH environment variable in your project file, use $(Path). If the project contains a property definition that has the same name as an environment variable, the property in the project overrides the value of the environment variable. For more information, see How to: Use environment variables in a build.

Set properties from the command line

Properties may be defined on the command line using the -property or -p command line switch. Property values received from the command line override property values set in the project file and environment variables.

To set a property value from the command line:

  1. From the Command Window, enter and execute this line:

  2. Examine the output. You should see this line:

MSBuild creates the Configuration property and gives it the value 'Release'.

Special characters

Certain characters have special meaning in MSBuild project files. Examples of these characters include semicolons (;) and asterisks (*). In order to use these special characters as literals in a project file, they must be specified by using the syntax %<xx>, where <xx> represents the ASCII hexadecimal value of the character.

Change the Message task to show the value of the Configuration property with special characters to make it more readable.

To use special characters in the Message task:

  1. From the code editor, replace both Message tasks with this line:

  2. Save the project file.

  3. From the Command Window, enter and execute this line:

  4. Examine the output. You should see this line:

For more information, see MSBuild special characters.

Build items

An item is a piece of information, typically a file name, that is used as an input to the build system. For example, a collection of items representing source files might be passed to a task named Compile to compile them into an assembly.

All items are child elements of ItemGroup elements. The item name is the name of the child element, and the item value is the value of the Include attribute of the child element. The values of items with the same name are collected into item types of that name. For example,

defines an item group containing two items. The item type Compile has two values: Program.cs and PropertiesAssemblyInfo.cs.

The following code creates the same item type by declaring both files in one Include attribute, separated by a semicolon.

For more information, see Items.

Note

File paths are relative to the folder containing the MSBuild project file, even if the project file is an imported project file. There are a few exceptions to this, such as when using Import and UsingTask elements.

Examine item type values

To get the values of an item type, use the following syntax, where ItemType is the name of the item type:

Use this syntax to examine the Compile item type in the project file.

To examine item type values:

  1. From the code editor, replace the HelloWorld target task with this code:

  2. Save the project file.

  3. From the Command Window, enter and execute this line:

  4. Examine the output. You should see this long line:

The values of an item type are separated with semicolons by default.

To change the separator of an item type, use the following syntax, where ItemType is the item type and Separator is a string of one or more separating characters:

Change the Message task to use carriage returns and line feeds (%0A%0D) to display Compile items one per line.

To display item type values one per line

  1. From the code editor, replace the Message task with this line:

  2. Save the project file.

  3. From the Command Window, enter and execute this line:

  4. Examine the output. You should see these lines:

Include, Exclude, and wildcards

You can use the wildcards '*', '**', and '?' with the Include attribute to add items to an item type. For example,

adds all files with the file extension .jpeg in the images folder to the Photos item type, while

adds all files with the file extension .jpeg in the images folder, and all its subfolders, to the Photos item type. For more examples, see How to: Select the files to build.

Notice that as items are declared they are added to the item type. For example,

creates an item type named Photo containing all files in the images folder with a file extension of either .jpeg or .gif. This is equivalent to the following line:

You can exclude an item from an item type with the Exclude attribute. For example,

adds all files with the file extension .cs to the Compile item type, except for files whose names contain the string Designer. For more examples, see How to: Exclude files from the build.

The Exclude attribute only affects the items added by the Include attribute in the item element that contains them both. For example,

would not exclude the file Form1.cs, which was added in the preceding item element.

To include and exclude items

  1. From the code editor, replace the Message task with this line:

  2. Add this item group just after the Import element:

  3. Save the project file.

  4. From the Command Window, enter and execute this line:

  5. Examine the output. You should see this line:

Item metadata

Items may contain metadata in addition to the information gathered from the Include and Exclude attributes. This metadata can be used by tasks that require more information about items than just the item value.

Item metadata is declared in the project file by creating an element with the name of the metadata as a child element of the item. An item can have zero or more metadata values. For example, the following CSFile item has Culture metadata with a value of 'Fr':

To get the metadata value of an item type, use the following syntax, where ItemType is the name of the item type and MetaDataName is the name of the metadata:

To examine item metadata:

  1. From the code editor, replace the Message task with this line:

  2. Save the project file.

  3. From the Command Window, enter and execute this line:

  4. Examine the output. You should see these lines:

Notice how the phrase 'Compile.DependentUpon' appears several times. The use of metadata with this syntax within a target causes 'batching'. Batching means that the tasks within the target are executed once for each unique metadata value. This is the MSBuild script equivalent of the common 'for loop' programming construct. For more information, see Batching.

Well-known metadata

Whenever an item is added to an item list, that item is assigned some well-known metadata. For example, %(Filename) returns the file name of any item. For a complete list of well-known metadata, see Well-known item metadata.

To examine well-known metadata:

  1. From the code editor, replace the Message task with this line:

  2. Save the project file.

  3. From the Command Window, enter and execute this line:

  4. Examine the output. You should see these lines:

By comparing the two examples above, you can see that while not every item in the Compile item type has DependentUpon metadata, all items have the well-known Filename metadata.

Metadata transformations

Item lists can be transformed into new item lists. To transform an item list, use the following syntax, where <ItemType> is the name of the item type and <MetadataName> is the name of the metadata:

For example, an item list of source files can be transformed into a collection of object files using an expression like @(SourceFiles -> '%(Filename).obj'). For more information, see Transforms.

To transform items using metadata:

  1. From the code editor, replace the Message task with this line:

  2. Save the project file.

    So you’re a Skype user and someone said something a few days ago in an IM or in a voicemail on the service and you need to find it? Skype for business logs stored on mac. Skype is installed on my Nexus, PC, MacBook, and even my iPad. Using services such as Skype Out and Skype In, you can actually replace a business line with Skype, making it easier to conduct business whenever and wherever you may be at the time the call comes in. Believe it or not, finding these old records in Skype is actually quite easy, as long as you’re at the same computer on which you received the original message.for users that don’t want to depend on their phone’s limited minutes for everything. It’s the one universal communications solution I’ve come to rely on to make and receive calls on the road.So how do you make extra use of this service by archiving and looking up past conversations?

  3. From the Command Window, enter and execute this line:

  4. Examine the output. You should see this line:

Notice that metadata expressed in this syntax does not cause batching.

Next steps

To learn how to create a simple project file one step at a time, try out the Walkthrough: Creating an MSBuild project file from scratch.

See also