#MSBuild Community Tasks
The MSBuild Community Tasks Project is an open source project for MSBuild tasks.
##Download
The latest build can be downloaded from the releases section. https://github.com/loresoft/msbuildtasks/releases
The MSBuild Community Tasks library is also available on nuget.org via package name MSBuildTasks.
To install MSBuildTasks, run the following command in the Package Manager Console
PM> Install-Package MSBuildTasks
More information about NuGet package avaliable at https://nuget.org/packages/MSBuildTasks
##Development Builds
Development builds are available on the myget.org feed. A development build is promoted to the main NuGet feed when it's determined to be stable.
In your Package Manager settings add the following package source for development builds: http://www.myget.org/F/loresoft/
##Join Project
Please join the MSBuild Community Tasks Project and help contribute in building the tasks.
Google Group for MSBuild Community Tasks https://groups.google.com/d/forum/msbuildtasks
##Current Community Tasks
| Task | Description |
|---|---|
| Add | Add numbers |
| AddTnsName | Defines a database host within the Oracle TNSNAMES.ORA file. |
| AppPoolController | Allows control for an application pool on a local or remote machine with IIS installed. The default is to control the application pool on the local machine. If connecting to a remote machine, you can specify the and for the task to run under. |
| AppPoolCreate | Creates a new application pool on a local or remote machine with IIS installed. The default is to create the new application pool on the local machine. If connecting to a remote machine, you can specify the and for the task to run under. |
| AppPoolDelete | Deletes an existing application pool on a local or remote machine with IIS installed. The default is to delete an existing application pool on the local machine. If connecting to a remote machine, you can specify the and for the task to run under. |
| AssemblyInfo | Generates an AssemblyInfo files |
| Attrib | Changes the attributes of files and/or directories |
| Beep | A task to play the sound of a beep through the console speaker. |
| BuildAssembler | BuildAssembler task for Sandcastle. |
| ChmBuilder | ChmBuilder task for Sandcastle. |
| ChmCompiler | Html Help 1x compiler task. |
| Computer | Provides information about the build computer. |
| DBCSFix | DBCSFix task for Sandcastle. |
| Divide | Divide numbers |
| ExecuteDDL | MSBuild task to execute DDL and SQL statements. |
| FileUpdate | Replace text in file(s) using a Regular Expression. |
| FtpCreateRemoteDirectory | Creates a full remote directory on the remote server if not exists using the File Transfer Protocol (FTP). This can be one directory or a full path to create. |
| FtpDirectoryExists | Determ if a remote directory exists on a FTP server or not. |
| FtpUpload | Uploads a group of files using File Transfer Protocol (FTP). |
| FtpUploadDirectoryContent | Uploads a full directory content to a remote directory. |
| FxCop | Uses FxCop to analyse managed code assemblies and reports on their design best-practice compliance. |
| GacUtil | MSBuild task to install and uninstall asseblies into the GAC |
| GetSolutionProjects | Retrieves the list of Projects contained within a Visual Studio Solution (.sln) file |
| HxCompiler | A Html Help 2.0 compiler task. |
| ILMerge | A wrapper for the ILMerge tool. |
| InstallAspNet | Installs and register script mappings for ASP.NET |
| InstallAssembly | Installs assemblies. |
| JSCompress | Compresses JavaScript source by removing comments and unnecessary whitespace. It typically reduces the size of the script by half, resulting in faster downloads and code that is harder to read. |
| Sends an email message | |
| Merge | Merge files into the destination file. |
| Modulo | Performs the modulo operation on numbers. |
| MV | Moves files on the filesystem to a new location. |
| MRefBuilder | MRefBuilder task for Sandcastle. |
| Multiple | Multiple numbers |
| NDoc | Runs the NDoc application. |
| NUnit | Run NUnit 2.4 on a group of assemblies. |
| Prompt | Displays a message on the console and waits for user input. |
| RegexMatch | Task to filter an Input list with a Regex expression. Output list contains items from Input list that matched given expression |
| RegexReplace | Task to replace portions of strings within the Input list Output list contains all the elements of the Input list after performing the Regex Replace. |
| RegistryRead | Reads a value from the Registry |
| RegistryWrite | Writes a value to the Registry |
| RoboCopy | Task wrapping the Window Resource Kit Robocopy.exe command. |
| Sandcastle | The Sandcastle task. |
| Script | Executes code contained within the task. |
| ServiceController | Task that can control a Windows service. |
| ServiceQuery | Task that can determine the status of a specified service on a target server. |
| Sleep | A task for sleeping for a specified period of time. |
| Sound | A task to play a sound from a .wav file path or URL. |
| SqlExecute | Executes a SQL command. |
| SqlPubWiz | The Database Publishing Wizard enables the deployment of SQL Server databases (both schema and data) into a shared hosting environment. |
| Subtract | Subtract numbers |
| SvnCheckout | Checkout a local working copy of a Subversion repository. |
| SvnClient | Subversion client base class |
| SvnCommit | Subversion Commit command |
| SvnCopy | Copy a file or folder in Subversion |
| SvnExport | Export a folder from a Subversion repository |
| SvnInfo | Run the "svn info" command and parse the output |
| SvnUpdate | Subversion Update command |
| SvnVersion | Summarize the local revision(s) of a working copy. |
| TaskSchema | A Task that generates a XSD schema of the tasks in an assembly. |
| TemplateFile | MSBuild task that replaces tokens in a template file and writes out a new file. |
| TfsVersion | Determines the changeset in a local Team Foundation Server workspace |
| Time | Gets the current date and time. |
| UninstallAssembly | Uninstalls assemblies. |
| Unzip | Unzip a file to a target directory. |
| User | Provides information about the build user. |
| Version | Generates version information based on various algorithms |
| VssAdd | Task that adds files to a Visual SourceSafe database. |
| VssCheckin | Task that executes a checkin against a VSS Database. |
| VssCheckout | Task that executes a checkout of files or projects against a Visual SourceSafe database. |
| VssClean | Task that can strip the source control information from a Visual Studio Solution and subprojects. |
| VssDiff | Task that records differences between the latest version of all the items in a Visual SourceSafe project and another version or label to a file. |
| VssGet | Task that retireves an item or project from a Visual SourceSafe database. |
| VssHistory | Generates an XML file containing details of all changes made to a Visual SourceSafe project or file between specified labels or dates. |
| VssLabel | Task that applies a label to a Visual SourceSafe item. |
| VssUndoCheckout | Task that undoes a checkout of files or projects against a Visual SourceSafe database. |
| WebDirectoryCreate | Creates a new web directory on a local or remote machine with IIS installed. The default is to create the new web directory on the local machine. The physical path is required to already exist on the target machine. If connecting to a remote machine, you can specify the and for the task to run under. |
| WebDirectoryDelete | Deletes a web directory on a local or remote machine with IIS installed. The default is to delete the web directory on the local machine. If connecting to a remote machine, you can specify the and for the task to run under. |
| WebDirectoryScriptMap | Sets an application mapping for a filename extension on an existing web directory. |
| WebDirectorySetting | Reads and modifies a web directory configuration setting. |
| WebDownload | Downloads a resource with the specified URI to a local file. |
| XmlMassUpdate | Performs multiple updates on an XML file |
| XmlQuery | Reads a value or values from lines of XML |
| XmlRead | Reads a value from a XML document using a XPath. |
| XmlUpdate | Updates a XML document using a XPath. |
| Xslt | A task to merge and transform a set of xml files. |
| XslTransform | XslTransform task for Sandcastle. |
| Zip | Create a zip file with the files specified. |
| * Items not complete or have not been released. | |
##Getting Started
In order to use the tasks in this project, you need to import the MSBuild.Community.Tasks.Targets files.
If you installed the project with the msi installer, you can use the following.
<Import Project="$(MSBuildExtensionsPath)\MSBuildCommunityTasks\MSBuild.Community.Tasks.Targets"/>
Alternatively if you want to get started with the nuget packages please add the following.
<PropertyGroup>
<MSBuildCommunityTasksPath>$(SolutionDir)\.build</MSBuildCommunityTasksPath>
</PropertyGroup>
<Import Project="$(MSBuildCommunityTasksPath)\MSBuild.Community.Tasks.Targets" />
Copyright (c) 2012, LoreSoft All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
- Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
- Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
- Neither the name of LoreSoft nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.