MSBuild.Community.Tasks Installs and register script mappings for ASP.NET Uses the aspnet_regiis.exe tool included with the .NET Framework. Install the latest version of ASP.NET on the server: ]]> Install the latest version of ASP.NET on the server, but do not update script maps: ]]> Install the script maps for ASP.NET 2.0 on a web directory on the default website: ]]> Install the script maps for ASP.NET 1.1 on a web directory on a non-default website: ]]> Install client side script only for the latest version: ]]> Returns the fully qualified path to the executable file. The fully qualified path to the executable file. Returns a string value containing the command line arguments to pass directly to the executable file. A string value containing the command line arguments to pass directly to the executable file. When overridden in a derived class, executes the task. True if the task successfully executed; otherwise, false. Determines if the current property values can be used together when properties can be used together. The version of ASP.NET to install The default behavior is to use the latest version of ASP.NET available on the computer. Version Version11ASP.NET v1.1 Version20ASP.NET v2.0 VersionLatestThe latest version of ASP.NET available The method used to determine if ASP.NET script mappings should be applied The default behavior is to register script mappings on all sites except those with a newer version of ASP.NET. Value NeverRegister ASP.NET on the computer without updating any script mappings. IfNoneExistRegister script mappings only on for sites that do not have any existing ASP.NET script mappings (not available for ASP.NET v1.1) UnlessNewerExistRegister script mappings on all sites except those with a newer version of ASP.NET. AlwaysRegister script mappings on all sites, even if they already have a newer version of ASP.NET. When , the aspnet_client scripts will be installed. No script mappings will be updated. This cannot be if a value for or has been specified. The web application that should have its script maps updated. The path must be of the form W3SVC/[instance]/Root/[webdirectory], for example W3SVC/1/Root/SampleApp1. As a shortcut, you can specify just the web directory name, if the web directory is installed in the default website instance (W3SVC/1/Root). You should not specify a value for when specifying a path. When , script maps are applied recursively under . This property is only valid when specifying a value for . It is by default. Gets the name of the executable file to run. The name of the executable file to run. Generates an AssemblyInfo files Generates a common version file. ]]> Generates a complete version file. ]]> Generates a complete version file for C++/CLI. ]]> The default value of . The value is "AssemblyInfo.cs". Initializes a new instance of the class. When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Gets or sets the code language. The code language. Gets or sets a value indicating whether [COMVisible]. true if [COMVisible]; otherwise, false. Gets or sets a value indicating whether [CLSCompliant]. true if [CLSCompliant]; otherwise, false. Gets or sets the GUID. The GUID. Gets or sets the assembly title. The assembly title. Gets or sets the assembly description. The assembly description. Gets or sets the assembly configuration. The assembly configuration. Gets or sets the assembly company. The assembly company. Gets or sets the assembly product. The assembly product. Gets or sets the assembly copyright. The assembly copyright. Gets or sets the assembly trademark. The assembly trademark. Gets or sets the assembly culture. The assembly culture. Gets or sets the assembly version. The assembly version. Gets or sets the assembly file version. The assembly file version. Gets or sets the assembly informational version. The assembly informational version. Gets or sets the assembly key file. Gets or sets the assembly key name. Gets or sets the assembly delay sign value. Gets or sets the assembly delay sign value. Gets or sets the assembly delay sign value. Gets or sets a value indicating whether to generate the ThisAssmebly class. Gets or sets the neutral language which is used as a fallback language configuration if the locale on the computer isn't supported. Example is setting this to "en-US". Gets or sets the ultimate resource fallback location. The ultimate resource fallback location. Makes it possible to make certain assemblies able to use constructs marked as internal. Example might be setting this value to "UnitTests" assembly. The typical use case might be constructors in classes which shouldn't be available to other assemblies, but the unit tests should be able to use them. Gets or sets whether to allow strong-named assemblies to be called by partially trusted code. Gets or sets the output file. The output file. Changes the attributes of files and/or directories Make file Readonly, Hidden and System. ]]> Clear Hidden and System attributes. ]]> Make file Normal. ]]> Executes the task. if the task ran successfully; otherwise . Gets or sets the list of files to change attributes on. The files to change attributes on. Gets or sets the list of directories to change attributes on. The directories to change attributes on. Gets or sets file's archive status. true if archive; otherwise, false. Gets or sets a value indicating file is compressed. true if compressed; otherwise, false. Gets or sets a value indicating file is encrypted. true if encrypted; otherwise, false. Gets or sets a value indicating file is hidden, and thus is not included in an ordinary directory listing. true if hidden; otherwise, false. Gets or sets a value indicating file is normal and has no other attributes set. true if normal; otherwise, false. Gets or sets a value indicating file is read-only. true if read-only; otherwise, false. Gets or sets a value indicating file is a system file. true if system; otherwise, false. Describes certain byte measurements as nice strings. Provides information about the build computer. Get build computer information. ]]> Initializes a new instance of the class. Executes the task. if the task ran successfully; otherwise . Gets the host name of the build computer. Gets the IP address of the build computer. Gets the platform identifier of the build computer's operating system . Gets the version number of the build computer's operating system. A task to play the sound of a beep through the console speaker. By default, the beep plays at a frequency of 800 hertz for a duration of 200 milliseconds. To play the sound of a beep at a frequency of 800 hertz and for a duration of 200 milliseconds, use ]]> To play the sound of a beep at a frequency of 440 hertz and for a duration of 300 milliseconds, use ]]> Plays the sound of a beep at the given and for the given through the console speaker. Always returns , even when the sound could not be played. Gets or sets the frequency of the beep, ranging from 37 to 32767 hertz. Defaults to 800 hertz. Gets or sets the of the beep measured in milliseconds. Defaults to 200 milliseconds. Delete a directory tree. This task supports wild card directory selection. Delete all bin and obj directories. ]]> Delete all bin and obj directories that start with MSBuild.Community. ]]> Initializes a new instance of the class. When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Gets or sets the directories to be deleted. The directories to be deleted. Directories can contain wild cards. Gets or sets a value indicating whether this is recursive. true if recursive; otherwise, false. Gets the deleted directories. The deleted directories. Uploads a group of files using File Transfer Protocol (FTP). Set either LocalFiles or LocalFile but not both. Upload a file. ]]> Upload all the files in an ItemGroup: '%(RecursiveDir)%(Filename)%(Extension)')" /> ]]> Describes a factory for IFtpWebRequest. Instantiates an FtpWebRequest. Initializes a new instance of the class. Initializes a new instance that will inject the specified dependency. When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Gets or sets the single file to upload. Use this or LocalFiles, but not both. Gets or sets the local files to upload. Use this or LocalFile, but not both. The local file. Gets or sets the remote files to upload. Each item in this list should have a corresponding item in LocalFiles. Gets or sets the remote URI to upload. The remote URI. Gets or sets the username. The username. Gets or sets the password. The password. Gets or sets the behavior of a client application's data transfer process. true if [use passive]; otherwise, false. This class references an interface that looks like FtpWebRequest in order to support unit testing without an actual FTP Server. Sets the ContentLength property of the FtpWebRequest. Calls GetRequestStream on the FtpWebRequest. Gets the StatusDescription property of the response, then closes the response on the FtpWebRequest. Gets the response from the FTP server and closes it. Gets the response stream from the FtpWebRequest. An adapter to make the real FtpWebRequest look like an IFtpWebRequest. Initializes a new instance of the RealFtpWebRequest class. Ftp client base class. The socket that will connect to the FTP server. The size of the data buffer. The last recieved FTP response over the client socket. The password to use to login. The port number of the FTP server. The hostname of the FTP server. The username to use to login. Initializes a new instance of the class. Connects this FTP server socket. Thrown when unable to connect. Login to the FTP server with the specified credentials. Changes the working directory. The remote directory. Occurs if there where connection problems during the process or the FTP server doesn't support the CWD command. See the Message of the exception for details. Sends the CWD command. Gets the working directory. The current working directory. Change to the parent of the current working directory. Occurs if there where connection problems during the process or the FTP server doesn't support the CDUP command. See the Message of the exception for details. Sends the CDUP command. Determs whether a remote file exists. The remote file. Occurs if there where connection problems during the operation or if the FTP server doesn't support the SIZE command. See the Message of the exception for details. Determs whether a remote directory exists. The remote directory. This method is based on the succeedness of a CWD command, this can give wrong indication at a rare number of FTP server! Thrown if the opperation couldn't be executed. true if the directory exists remotely; otherwise false Removes a remote directory. The remote directory name. Occurs if there where connection problems during the process or the FTP server doesn't support the RMD command. See the Message of the exception for details. Sends the RMD command. Creates a remote directory in the current working folder. Name of the directory. Occurs if there where connection problems during the process or the FTP server doesn't support the MMD command. See the Message of the exception for details. Closes the connection to the server. Stores the specified localFile. The localfile. The remotefile. Send a command to the FTP server. The command, for example PWD. The value. Send a command to the FTP server. The full command to send. Send a command to the FTP server and returns the response. The command, for example PWD. The value The reply of the FTP server for this command. Send a command to the FTP server and returns the response. The raw command to send. The reply of the FTP server for this command. Get the full directory details of the current directory. A array that contains all the FTP files located in the currenct directory. Create a data stream and send a raw command. The raw command to send. The data stream that was created. Parses the data IP end point from datarequest message. The message. Get the full directory details of the current directory. The remove directory, emtpy or null will get the details of the current directory. A array that contains all the FTP files located in the currenct directory. Reads the ftp response from the client socket. The response of the FTP server. Reads the response string from the client socket. The response of the client socket. Make sure the connections are closed and trow the specified exception. The exception to throw. Gets or sets the server host. The server host. The lenght of the given value is greater then 126 characters. Gets or sets the port number. The port numer. Gets or sets the client socket. The client socket. Gets a value indicating whether this is connected. true if connected; otherwise, false. Gets the encoding to use with communication with the server. The encoding. Gets the last recieved FTP response over the client socket. The last recieved FTP response over the client socket. Gets or sets the username to login. The username. Gets or sets the password to login. The password. Gets or sets a value indicating whether the FTP message conversation should be logged. true if the FTP message conversation should be logged; otherwise, false. Gets or sets the size of the data buffer. 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. Create remote directory: ]]> The full remote directory path will be created. All directories that doesn't exists on the remote server will be created. The remote directory to create. When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Gets or sets the remote directory to create. The remote directory. This can be one directory name, like "Directory", or a directory path, like "Directory\Subdirectoy". Determ if a remote directory exists on a FTP server or not. Determ of Directory\1 exists: ]]> If the directory exists on the server you should see the following output in the console: Directory '1\2\3' exists: true The full remote directory path will be created. All directories that doesn't exists on the remote server will be created. The remote directory to create. Flag that indicates whether the directory exists on the server. Executes the current task. true if the task successfully executed; otherwise, false. Gets or sets the remote directory to create. The remote directory. This can be one directory name, like "Directory", or a directory path, like "Directory\Subdirectoy". Gets an indication whether the directory exists on the server. true when the directory exists on the server; otherwise false. Exception returned by FTP server. Initializes a new instance of the class. The message. Initializes a new instance of the class. The message. The inner exception. Represents an remote file or directory on a FTP server. Indicates whether this instance represents a directory. Represents the file or directory name. Initializes a new instance of the class. Initializes a new instance of the class. if set to true this instance represents a directory; otherwise, false. The name. Parses the dir list. The entry lines. Gets or sets a value indicating whether this instance represents a directory. true if this instance represents a directory; otherwise, false. Gets or sets the name. The name. Represenatation of a FTP reply message. The result code of the FTP response. The response message. Initializes a new instance of the class. The result code of the FTP response. The response message. Gets or sets the result code. The result code. Gets or sets the message. The message. Uploads a full directory content to a remote directory. Uploads directory content, including all subdirectories and subdirectory content: ]]> To go a little step further. If the local directory looked like this: [mywebsite] [images] 1.gif 2.gif 3.gif [js] clientscript.js nofocus.js [css] print.css main.css index.htm contact.htm downloads.htm All directories and there content will be uploaded and a excact copy of the content of mywebsite directory will be created remotely. If is set the false; only index.htm, contact.htm and downloads.htm will be uploaded and no subdirectories will be created remotely. When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Upload a directory and its file contents. The local path. if set to true all subdurectiries will be included. Upload a directory and its file contents. The local path. Only upload files that compli to the mask. if set to true all subdurectiries will be included. Gets or sets the local directory that contains the content to upload. The local directory. Gets or sets the remote directory destination for the local files. The remote directory. Gets or sets a value indicating whether the subdirectories of the local directory should be created remotely and the content of these should also be uploaded. true if recursive; otherwise, false. The status of an uninstall. No status. Uninstalled successfully. Assembly is still in use. Assembly already uninstalled or not found. Assembly delete is pending. Assembly has a reference to an installed application. Assembly not found. A class wrapping fusion api calls Installs the assembly. The assembly path. if set to true force. Uninstalls the assembly. Name of the assembly. if set to true force. Returns true if uninstall successful. Uninstalls the assembly. Name of the assembly. if set to true force. The UninstallStatus result. Returns true if uninstall successful. Gets the assembly path. Name of the assembly. The path to the assembly in the GAC. Gets the name of the assembly. Name of the assembly. An instance. Html Help 1x compiler task. Returns the fully qualified path to the executable file. The fully qualified path to the executable file. Logs the starting point of the run to all registered loggers. A descriptive message to provide loggers, usually the command line and switches. Returns a string value containing the command line arguments to pass directly to the executable file. A string value containing the command line arguments to pass directly to the executable file. Handles execution errors raised by the executable file. true if the method runs successfully; otherwise, false. Gets or sets the project file path. The project file path. Gets the name of the executable file to run. The name of the executable file to run. Gets the with which to log errors. The with which to log errors. A Html Help 2.0 compiler task. Returns the fully qualified path to the executable file. The fully qualified path to the executable file. Logs the starting point of the run to all registered loggers. A descriptive message to provide loggers, usually the command line and switches. Returns a string value containing the command line arguments to pass directly to the executable file. A string value containing the command line arguments to pass directly to the executable file. Handles execution errors raised by the executable file. true if the method runs successfully; otherwise, false. Gets or sets the project file path. The project file path. Gets or sets the log file. The log file. Gets or sets the project root. The project root. Gets or sets the output file. The output file. Gets or sets a value indicating whether no info messages will be output. true if no info messages; otherwise, false. Gets or sets a value indicating whether no warning messages will be output. true if no warning messages; otherwise, false. Gets or sets a value indicating whether no error messages will be output. true if no error messages; otherwise, false. Gets or sets a value indicating quite mode. true if quite mode; otherwise, false. Gets or sets the uncompile file. The uncompile file. Gets or sets the uncompile directory. The uncompile directory. Gets the name of the executable file to run. The name of the executable file to run. Gets the with which to log errors. The with which to log errors. MSBuild task to create installer with InnoSetup Create installer ]]> Returns the fully qualified path to the executable file. The fully qualified path to the executable file. Logs the starting point of the run to all registered loggers. A descriptive message to provide loggers, usually the command line and switches. Returns a string value containing the command line arguments to pass directly to the executable file. A string value containing the command line arguments to pass directly to the executable file. Filename of Inno Setup script (.iss) InnoSetup file, example: C:\Setup.iss Specify output filename Name for setup, examples: MySetup.exe Specify output path Path for output setup, example: C:\Setups Quiet compile True o False Gets the name of the executable file to run. The name of the executable file to run. Gets the with which to log errors. The with which to log errors. Defines the modes for merging files. Merges files as binary data. Merges files as text. Merges files as text line by line. Merge files into the destination file. Merge CSS files together for better browser performance. ]]> When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Gets or sets the mode to use when merging. The merge mode. Gets or sets the source files to merge. The source files to merge. Gets or sets the destination file where the are merged to. The destination file. Makes an HTTP request, optionally validating the result and writing it to a file. Execute a http request to hit the database update. Target attributes to set: Url (required), FailOnNon2xxResponse (200 responses generally means successful http request. default=true), EnsureResponseContains (string to check for), WriteResponseTo (file name to write to), Example of a update request ensuring "Database upgrade check completed successfully." was returned. ]]> Constructor to set the default parameters for http request Entry Point inherited from Task The URL to make an HTTP request against. Optional: if set then the task fails if the response text doesn't contain the text specified. Default is true. When true, if the web server returns a status code less than 200 or greater than 299 then the task fails. Optional; the name of the file to write the response to. A base class for NuGet tasks. Returns the fully qualified path to the executable file. The fully qualified path to the executable file. Returns the directory in which to run the executable file. The directory in which to run the executable file, or a null reference (Nothing in Visual Basic) if the executable file should be run in the current directory. Gets or sets the working directory. The working directory. The directory in which to run the executable file, or a null reference (Nothing in Visual Basic) if the executable file should be run in the current directory. Gets the name of the executable file to run. The name of the executable file to run. Creates a NuGet package based on the specified nuspec or project file. Returns a string value containing the command line arguments to pass directly to the executable file. A string value containing the command line arguments to pass directly to the executable file. The location of the nuspec or project file to create a package. Specifies the directory for the created NuGet package. Overrides the version number from the nuspec file. The base path of the files defined in the nuspec file. Shows verbose output for package building. true if verbose; otherwise, false. Determines if a package containing sources and symbols should be created. When specified with a nuspec, creates a regular NuGet package file and the corresponding symbols package. true if symbols; otherwise, false. Pushes a package to the server and optionally publishes it. Returns a string value containing the command line arguments to pass directly to the executable file. A string value containing the command line arguments to pass directly to the executable file. The path to the package to push the package to the server. The API key to use for push to the server. Specifies the server URL. Specifies if the package should be created and uploaded to the server but not published to the server. False by default. true if create only; otherwise, false. Creates a relative path from one file or folder to another. Contains the directory that defines the start of the relative path. Contains the path that defines the endpoint of the relative path. The relative path from the start directory to the end path. Thrown if or are null. Compiles regular expressions and saves them to disk in an assembly. When defining the regular expressions in an MSBuild project file, the ItemGroup item must have a metadata tag called 'Pattern' that is the actually regular expression. Other optional metadata tags are the following. Metadata Tags Description Pattern The actually regular expression pattern to be compiled. (Required) Options The RegexOptions for the expression. Namespace The class namespace for the compile class. IsPublic A flag if the generated expression should be public. Creates an assembly with the compiled regular expressions. \G[^<]+ RegexOptions.Singleline | RegexOptions.Multiline \G<%--(([^-]*)-)*?-%> RegexOptions.Singleline | RegexOptions.Multiline \G<%(?![@%])(?<code>.*?)%> RegexOptions.Singleline | RegexOptions.Multiline MSBuild.Community.RegularExpressions ]]> Initializes a new instance of the class. When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Gets or sets the name of the assembly to be created by the regex compiler. The name of the assembly. Gets or sets the assembly title. The assembly title. Gets or sets the assembly description. The assembly description. Gets or sets the assembly company. The assembly company. Gets or sets the assembly product. The assembly product. Gets or sets the assembly copyright. The assembly copyright. Gets or sets the assembly culture. The assembly culture. Gets or sets the assembly version. The assembly version. Gets or sets the assembly file version. The assembly file version. Gets or sets the assembly informational version. The assembly informational version. Gets or sets the assembly key file. The assembly key file. Gets or sets the directory where the assembly will be saved. The output directory. Gets or sets the output file. The output file. Gets or sets the regular expressions. The regular expressions. Gets or sets the file defining the regular expressions. The regular expressions file. Gets or sets a value indicating whether the default value is public for regular expression instances. true if regular expression instance is public; otherwise, false. Gets or sets the default namespace for regular expression instances. The namespace for regular expression instances. Gets or sets the default regular expression options. The default regular expression options. BuildAssembler task for Sandcastle. A base class for Sandcastle Tools, Initializes a new instance of the class. Returns the fully qualified path to the executable file. The fully qualified path to the executable file. Logs the starting point of the run to all registered loggers. A descriptive message to provide loggers, usually the command line and switches. Logs the events from text output. The single line. The message importance. Gets or sets the sandcastle enviroment. The sandcastle enviroment. Gets or sets the enviroment variables. The enviroment variables. Gets or sets the sandcastle install root directory. The sandcastle root directory. Gets or sets a value indicating whether no info messages will be output. true if no info messages; otherwise, false. Gets or sets a value indicating whether no warning messages will be output. true if no warning messages; otherwise, false. Gets the with which to log errors. The with which to log errors. Gets the override value of the PATH environment variable. The override value of the PATH environment variable. Returns a string value containing the command line arguments to pass directly to the executable file. A string value containing the command line arguments to pass directly to the executable file. Gets or sets the configuration file. The configuration file. Gets or sets the manifest file. The manifest file. Gets the name of the executable file to run. The name of the executable file to run. ChmBuilder task for Sandcastle. Returns a string value containing the command line arguments to pass directly to the executable file. A string value containing the command line arguments to pass directly to the executable file. Gets or sets the HTML directory. The HTML directory. Gets or sets the name of the project. The name of the project. Gets or sets the toc file. The toc file. Gets or sets the output file. The output file. Gets or sets a value indicating whether this is metadata. true if metadata; otherwise, false. Gets or sets the language id. The language id. Gets the name of the executable file to run. The name of the executable file to run. DBCSFix task for Sandcastle. Returns a string value containing the command line arguments to pass directly to the executable file. A string value containing the command line arguments to pass directly to the executable file. Gets or sets the CHM directory. The CHM directory. Gets or sets the language id. The language id. Gets the name of the executable file to run. The name of the executable file to run. MRefBuilder task for Sandcastle. Returns a string value containing the command line arguments to pass directly to the executable file. A string value containing the command line arguments to pass directly to the executable file. Gets or sets the output file. The output file. Gets or sets the config file. The config file. Gets or sets the references. The references. Gets or sets the assemblies. The assemblies. Gets or sets a value indicating whether to include internal members. true to include internal; otherwise, false. Gets the name of the executable file to run. The name of the executable file to run. The Sandcastle task. Create the Html Help for MSBuild Community Task project. ]]> Initializes a new instance of the class. When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Gets or sets the sandcastle install root directory. The sandcastle root directory. Gets or sets the working directory. The working directory. Gets or sets the html help topic style. The html help topic style. The styles supported are hana, prototype and vs2005. The default style is vs2005. Gets or sets a value indicating whether working directory is cleaned. true if clean; otherwise, false. Gets or sets the references. The references. Gets or sets the assemblies. The assemblies. Gets or sets the comments. The comments. Gets or sets the build assembler config file. The build assembler config. Gets or sets the name of the CHM. The name of the CHM. Gets or sets the language id. The language id. Gets or sets a value indicating a Html Help 2x project will be created. The name of the Html Help 2x project. Gets or sets a value indicating whether no info messages will be output. true if no info messages; otherwise, false. Gets or sets a value indicating whether no warning messages will be output. true if no warning messages; otherwise, false. A class representing the sandcastle enviroment. Initializes a new instance of the class. Initializes a new instance of the class. The sandcastle root. Gets or sets the sandcastle root. The sandcastle root. Gets or sets the tools directory. The tools directory. Gets or sets the transforms directory. The transforms directory. Gets or sets the presentation directory. The presentation directory. XslTransform task for Sandcastle. Returns a string value containing the command line arguments to pass directly to the executable file. A string value containing the command line arguments to pass directly to the executable file. Gets or sets the output file. The output file. Gets or sets the XSLT files. The XSLT files. Gets or sets the XML files. The XML files. Gets or sets the arguments. The arguments. Gets the name of the executable file to run. The name of the executable file to run. The contract for a service that will provide access to the file system. Determines whether the specified file exists. The path of the file to check. True if the file exists on the filesystem. Returns the contents of a file. The path of the file to read. The text with the specified file. Writes text to a file. The path of the file to write. The text to write to the file. Provides access to the file system. Determines whether the specified file exists. The path of the file to check. True if the file exists on the filesystem. Returns the contents of a file. The path of the file to read. The text with the specified file. Writes text to a file. The path of the file to write. The text to write to the file. The list of the commands available to the GacUtil Task Install the list of assemblies into the GAC. Uninstall the list of assembly names from the GAC. MSBuild task to install and uninstall assemblies into the GAC Install a dll into the GAC. ]]> Uninstall a dll from the GAC. ]]> Runs the executable file with the specified task parameters. true if the task runs successfully; otherwise, false. Gets or sets the command. The command. Gets or sets the related file extensions to copy when is true. The related file extensions. The default extensions are .pdb and .xml. Gets or sets a value indicating whether related files are included when installing in GAC. true if related files are included when installing in GAC; otherwise, false. Setting IncludeRelatedFiles to true will copy the pdb and xml files from the same folder as the assembly to the location in the GAC that the assembly was installed to. This is useful in some debugging scenarios were you need to debug assemblies that are GAC'd. Gets or sets a value indicating whether warning messages are output. true to not log warning messages; otherwise, false. Gets or sets a value indicating whether to force reinstall of an assembly. true if force; otherwise, false. Gets or sets the assembly name or file. The assembly name or file. When the command is install, Assemblies should be a file path to the assembly to install in the GAC. When command is uninstall, Assemblies should be a the full name of the assembly to uninstall. Gets the installed assembly paths. The installed paths. Gets the installed assembly names. The installed names. Gets the number of assemblies successfully installed/uninstalled. The number successful assemblies. Gets the number of assemblies that failed to installed/uninstalled. The number failed assemblies. Gets the number of assemblies that were skipped during installed/uninstalled. The number of skipped assemblies. 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. This task does not change the behavior of the program that it is compressing. The resulting code will be harder to debug as well as harder to read. When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Gets or sets the files to source-compress. Encoding to use to read and write files. Gets the files that were successfully source-compressed. Defines a database host within the Oracle TNSNAMES.ORA file. Add an entry to the system default TNSNAMES.ORA file and update any entry that already exists: ]]> Add an entry to a specific file and fail if the entry already exists: ]]> Creates a new instance of the AddTnsName task using dependency injection. A service that provides access to the Windows registry. A service that provides access to the file system. Creates a new instance of the AddTnsName task using the default system services. When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Determines which TNSNAMES.ORA file to update based on task input and the current system environment. The path of the TNSNAMES.ORA file that will be used by the task. The path to a specific TNSNAMES.ORA file to update. If not specified, the default is %ORACLE_HOME%\network\admin\tnsnames.ora The contents of the TNSNAMES.ORA file before any changes are made. The path to the TNSNAMES.ORA that was used by task. The name of the host entry to add. To be properly recognized by Oracle, the value must contain a period, followed by a suffix. For example: mydatabase.world The contents of the TNSNAMES.ORA file after the task executes. The definition of the host entry to add. To be properly recognized by Oracle, the value must be surrounded by parentheses. When true, the task will update an existing entry with . If false, the task will fail if already exists. Contains information about a TNS definition Creates a new instance of a TnsEntry The position of the entry within a TNSNAMES.ORA file The length of the entry definition within the TNSNAMES.ORA file The position of the entry within a TNSNAMES.ORA file The length of the entry definition within the TNSNAMES.ORA file Locates host entries within a TNSNAMES.ORA file Initializes a new instance of the parser using the contents of a TNSNAMES.ORA file. Locates a host entry by its name. The name of the entry to find. A which contains information about the location of the entry within the file. Task wrapping the Window Resource Kit Robocopy.exe command. Deploy website to web server. ]]> Handles execution errors raised by the executable file. true if the method runs successfully; otherwise, false. Returns a string value containing the command line arguments to pass directly to the executable file. A string value containing the command line arguments to pass directly to the executable file. Returns the fully qualified path to the executable file. The fully qualified path to the executable file. Logs the starting point of the run to all registered loggers. A descriptive message to provide loggers, usually the command line and switches. Source directory You can use drive:\path or \\server\share\path Names of files to act upon. You can use wildcard characters (? and *). If no files are listed, Robocopy defaults to all files (*.*). Destination directory. You can use drive:\path or \\server\share\path /S Copies subdirectories (excluding empty ones). /E Copies all subdirectories (including empty ones). /Z Copies files in restartable mode (that is, restarts the copy process from the point of failure). /B Copies files in Backup mode (Backup copies are not restartable, but can copy some files that restartable mode cannot). /COPY:copyflags Copies the file information specified by copyflags. D – file Data, S – file Security (NTFS ACLs), A – file Attributes, O – file Ownership information, T – file Timestamps, U – file Auditing infomation. /COPYALL Copies Everything. Equivalent to /COPY:DATSOU. /NOCOPY Copies Nothing. Can be useful with /PURGE. /SEC Copies NTFS security information. (Source and destination volumes must both be NTFS). Equivalent to /COPY:DATS. /MOV Moves files (that is, deletes source files after copying). /MOVE Moves files and directories (that is, deletes source files and directories after copying). /PURGE Deletes destination files and directories that no longer exist in the source. /MIR Mirrors a directory tree (equivalent to running both /E and /PURGE). /CREATE Creates a directory tree structure containing zero-length files only (that is, no file data is copied). /FAT Creates destination files using only 8.3 FAT file names. /FFT Assume FAT File Times (2-second granularity). /IA:{R|A|S|H|C|N|E|T|O} Includes files with the specified attributes. The following file attributes can be acted upon: R – Read only, A – Archive, S – System, H – Hidden, C – Compressed, N – Not content indexed, E – Encrypted, T – Temporary, O - Offline /XA:{R|A|S|H|C|N|E|T|O} Excludes files with the specified attributes. The following file attributes can be acted upon: R – Read only, A – Archive, S – System, H – Hidden, C – Compressed, N – Not content indexed, E – Encrypted, T – Temporary, O - Offline /A Copies only files with the archive attribute set. /M Copies only files with the archive attribute set and then resets (turns off) the archive attribute in the source files. /XJ Excludes Junction points. /XF file [file] Excludes files with the specified names, paths, or wildcard characters. /XD dir [dir] Excludes directories with the specified names, paths, or wildcard characters. /V Produces verbose output (including skipped files). /NFL Turns off logging of file names. File names are still shown, however, if file copy errors occur. /NDL Turns off logging of directory names. Full file pathnames (as opposed to simple file names) will be shown if /NDL is used. /NJH Turns of logging of the job header. /NJS Turns off logging of the job summary. /NP Turns off copy progress indicator (% copied). /LOG:file Redirects output to the specified file, overwriting the file if it already exists. /LOG+:file Redirects output to the specified file, appending it to the file if it already exists. Manually entered options. Gets the name of the executable file to run. The name of the executable file to run. Gets the with which to log errors. The with which to log errors. A task to play a sound from a .wav file path or URL. You must specify either a file or URL (), a file relative to the (), or a file within the folder (). To play the windows XP startup sound, use ]]> To play a wav file from the "MyMusic" folder, use ]]> Loads the .wav file given by and plays the sound using a new thread. Returns if the .wav file can successfully be played; otherwise, returns . Gets or sets the file path or URL of the .wav file to load. Sets the file path of the .wav file to load as a relative path to . For example, on a Windows XP platform, you can call ]]> Sets the file path of the .wav file to load as a relative path to . Gets or sets the time, in milliseconds, in which the .wav file must load. The number of milliseconds to wait. The default is 10000 (10 seconds). After this time has expired, the loading is canceled and the task execution fails. Gets or sets a value indicating whether to play the sound synchronously. if playing the sound using the caller's thread (default); otherwise, if playing the sound using a new thread. A base class that has a file. Initializes a new instance of the class. Name of the file. Initializes a new instance of the class. The file info. Returns a that represents this instance. A that represents this instance. Performs an implicit conversion from to . The output file. The result of the conversion. Gets or sets the file. The file. Commands for the tasks. Read stream from pdb symbol file. Write stream to pdb symbol file. A task for the pdbstr from source server. Returns a string value containing the command line arguments to pass directly to the executable file. A string value containing the command line arguments to pass directly to the executable file. Returns the fully qualified path to the executable file. The fully qualified path to the executable file. Gets or sets the PDB file. The PDB file. Gets or sets the stream file. The stream file. Gets or sets the name of the stream. The name of the stream. Gets or sets the command. The command. Gets the name of the executable file to run. The name of the executable file to run. A class representing a source file. Initializes a new instance of the class. Name of the file. Initializes a new instance of the class. The file info. Creates the source string. The format. Gets or sets the properties. The properties. Gets or sets a value indicating whether this instance is resolved. true if this instance is resolved; otherwise, false. A base class for source indexing a pdb symbol file. When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Indexes the symbol file. The symbol file task item. true if index successfully; otherwise false. Creates an instance of from the symbol file task item and add the source file list to it. The symbol file task item. An instance of or null if there was an error. Adds the source properties to the symbol file. The symbol file to add the source properties to. true if successful; otherwise false. Creates the source index file. The symbol file to create the index file from. The source index file. true if successful; otherwise false. Writes the source index file to the symbol file. The symbol file. The source index file. true if successful; otherwise false. Copies the build engine to the task. The task. Gets or sets the symbol files to have to source index added. The symbol files. Gets or sets the source server SDK path. The source server SDK path. Gets or sets the name of the source server. The name of the source server. Gets or sets the source command format. The SRCSRVCMD environment variable. The source command format. Describes how to build the command to extract the file from source control. This includes the name of the executable file and its command-line parameters. See srcsrv.doc for full documentation on SRCSRVCMD. Gets or sets the source target format. The SRCSRVTRG environment variable. The source target format. Describes how to build the target path for the extracted file. See srcsrv.doc for full documentation on SRCSRVTRG. A task for the srctool from source server. Returns a string value containing the command line arguments to pass directly to the executable file. A string value containing the command line arguments to pass directly to the executable file. Parses a single line of text to identify any errors or warnings in canonical format. A single line of text for the method to parse. A value of that indicates the importance level with which to log the message. Handles execution errors raised by the executable file. true if the method runs successfully; otherwise, false. Returns the fully qualified path to the executable file. The fully qualified path to the executable file. Logs the starting point of the run to all registered loggers. A descriptive message to provide loggers, usually the command line and switches. Gets or sets the PDB file. The PDB file. Gets or sets a value indicating whether to dumps raw source data from the PDB. The -r switch. true if source only; otherwise, false. Gets or sets the filter to only source files that match this regular expression. The -l switch. The filter regular expression. Gets or sets a value indicating whether to extracts the files, instead of simply listing them. The -x switch. true if extract; otherwise, false. Gets or sets the directory to extract to. The -d switch. The extract directory. Gets or sets a value indicating whether to get the count of indexed files. The -c switch. true if count only; otherwise, false. Gets or sets the number of source files. The number of source files. Gets the source files. Populated when is true. The source files. Gets the extracted files. Populated when is true. The extracted files. Gets the name of the executable file to run. The name of the executable file to run. Gets the with which to log errors. The with which to log errors. A subversion source index task. Initializes a new instance of the class. Adds the source properties to the symbol file. The symbol file to add the source properties to. true if successful; otherwise false. Creates the source index file. The symbol file to create the index file from. The source index file. true if successful; otherwise false. A class representing a symbol file. Initializes a new instance of the class. Name of the file. Initializes a new instance of the class. The file info. Adds the source files. The files. Gets the source files. The source files. Gets or sets a value indicating whether this instance is indexed. true if this instance is indexed; otherwise, false. The SqlPubWiz commands Scripts a local database to one or more files Publishes a local database to a web service provided by a hoster. The Database Publishing Wizard enables the deployment of SQL Server databases (both schema and data) into a shared hosting environment. Generate the database script for Northwind on localhost. ]]> Returns the fully qualified path to the executable file. The fully qualified path to the executable file. Returns a string value containing the command line arguments to pass directly to the executable file. A string value containing the command line arguments to pass directly to the executable file. Logs the starting point of the run to all registered loggers. A descriptive message to provide loggers, usually the command line and switches. Gets or sets the database publishing command. The database publishing command. Use either script or publish. Use script to script a local database to a file on the local computer. Use publish to transfer database objects directly to a hosted database via a web service. script and publish enable some of the same options and switches. Some options and switches are only enabled only by one of these verbs. Gets or sets the full connection string to the local database. The connection string. Provides a full connection string to connect to the local database. This connection string encapsulates all connection options to the server. Incompatible with , or, . Gets or sets the name of the local database to be scripted. The name of the database to be scripted. Gets or sets the SQL Server user name to use for connection to the source database. The SQL Server user name. Specifies the SQL Server User name to use for connection to the source database. Requires . Incompatible with . Gets or sets the password to use for connection to the source database. The password. Specifies the password to use for connection to the source database. Requires . Incompatible with . Gets or sets the name or IP address for the local database connection. The name or IP address of server. Specifies the name or IP address for the local database connection. The default is localhost. Incompatible with . Gets or sets the full file path for the script file generated. The full file path. Use only with script. Specifies the full file path for the script file generated by the sqlpubwiz. Gets or sets a value indicating whether the schema, but not the data, should be scripted. true if only the schema should be scripted; otherwise, false. Specifies that the schema, but not the data, should be scripted. Incompatible with . If neither nor are specified, both the schema and data are scripted. Gets or sets a value indicating whether the data but not the schema should be scripted. true if only the data is scripted; otherwise, false. Specifies that the data but not the schema should be scripted. Incompatible with or . If neither nor are specified, both the schema and data are scripted. Gets or sets the target server the script should target. The target server the script should target. Specifies that the script to be generated should target a SQL Server 2000 or SQL Server 2005 instance. The default is SQL Server 2005. Gets or sets a value indicating whether objects will not be qualified with a schema. true if objects will not be schema qualified; otherwise, false. Gets or sets a value indicating whether the produced script should not drop pre-existing objects. true if pre-existing objects should not be dropped; otherwise, false. Gets or sets a value indicating output message suppression. true to suppress messages; otherwise, false. Gets or sets the friendly name of previously configured hosting Web service. The name of the hoster. Gets or sets the configuration of the hosting Web service endpoint. The web service address. Gets or sets the username on the hosting Web service endpoint. The service username. Gets or sets the password for the remote Web service endpoint. The service password. Gets or sets the database name to publish to on the remote server. The service database server. Gets or sets the remote database server name. The service database. Gets or sets a value indicating whether the publish operation should not be executed within a single transaction. true to not publish in a single transaction; otherwise, false. Specifies that the publish operation should not be executed within a single transaction. This reduces logging overhead on the target server, but if the publish is interrupted, the target database may be left in a partially populated state. Gets the name of the executable file to run. The name of the executable file to run. Gets the with which to log errors. The with which to log errors. Copy a file or folder in Subversion This is most useful for automatically tagging your source code during a build. You can create a tag by copying a path from one server location to another. Create a tag of the trunk with the current Cruise Control build number: ]]> Subversion client base class Generates the SVN command. Generates the SVN arguments. Returns a string value containing the command line arguments to pass directly to the executable file. A string value containing the command line arguments to pass directly to the executable file. Indicates whether all task paratmeters are valid. true if all task parameters are valid; otherwise, false. Logs the events from text output. The single line. The message importance. Returns the fully qualified path to the executable file. The fully qualified path to the executable file. Finds the tool path. Name of the tool. Logs the starting point of the run to all registered loggers. A descriptive message to provide loggers, usually the command line and switches. Gets or sets the command. The command. Gets or sets the arguments. The arguments. Gets or sets the username. The username. Gets or sets the password. The password. Gets or sets the verbose. The verbose. Gets or sets the force. The force. Gets or sets the message. The message. Gets or sets the message file. The message file. Uses the contents of the named file for the specified subcommand, though different subcommands do different things with this content. Gets or sets the repository path. The repository path. Gets or sets the local path. The local path. Gets or sets the target file. The target file. Tells Subversion to get the list of files that you wish to operate on from the filename that you provide instead of listing all the files on the command line. Gets or sets the targets. The targets. Gets or sets a value indicating the command is non interactive]. true if non interactive; otherwise, false. Gets or sets a value indicating no auth cache. true if no auth cache; otherwise, false. Gets or sets a value indicating whether to trust the server cert. true to trust the server cert; otherwise, false. Gets or sets a value indicating the output is XML. true to output in XML; otherwise, false. Gets or sets the revision. The revision. Gets the output of SVN command-line client. Gets the error output of SVN command-line client. Gets the with which to log errors. The with which to log errors. Gets the name of the executable file to run. The name of the executable file to run. Initializes a new instance of the class. Generates the SVN command. Indicates whether all task paratmeters are valid. true if all task parameters are valid; otherwise, false. The path of the source file or folder that should be copied The path to which the SourcePath should be copied Subversion status command. Creates an instance of SvnStatus. Commands for the SymStore tasks. Add to the symbol server store. Query the symbol server store. Delete from the symbol serer store. Task that wraps the Symbol Server SymStore.exe application. Initializes a new instance of the class. Returns a string value containing the command line arguments to pass directly to the executable file. A string value containing the command line arguments to pass directly to the executable file. Returns the fully qualified path to the executable file. The fully qualified path to the executable file. Logs the starting point of the run to all registered loggers. A descriptive message to provide loggers, usually the command line and switches. Gets or sets the command. The command. Gets or sets a value indicating SymStore will append new indexing information to an existing index file. true if append; otherwise, false. Gets or sets the comment for the transaction. The comment for the transaction. Gets or sets a value indicating SymStore will create a compressed version of each file copied to the symbol store instead of using an uncompressed copy of the file. true if compress; otherwise, false. Gets or sets a log file to be used for command output. If this is not included, transaction information and other output is sent to stdout. The log file to be used for command output. Gets or sets the network path of files or directories to add. The network path of files or directories to add. Gets or sets the server and share where the symbol files were originally stored. The server and share where the symbol files were originally stored. Gets or sets the transaction ID string. The transaction ID string. Gets or sets a value indicating whether the file will be in a local directory rather than a network path. true if local; otherwise, false. Gets or sets a value indicating whether SymStore will display verbose output. true if verbose; otherwise, false. Gets or sets a value indicating whether SymStore will store a pointer to the file, rather than the file itself. true if pointer; otherwise, false. Gets or sets a value indicating whether SymStore will add files or directories recursively. true if recursive; otherwise, false. Gets or sets the root directory for the symbol store. The root directory for the symbol store. Gets or sets the name of the product. The name of the product. Gets or sets the version of the product. The version of the product. Gets or sets the message to be added to each file. The message to be added to each file. Gets or sets a value indicating whether the paths in the file pointers will be relative. true if relative; otherwise, false. Gets or sets a value indicating whether to omit the creation of reference pointer files for the files and pointers being stored. true to omit the creation of reference pointer; otherwise, false. Gets or sets the index file. Causes SymStore not to store the actual symbol files. Instead, SymStore records information in the IndexFile that will enable SymStore to access the symbol files at a later time. The write index file. Gets or sets the index file. Causes SymStore to read the data from a file created with WriteIndexFile. The read index file. Gets the name of the executable file to run. The name of the executable file to run. Gets the with which to log errors. The with which to log errors. Returns the fully qualified path to the executable file. The fully qualified path to the executable file. Logs the starting point of the run to all registered loggers. A descriptive message to provide loggers, usually the command line and switches. Returns a string value containing the command line arguments to pass directly to the executable file. A string value containing the command line arguments to pass directly to the executable file. Indicates whether all task paratmeters are valid. true if all task parameters are valid; otherwise, false. Gets the with which to log errors. The with which to log errors. Gets the name of the executable file to run. The name of the executable file to run. The contract for a service that will provide access to the registry. Returns the names of the subkeys under the provided key. The hive where is located. The key to search. A list of subkeys. Returns the value of an entry in the registry. The key of the registry entry that contains The name of the value to return. The value of the registry entry. Provides access to the Windows registry. Returns the names of the subkeys under the provided key. The hive where is located. The key to search. A list of subkeys. Returns the value of an entry in the registry. The key of the registry entry that contains The name of the value to return. The value of the registry entry. Provides information about the build user. Get build user information. ]]> The following output parameters are set only if information about the build user can be retrieved from the Active Directory if one exists: FirstName LastName MiddleInitial FullName Email Phone Initializes a new instance of the class. Executes the task. if the task ran successfully; otherwise . Gets the user name of the build user. Gets the domain name of the build user. Gets the first name of the build user. Gets the last name of the build user. Gets the middle initial of the build user. Gets the email address of the build user. Gets the phone number of the build user. Gets the username and domain name of the build user in "[Domain name]\[User name]" format. Gets the full name of the build user in "[First name] [Middle initial]. [Last name]" format . Performs multiple updates on an XML file XmlMassUpdate allows to to specify multiple changes to make to an XML file (the . By default, the changes are applied to the , but you can create a new file by providing the attribute. The change instructions are specified using XML in the . If the does not mirror the structure of the exactly, you can specify the and XPath expressions which determine how the files should be mapped to each other. Any element within the will find the corresponding element in the . If it does not exist, it will be created with all of its attributes. If it does exist, the attributes will be added or updated as specified. Any attribute declared within the will not be copied to the modified file. Valid attributes are key and action. The key attribute allows you to define an attribute to use as the identifying attribute when you only want to update a single element, and multiple elements with the same name exist. You can also use the action="remove" attribute to specify that an element should be deleted instead of updated. These examples will demonstrate how to make multiple updates to a XML file named web.config. It looks like: ]]> You can update the file using instructions from an external file (specified as the ): ]]> The is named changes.xml and contains: ]]> You can also provide the update instructions within the MSBuild project file itself. It takes advantage of the MSBuild ProjectExtensions element which allows you to add XML to a project file that will be ignored by the MSBuild engine. This example also demonstrates how to use : ]]> The following example demonstrates how to deal with "keyed" elements. When you need to update an element, and multiple elements exist with the same name, it must be be differentied by one of its attributes. You designate the differentiating attribute using the "key" attribute declared in the . If an element matching the keyed attribute is not found, a new element will be created (DefaultSort in the example). This example also demonstrates creating a new file with the merged changes instead of modifying the original file. ]]> Using a changes.xml file with the following contents: ]]> Use a changes.xml file with the following contents to demonstrate how to remove an element from the updated file: ]]> You can also specify the changes to apply from within the target document. By making use of the property, you can store multiple sets of changes to apply based on runtime conditions. Consider the following source web.config file: ]]> You could use the following task definition, which relies on a property "TargetEnvironment" to determine which set of changes to apply: ]]> You will need to provide a value of "test" or "prod" to the TargetEnvironment property. The property can be defined in a PropertyGroup section of the MSBuild file, or passed as a command-line parameter. When overridden in a derived class, executes the task. True if the task successfully executed; otherwise, false. Returns as an . This method is not intended for use by consumers. It is exposed for testing purposes. Returns as an . This method is not intended for use by consumers. It is exposed for testing purposes. Creates from the specified The XML to save to a file This method is not intended for use by consumers. It is exposed for testing purposes. The original file whose content is to be updated This task is currently under construction and not necessarily feature complete. The file containing the list of updates to perform The file created after performing the updates The XPath expression used to locate the list of substitutions to perform When not specified, the default is the document root: / When there is a set of elements with the same name, and you want to update a single element which can be identified by one of its attributes, you need to include an attribute named 'key' in the namespace urn:msbuildcommunitytasks-xmlmassupdate. The value of the attribute is the name of the attribute that should be used as the unique identifier. The XPath expression identifying root node that substitions are relative to When not specified, the default is the document root: / A collection of prefix=namespace definitions used to query the XML documents Defining multiple namespaces: />]]> The full path of the file containing content updated by the task The full path of the file containing substitutions used by the task The full path of the file containing the results of the task The namespace used for XmlMassUpdate pre-defined attributes Evaluates to: urn:msbuildcommunitytasks-xmlmassupdate Attributes decorated with this namespace are used to control how a substitutions element or attribute is handled during the update. For example, the key attribute is used to identify the attribute on an element that uniquely identifies the element in a set. Sets an application mapping for a filename extension on an existing web directory. Map the .axd extension to the lastest version of ASP.NET: ]]> Map GET requests to the .rss extension to a specific executable: ]]> Base task for any IIS-related task. Stores the base logic for gathering the IIS version and server and port checking. This base task also stores common properties for other related tasks. IIS version. Gets the IIS version. The for IIS. Gets the remote machine OS version. Returns a of the operating system. Verifies that the IIS root exists based on the and . Verify that the IIS Website exists if it has been specified. DirectoryEntry that meets the IISWebServer schema True if a site is found when specified. True if no site has been specified. Helper method for that verifies the server port exists. The site to verify the port. Boolean value indicating the status of the port check. Sets some of the protected properties for the Virtual Directory Creation Wizard. DirectoryEntry.Name where the Entry is an IISWebServer schema Gets or sets the name of the server. The default value is 'localhost'. The name of the server. Gets or sets host header. Used when you have more than one website in IIS that have the same port but different host headers. The name of the host header. Gets or sets the server port. The server port. Gets or sets the IIS server path. Is in the form 'IIS://localhost/W3SVC/1/Root'. The IIS server path. Gets or sets the application path. Is in the form '/LM/W3SVC/1/Root'. The application path. Gets or sets the IIS application pool path. Is in the form 'IIS://localhost/W3SVC/AppPools'. The IIS application pool path. Gets or sets the username for the account the task will run under. This property is needed if you specified a for a remote machine. The username of the account. Gets or sets the password for the account the task will run under. This property is needed if you specified a for a remote machine. The password of the account. Defines the possible IIS versions supported by the task. IIS version 4.x IIS version 5.x IIS version 6.x Defines the possible application pool actions to be performed. Recycles an application pool. Stops and restarts the application pool. Starts the application pool. Stops the application pool. Defines the current application pool state. The application pool is starting. The application pool has started. The application pool is stopping. The application pool has stopped. When overridden in a derived class, executes the task. True if the task successfully executed; otherwise, false. Gets or sets the name of the virtual directory. The name of the virtual directory. The filename extension that will be mapped to an executable. The full path to the executable used to respond to requests for a Uri ending with This property is required when is false (the default). Indicates whether should be mapped to the ASP.NET runtime. When true, is set to aspnet_isapi.dll in the installation folder of the latest version of the .NET Framework. A comma-separated list of the HTTP verbs to include in the application mapping. The default behavior (when this property is empty or unspecified) is to map all verbs. A semi-colon-separated list will also be recognized, allowing you to use an MSBuild Item. Set to true when you want the application to run in a directory without Execute permissions. Set to true to instruct the Web server to verify the existence of the requested script file and to ensure that the requesting user has access permission for that script file. Reads and modifies a web directory configuration setting. Display the file system path of the MyWeb web directory: ]]> Set the default document for the MyWeb directory to Default.aspx: ]]> When overridden in a derived class, executes the task. True if the task successfully executed; otherwise, false. Gets or sets the name of the virtual directory. The name of the virtual directory. Gets or sets the configuration setting to read or modify. Gets or sets the value of on the web directory A wrapper for the ILMerge tool. The ILMerge tool itself must be installed separately. It is available here. The command line options "/wildcards" and "/lib" of ILMerge are not supported, because MSBuild is in charge of expanding wildcards for item groups. This example merges two assemblies A.dll and B.dll into one: $(testDir)\ilmergetest.dll $(testDir)\keypair.snk $(testDir)\ExcludeTypes.txt $(testDir)\ilmergetest.log ]]> Initializes a new instance of the class. Gets the standard installation path of ILMerge.exe. If ILMerge is not installed at its standard installation path, provide its location to . Returns [ProgramFiles]\Microsoft\ILMerge.exe. Generates a string value containing the command line arguments to pass directly to the executable file. Returns a string value containing the command line arguments to pass directly to the executable file. Gets or sets the names of public types to be renamed when they are duplicates. Set to an empty item group to allow all public types to be renamed. Don't provide this parameter if no duplicates of public types are allowed. Corresponds to command line option "/allowDup". The default value is null. Gets or sets a value indicating whether to treat an assembly with a zero PeKind flag (this is the value of the field listed as .corflags in the Manifest) as if it was ILonly. Corresponds to command line option "/zeroPeKind". The default value is false. Gets or sets the attribute assembly from whre to get all of the assembly-level attributes such as Culture, Version, etc. It will also be used to get the Win32 Resources from. This property is mutually exclusive with . When not specified, then the Win32 Resources from the primary assembly are copied over into the target assembly. Corresponds to command line option "/attr". The default value is null. Gets or sets a value indicating whether to augment the list of input assemblies to its "transitive closure". An assembly is considered part of the transitive closure if it is referenced, either directly or indirectly, from one of the originally specified input assemblies and it has an external reference to one of the input assemblies, or one of the assemblies that has such a reference. Corresponds to command line option "/closed". The default value is false. Gets or sets a value indicating whether to copy the assembly level attributes of each input assembly over into the target assembly. Any duplicate attribute overwrites a previously copied attribute. The input assemblies are processed in the order they are specified. This parameter is mutually exclusive with . Corresponds to command line option "/copyattrs". The default value is false. Gets or sets a value indicating whether to copy assembly attributes from all merged assemblies into the unified assembly even if duplicate assembly attributes would result. Applicable only when is true Corresponds to command line option "/allowMultiple". Gets or sets a value indicating whether to preserve any .pdb files that are found for the input assemblies into a .pdb file for the target assembly. Corresponds to command line option "/ndebug". The default value is true. Gets or sets a value indicating whether the target assembly will be delay signed. This property can be set only in conjunction with . Corresponds to command line option "/delaysign". The default value is false. Gets or sets the file that will be used to identify types that are not to have their visibility modified. If an empty item group is provided, then all types in any assembly other than the primary assembly are made non-public. Omit this parameter to prevent ILMerge from modifying the visibility of any types. The contents of the file should be one per line. The regular expressions are matched against each type's full name, e.g., System.Collections.IList. If the match fails, it is tried again with the assembly name (surrounded by square brackets) prepended to the type name. Thus, the pattern \[A\].* excludes all types in assembly A from being made non-public. The pattern N.T will match all types named T in the namespace named N no matter what assembly they are defined in. Corresponds to command line option "/internalize". The default value is null. Gets or sets the input assemblies to merge. Gets or sets a value indicating whether whether types in assemblies other than the primary assembly have their visibility modified. true if internalize; otherwise, false. This controls whether types in assemblies other than the primary assembly have their visibility modified. When it is true, then all non-exempt types that are visible outside of their assembly have their visibility modified so that they are not visible from outside of the merged assembly. A type is exempt if its full name matches a line from the ExcludeFile (Section 2.9) using the .NET regular expression engine. Corresponds to command line option "/internalize". The default value is false. Gets or sets the .snk file to sign the target assembly. Can be used with . Corresponds to command line option "/keyfile". The default value is null. Gets or sets a log file to write log messages to. If an empty item group is provided, then log messages are writte to . Corresponds to command line option "/log". The default value is null. Gets or sets the target assembly. Corresponds to command line option "/out". Gets or sets a value indicating whether external assembly references in the manifest of the target assembly will use public keys (false) or public key tokens (true). Corresponds to command line option "/publickeytokens". The default value is false. Gets or sets the directories to be used to search for input assemblies. The search directories. Gets or sets the .NET framework version for the target assembly. Valid values are "v1", "v1.1", "v2". Corresponds to the first part of command line option "/targetplatform". The default value is null. Gets or sets the directory in which mscorlib.dll is to be found. Can only be used in conjunction with . Corresponds to the second part of command line option "/targetplatform". The default value is null. Gets or sets the indicator whether the target assembly is created as a library (Dll), a console application (Exe) or as a Windows application (WinExe). Corresponds to command line option "/target". The default value is the same kind as that of the primary assembly. Gets or sets the version number of the target assembly. The parameter should look like 6.2.1.3. Corresponds to command line option "/ver". The default value is null. Gets or sets a value indicating whether to merge XML documentation files into one for the target assembly. Corresponds to command line option "/xmldocs". The default value is false. Gets the name of the executable file to run. Gets the with which to log errors. The with which to log errors. Gets the with which to log errors. The with which to log errors. Installs assemblies. Uses InstallUtil.exe to execute the Install method of Installer classes contained within specified assemblies. Install multiple assemblies by specifying the file names: ]]> Install an assembly using the assembly name. Also disable the log file by setting it to a single space: ]]> You can easily chain an install to the result of a build: ]]> Returns the fully qualified path to the executable file. The fully qualified path to the executable file. Returns a string value containing the command line arguments to pass directly to the executable file. A string value containing the command line arguments to pass directly to the executable file. The assemblies to process, identified by their assembly name. The assemblies to process, identified by their filename. The file to write installation progress to. Set to a single space to disable logging to a file. If not specified, the default is to log to [assemblyname].installLog If an exception occurs at any point during installation, the call stack will be printed to the log. Determines whether assemblies are installed or uninstalled. Gets the name of the executable file to run. The name of the executable file to run. Uninstalls assemblies. Uses InstallUtil.exe to execute the Uninstall method of Installer classes contained within specified assemblies. Uninstall multiple assemblies by specifying the file names: ]]> Unnstall an assembly using the assembly name. Also disable the log file by setting it to a single space: ]]> Determines whether assemblies are installed or uninstalled. Performs the modulo operation on numbers. The modulo operation finds the remainder of the division of one number by another. When the second number (modulus) is a fractional value, the result can be a fractional value. Equivalent to the % operator in C# or the Mod operator in Visual Basic. Numbers evenly divide: ]]> Above example will display: 12 modulo 4 = 0 Division on the numbers produces a remainder: ]]> Above example will display: 14 modulo 4 = 2 Modulus is a fractional value: ]]> Above example will display: 12 modulo 3.5 = 1.5 Math task base class When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Strings array to decimal array. The numbers. Gets or sets the numbers to work with. The numbers. Gets or sets the result. The result. Gets or sets the numeric format. The numeric format. When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Displays a message on the console and waits for user input. It is important to note that the message is not written to the MSBuild logger, it is always written to the console, no matter which logger is configured. This task requires user input from the console. Do not use this task for projects that will be executed unattended. It is recommended that you always add a Condtion so that this task is only enabled when a custom property is set through the command line. This will ensure that the other users do not attempt to execute the task in unattended mode. Pause the build if the interactive property is set: ]]> Obtain user input during the build: (Note: in most cases, it is recommended that users instead provide custom values to your build through the /property argument of msbuild.exe) ]]> When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. The message to display in the console. The text entered at the console. Base class for Regex tasks Handles public properties for Input, Expression, Options and Output Regex expression Input, list of items to perform the regex on Regex options as strings corresponding to the RegexOptions enum: Compiled CultureInvariant ECMAScript ExplicitCapture IgnoreCase IgnorePatternWhitespace Multiline None RightToLeft Singleline Results of the Regex transformation. Options converted to RegexOptions enum Task to filter an Input list with a Regex expression. Output list contains items from Input list that matched given expression Matches from TestGroup those names ending in a, b or c ]]> Performs the Match task if the task ran successfully; otherwise . 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. 1st example replaces first occurance of "foo." with empty string 2nd example replaces occurance of "foo." after character 6 with "oop." string ]]> Performs the Replace task if the task ran successfully; otherwise . String replacing matching expression strings in input list. If left empty matches in the input list are removed (replaced with empty string) Number of matches to allow on each input item. -1 indicates to perform matches on all matches within input item Position within the input item to start matching Different ways to specify the assembly in a UsingTask element. Assembly file name (Default): <UsingTask AssemblyFile="foo.dll" /> Assembly location: <UsingTask AssemblyName="foo" /> Assembly Name: <UsingTask AssemblyFile="bin\debug\foo.dll" /> Assembly fully qualified name: <UsingTask AssemblyName="foo.dll,version ...." /> A Task that generates a XSD schema of the tasks in an assembly. Creates schema for MSBuild Community Task project ]]> When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Gets or sets the list of path to analyse. Gets or sets the output path for the generated files. Gets the list of path to the generated XSD schema. Gets or sets a value indicating if the task list (using UsingTask) has to be genereted. Gets or sets a value indicating how the assembly is specified in the UsingTask element. Gets or sets a value indicating wheter documentation should be ignored even if available (Default is false). Gets the path to the task list if it was generated. Gets or sets a value indicating if the MsBuild schema inclusing should be ignored Gets or sets a list of included schemas Retrieves the list of Projects contained within a Visual Studio Solution (.sln) file Returns project name, GUID, and path information from test solution ]]> Perform task true on success A list of the project files found in The name of the project can be retrieved by reading metadata tag ProjectName. The path to the project as it is is stored in the solution file retrieved by reading metadata tag ProjectPath. The project's GUID can be retrieved by reading metadata tag ProjectGUID. Name of Solution to get Projects from MSBuild task to execute DDL and SQL statements. Requires the the SQL Server libraries and dynamically loads the required Microsoft.SqlServer.ConnectionInfo assembly. Server=localhost;Integrated Security=True ]]> Executes the task. true if the task successfully executed; otherwise, false. The connection string Gets or sets the DDL/SQL files. The assemblies. Output the return count/values Timeout to execute a DDL statement. Defaults to 30 seconds. Set to 0 for an infinite timeout period. Gets or sets the batch delimter string. Default is "GO" for T-SQL. The kind of Subversion node. The names match the text output by "svn info". Node is a file Node is a directory Unknown node type The Subversion schedule type. Normal schedule Unknown schedule. Run the "svn info" command and parse the output This example will determine the Subversion repository root for a working directory and print it out. ]]> You can retrieve Subversion information for a or . If you do not provide a value for or , the current directory is assumed. Initializes a new instance of the class. Reset all instance variables to their default (unset) state. Execute the task. true if execution is successful, false if not. Return the repository root or null if not set by Subversion. Return the repository UUID value from Subversion. The Subversion node kind. The author who last changed this node. The last changed revision number. The date this node was last changed. The Subversion schedule type. MSBuild task that replaces tokens in a template file and writes out a new file. MSBuild Community Tasks ]]> Tokens in the template file are formatted using ${var} syntax and names are not case-sensitive, so ${Token} and ${TOKEN} are equivalent. Meta data tag used for token replacement Default constructor. Creates a new TemplateFile task. Executes the task. Success or failure of the task. The token replaced template file. The full path to the output file name. If no filename is specified (the default) the output file will be the Template filename with a .out extension. The template file used. Tokens with values of ${Name} are replaced by name. List of tokens to replace in the template. Token name is taken from the TaskItem.ItemSpec and the replacement value comes from the ReplacementValue metadata of the item. Gets the current date and time. See DateTimeFormatInfo for the syntax of the format string. Using the Time task to get the Month, Day, Year, Hour, Minute, and Second: ]]> Set property "BuildDate" to the current date and time: ]]> When overridden in a derived class, executes the task. True if the task successfully executed; otherwise, false. Gets or sets the format string for output parameter . See DateTimeFormatInfo for the syntax of the format string. Gets the month component of the date represented by this instance. Gets the day of the month represented by this instance. Gets the year component of the date represented by this instance. Gets the hour component of the date represented by this instance. Gets the minute component of the date represented by this instance. Gets the seconds component of the date represented by this instance. Gets the milliseconds component of the date represented by this instance. Gets the number of ticks that represent the date and time of this instance. Gets or sets a value that indicates whether the time represented by this instance is based on local time, Coordinated Universal Time (UTC), or neither. Possible values are: Local (default), Utc, Unspecified Gets the time of day for this instance. Gets the day of the year represented by this instance. Gets the day of the week represented by this instance. Gets the value of this instance to its equivalent string representation. If input parameter is provided, the value is formatted according to it. Gets the value of this instance to its equivalent short date string representation. Gets the value of this instance to its equivalent long date string representation. Gets the value of this instance to its equivalent short time string representation. Gets the value of this instance to its equivalent long time string representation. Gets the internal time value. Represents a single XmlNode selected using an XML task. Initializes a new instance of an XmlNodeTaskItem The selected XmlNode The prefix to attach to the reserved metadata properties. Returns a string representation of the XmlNodeTaskItem. Returns the ItemSpec when the XmlNodeTaskItem is explicitly cast as a The XmlNodeTaskItem Reads a value or values from lines of XML Use the Lines property (possibly populated from the the ReadLinesFromFile task) if you want to perform multiple queries against some XML in memory. Use the XmlFileName property to query a large XML file. An XPath expression can return multiple nodes in the collection. The number of nodes returned is availabe in the output TaskParameter. When the XPath expression resolves to an element node, all of the attributes of the element are added as metadata to the returned . In addition, some reserved metadata properties are available on all element nodes. They are all prefixed with the , which is a single underscore (_) by default. Reserved Property _value The value of the node (non-xml text between the opening and closing tags). _innerXml The markup representing the children of this node. _outerXml The markup representing this node and all its child nodes. Read an attribute value by selecting it with an XPath expression: ]]> Read attribute values (from an XML file) using item metadata on a selected element node: ]]> Read an element value (requires use of the reserved metadata property "_value"): ]]> When overridden in a derived class, executes the task. True if the task successfully executed; otherwise, false. The lines of a valid XML document Gets or sets the name of an XML file to query The full path of the XML file. A collection of prefix=namespace definitions used to query the XML document Defining multiple namespaces: />]]> The query used to identify the values in the XML document The values selected by The number of values returned in The string that is prepended to all reserved metadata properties. The default value is a single underscore: '_' All attributes of an element node are added as metadata to the returned ITaskItem, so this property can be used to avoid clashes with the reserved properties. For example, if you selected the following node: ]]> the _value attribute would clash with the value reserved property, when using the default prefix. If you set the ReservedMetaDataPrefix to another value (two underscores '__') there would be no clash. You would be able to select the attribute using %(item._value) and the value of the node using %(item.__value). Provides methods used by all of the XML tasks Concatenates the string value of a list of ITaskItems into a single string The items to concatenate A single string containing the values from all of the items Uses the prefix=namespace definitions in to populate The to populate. The prefix=namespace definitions. A task to merge and transform a set of xml files.

The xml files of parameter are merged into one xml document, wrapped with a root tag

If only one input file is provided, merging and wrapping can be omitted by setting to an empty string.

The root tag can be given any number of attributes by providing a list of semicolon-delimited name/value pairs to parameter . For example: RootAttributes="foo=bar;date=$(buildDate)"

Parameter defaults to one attribute with a name specified by , and a local time stamp as value. To suppress the default value, an empty parameter RootAttributes="" must be specified explicitely.

The xsl transformation file specified by parameter is applied on the input.

The can be given any number of metadata, which will be handed to the xsl transformation as parameters.

If only one input file is given with , metadata will also be handed to the xsl transformation. However, the metadata is preferred in case of equal names. To overcome this limitation, for each input item metadatum, an additional parameter prefixed with is created.

The output is written to the file specified by parameter .

This example for generating a report from a set of NUnit xml results: $(project) $(configuration) $(MSBuildProjectFullPath) $(MSBuildBinPath) $(MSBuildCommunityTasksPath)\$(nunitReportXsl) ]]> This examples shows all available task attributes: ]]> The name of the default attribute of the . The value is "created", and the attribute will contain a local time stamp. The prefix of XSLT parameters created from single XML input metadata. The value is "input_". When overridden in a derived class, executes the task. Returns true if the task successfully executed; otherwise, false. Adds a new xsl parameter with to the specified argument list. The name of the parameter. The value of the parameter. The parameter list. Whether the parameter was added. Does not add the parameter when a parameter with the same name is already part of the . Gets or sets the xml input files. Gets or sets the xml tag name of the root tag wrapped around the merged xml input files. Gets or sets the list of semicolon-delimited name/value pairs of the . For example: RootAttributes="foo=bar;date=$(buildDate)" Gets or sets the path of the xsl transformation file to apply. The property can be given any number of metadata, which will be handed to the xsl transformation as parameters. Gets or sets the path of the output file. Replace text in file(s) using a Regular Expression. Search for a version number and update the revision. ]]> Initializes a new instance of the class. Maintain the behaviour of the original implementation for compatibility (i.e. initialize _useDefaultEncoding with false) and use utf-8-without-bom, which is Microsoft's default encoding, only when Encoding property is set to "utf-8-without-bom". When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Gets or sets the files to update. The files. Gets or sets the regex. The regex. Gets or sets a value specifies case-insensitive matching. . true if [ignore case]; otherwise, false. Gets or sets a value changing the meaning of ^ and $ so they match at the beginning and end, respectively, of any line, and not just the beginning and end of the entire string. true if multiline; otherwise, false. Gets or sets a value changing the meaning of the dot (.) so it matches every character (instead of every character except \n). true if singleline; otherwise, false. Gets or sets the maximum number of times the replacement can occur. The replacement count. Gets or sets the replacement text. The replacement text. The character encoding used to read and write the file. Any value returned by is valid input. The default is utf-8 Additionally, utf-8-without-bomcan be used. When TRUE, a warning will be generated to show which file was not updated. N/A Uses FxCop to analyse managed code assemblies and reports on their design best-practice compliance. Shows how to analyse an assembly and use an XSLT stylesheet to present the report as an HTML file. If the static anlysis fails, the build does not stop - this is controlled with the FailOnError parameter. ]]> If you include the MSBuild.Community.Tasks.Targets file in you build project, the ItemGroup @(FxCopRuleAssemblies) is defined with the standard FxCop Rules Assemblies. Executes the task. if the task ran successfully; otherwise . Returns the fully qualified path to the executable file. The fully qualified path to the executable file. Returns a string value containing the command line arguments to pass directly to the executable file. A string value containing the command line arguments to pass directly to the executable file. Indicates whether all task paratmeters are valid. true if all task parameters are valid; otherwise, false Returns the directory in which to run the executable file. The directory in which to run the executable file, or a null reference (Nothing in Visual Basic) if the executable file should be run in the current directory. Tells FxCop to search the GAC for assembly references. This parameter was added in FxCop 1.35 Applies the XSL transformation specified in /outXsl to the analysis report before saving the file. Directs analysis output to the console or to the Output window in Visual Studio .NET. By default, the XSL file FxCopConsoleOutput.xsl is applied to the output before it is displayed. Specifies additional directories to search for assembly dependencies. FxCopCmd always searches the target assembly directory and the current working directory. Specifies the target assembly to analyze. Specifies the XSL or XSLT file that contains a transformation to be applied to the analysis output before it is displayed in the console. Specifies the name of an analysis report or project file to import. Any messages in the imported file that are marked as excluded are not included in the analysis results. Specifies the custom dictionary. Specifies the filename(s) of FxCop rule assemblies The list of rules to run Rule names should be provided using the format Library#RuleNumber. For example Microsoft.Design#CA1012 Place a single hyphen (-) in front of the rule name to exclude it. For example -Microsoft.Performance#CA1805 Specifies the file name for the analysis report. Specifies the XSL or XSLT file that is referenced by the xml-stylesheet processing instruction in the analysis report. Specifies the location of the version of Mscorlib.dll that was used when building the target assemblies if this version is not installed on the computer running FxCopCmd. Specifies the filename of FxCop project file. Includes a summary report with the informational messages returned by FxCopCmd. Comma-separated list of type names to analyze. This option disables analysis of assemblies, namespaces, and resources; only the specified types and their members are included in the analysis. Use the wildcard character '*' at the end of the name to select multiple types. Saves the results of the analysis in the project file. Gets or sets the working directory. The working directory. The directory in which to run the executable file, or a null reference (Nothing in Visual Basic) if the executable file should be run in the current directory. Gets or sets a value indicating whether the output is verbose. true if verbose; otherwise, false. Gets or sets a value indicating whether the build should fail if static code analysis reports errors. Defaults to true. true if verbose; otherwise, false. Gets the name of the executable file to run. The name of the executable file to run. Defines the actions that can be performed on a service. Starts a service. Stops a service. Restarts a service. Pauses a running service. Continues a paused service. Task that can control a Windows service. Restart Web Server ]]> Task that can determine the status of a specified service on a target server. Check status of SQL Server ]]> The unknown returned when the service does not exist. The value is "Unknown". Initializes a new instance of the class. Executes the task. if the task ran successfully; otherwise . Gets the service controller. Gets or sets the name of the service. The name of the service. Gets or sets the name of the machine. The name of the machine. Gets or sets the status. The status of the service. Gets a value indicating whether the service can be paused and resumed. true if this instance can pause and continue; otherwise, false. Gets a value indicating whether the service should be notified when the system is shutting down. true if this instance can shutdown; otherwise, false. Gets a value indicating whether the service can be stopped after it has started. true if this instance can stop; otherwise, false. Gets a friendly name for the service. The name of the display. Gets a value indicating whether the service exists. true if the service exists; otherwise, false. Initializes a new instance of the class. Executes the task. if the task ran successfully; otherwise . Gets or sets the to perform on the service. The action to perform on the service. Gets or sets the timeout for the command. The default is one minute. The timeout for the command. Task that can strip the source control information from a Visual Studio Solution and subprojects. This task is useful if you keep an archive of the source tree at each build milestone, because it's irritating to have to remove source control binding manually once you've copied a version of the code from your archive. Executes the task. if the task ran successfully; otherwise . 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. Create a new application pool on the local machine. ]]> When overridden in a derived class, executes the task. True if the task successfully executed; otherwise, false. Gets or sets the name of the application pool. The name of the application pool. The AppPoolAutoStart property indicates to the World Wide Web Publishing Service (WWW service) to automatically start an application pool when the application pool is created or when IIS is started, if the value of this property is set to true. Value indicating if AppPoolAutoStart is enabled or disabled. The AppPoolIdentityType property allows application pools to run as a specific user account: 0 - The application pool runs as NT AUTHORITY\SYSTEM. 1 - The application pool runs as NT AUTHORITY\LOCAL SERVICE. 2 - The application pool runs as NT AUTHORITY\NETWORK SERVICE. 3 - The application pool runs as a specific user account, defined by the property. Value indicating the application pool identity type. The AppPoolQueueLength property indicates to the Universal Listener how many requests to queue up for an application pool before rejecting future requests. When the limit for this property is exceeded, IIS rejects the additional requests with a 503 error. Value indicating the application pool queue length. The AutoShutdownAppPoolExe property specifies an executable to run when the World Wide Web Publishing Service (WWW service) shuts down an application pool for rapid fail protection. You can use the property to send parameters to the executable. Value indicating the application pool auto shutdown executable. The AutoShutdownAppPoolParams property specifies any command-line parameters for the executable that is specified in the AutoShutdownAppPoolExe property. You can use these two properties in the following way to send e-mail, for example, when the World Wide Web Publishing Service (WWW service) shuts down an application pool for rapid fail protection: AutoShutdownAppPoolExe = "C:\LogAndSendMail.bat" AutoShutdownAppPoolParams = "-AppPoolName %1%" where %1% represents the application pool name. Value indicating the parameters for the application pool auto shutdown executable. The CPUAction property configures the action(s) that IIS takes when Microsoft Windows NT ® job objects run. Only one Windows NT job object exists per application pool, therefore the CPUAction property is configured on a per application pool basis. Possible values: 0 - No action is taken except that a warning is written to the event log when the CPU limit is exceeded. 1 - Application pool worker processes that exceed their CPU limit will be forced to shut down. Value indicating the CPU action. The CPULimit property configures the maximum percentage of CPU resources that worker processes in an application pool are allowed to consume over a period of time, as indicated by the property. Set this property by specifying a percentage of CPU usage, multiplied by 1000. For example, if you want the CPU usage limit to be 50%, set CPULimit to 50,000. Value indicating the CPU limit. The CPUResetInterval property specifies the reset period (in minutes) for CPU monitoring and throttling limits on the application pool. When the number of minutes elapsed since the last process accounting reset equals the number specified by this property, IIS will reset the CPU timers for both the logging and limit intervals. Setting the value of this property to 0 disables CPU monitoring. Value indicating the CPU reset interval. The DisallowOverlappingRotation property specifies whether or not the World Wide Web Publishing Service (WWW Service) should start up another worker process to replace the existing worker process while it is shutting down. Value indicating the DisallowOverlappingRotation. The DisallowRotationOnConfigChange property specifies whether or not the World Wide Web Publishing Service (WWW Service) should rotate worker processes in an application pool when the configuration has changed. This means that the worker processes will not pick up application pool changes to values passed to the worker process, such as and . Value indicating the DisallowRotationOnConfigChange. The IdleTimeout property specifies how long (in minutes) a worker process should run idle if no new requests are received and the worker process is not processing requests. After the allotted time passes, the worker process should request to be shut down by the World Wide Web Publishing Service (WWW Service). Value indicating the idle timeout. The LoadBalancerCapabilities property specifies behavior when a service is unavailable. A setting of 1 terminates the connection. A setting of 2 sends error code 503. Value indicating the load balancer capabilities. The LogEventOnRecycle property specifies that IIS should log an event when an application pool is recycled. Application pools recycle for a variety of reasons. In order for IIS to log the event, the LogEventOnRecycle property must have a bit set corresponding to the reason for the recycle. Value indicating which recycle events to log. The LogonMethod property contains an integer that specifies the logon method for cleartext logons. Valid settings are: 0 for interactive logon. 1 for batch logon. 2 for network logon. 3 for cleartext logon. Value indicating the logon method. The MaxProcesses property determines the maximum number of worker processes an application pool allows to service requests for an application pool. This property cannot be set to 0 because there are no unmanaged pools. Value indicating the maximum number of worker processes allowed by the application pool. The OrphanActionExe property specifies an executable to run when the World Wide Web Publishing Service (WWW service) orphans a worker process. You can use the property to send parameters to the executable. The value for the orphan action executable. The OrphanActionParams property specifies command-line parameters for the executable specified by the property. Value indicating the orphan action parameters. The OrphanWorkerProcess property, when set to true, notifies the World Wide Web Publishing Service (WWW Service) not to terminate a worker process that fails to respond to pings, but to instead orphan the worker process in the application pool if the worker process suffers fatal errors. Value indicating the orphan worker process. The PeriodicRestartMemory property specifies the amount of virtual memory (in KB) that a worker process can use before the worker process recycles. The maximum value supported for this property is 4,294,967 KB. Value indicating the amount of memory. The PeriodicRestartPrivateMemory property specifies the amount of private memory (in KB) that a worker process can use before the worker process recycles. The maximum value supported for this property is 4,294,967 KB. Value indicating the amount of memory. The PeriodicRestartRequests property indicates the number of requests the OOP application should process, after which it is recycled. Value indicating the number of requests. The PeriodicRestartSchedule property specifies the time (in 24 hour format) that the application will be rotated. Each time is in local time and is specified in the following format: PeriodicRestartSchedule="hh:mm,hh:mm,hh:mm" Value indicating the restart schedule. The PeriodicRestartTime property specifies the period of time, in minutes, after which IIS rotates an isolated OOP application. Setting the value of this property to 0 disables the property. The maximum supported value for this property is 71,582. Value indicating the restart time period. The PingingEnabled property specifies whether the World Wide Web Publishing Service (WWW Service) should periodically monitor the health of a worker process. Setting the value of this property to true indicates to the WWW service to monitor the worker processes to ensure that the they are running and healthy. Value indicating if pinging is enabled or disabled. The PingInterval property specifies the period of time (in seconds) between health-monitoring pings that the World Wide Web Publishing Service (WWW Service) sends to a worker process. Value indicating the ping interval. The PingResponseTime property specifies the amount of time (in seconds) that a worker process is given to respond to a health monitoring ping. After the time limit is exceeded, the World Wide Web Publishing Service (WWW Service) terminates the worker process. Value indicating the ping response time. Setting the RapidFailProtection property to true instructs the World Wide Web Publishing Service (WWW service) to put all applications in an application pool out of service if the number of worker process crashes has reached the maximum specified by the property, within the number of minutes specified by the property. Value indicating if rapid fail protection is enabled or disabled. The RapidFailProtectionInterval property specifies the number of minutes before the failure count for a process is reset. See . Value indicating the rapid fail protection interval. The RapidFailProtectionMaxCrashes property specifies the maximum number of failures allowed within the number of minutes specified by the property. See . Value indicating the maximum number of crashes. The ShutdownTimeLimit property specifies the amount of time (in seconds) after a recycle threshold has been reached that IIS waits for all old requests to finish running in a worker process before terminating the worker process. Value indicating the shutdown time limit. Setting the SMPAffinitized property to true indicates that a particular worker process assigned to an application pool should be assigned to a given CPU. This property is used in conjunction with the property to configure a particular processor a worker process will be assigned to. Value indicating if SMPAffinitized is enabled or disabled. The SMPProcessorAffinityMask property configures the hexadecimal processor mask. The hexadecimal processor mask indicates to which CPU the worker processes in an application pool should be bound. Before this property takes affect, the property must be set to true for the application pool. These properties cannot be set through IIS Manager. Do not set this property to zero. Doing so causes no SMP affinity to be configured, creating an error condition. The default DWORD value is 4294967295 (or -1), which is represented in hexadecimal as 0xFFFFFFFF. A value of 0xFFFFFFFF in SMPProcessorAffinityMask indicates that all processors are enabled. Value indicating the SMP processor affinity bit mask. The value of the StartupTimeLimit property specifies the amount of time (in seconds) that the World Wide Web Publishing Service (WWW Service) should wait for a worker process to finish starting up and reporting to the WWW Service. Value indicating the startup time limit. The WAMUserName property specifies the account user name that IIS uses by default as the COM+ application identity for newly created IIS out-of-process applications. The values of this property and its companion property, , are set when IIS is installed, and match the user name and password values in the Microsoft Windows user account, which is established at the same time. Changing the value of this property is not recommended. If you do, change it to a valid Windows user account, and change WAMUserPass to the corresponding password for the new account. Important: Changes to WAMUserName and WAMUserPass may disrupt the operation of existing IIS out-of-process applications. You can synchronize application identities using Component Services to edit the user name and password values, found on the Identity tab of the property sheet for each package. In-process applications are not affected by these property values. Value indicating the username. The WAMUserPass property specifies the password for the account that IIS uses by default as the COM+ application identity for newly created IIS out-of-process applications. The values of this property and its companion property, , are set when IIS is installed, and match the password and user name values in the Microsoft Windows user account (IWAM_ MachineName, where MachineName is the name of the machine on which IIS is installed) established at the same time. Important: Changing the value of this property is not recommended. If you do, you must change the Windows account password to the identical value. You must also synchronize existing IIS out-of-process application identities, using Component Services to edit the user name and password values, which are found on the Identity tab of the property sheet for each package. In-process applications are not affected by these property values. Value indicating the password. 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. Create a new web directory on the local machine. ]]> When overridden in a derived class, executes the task. True if the task successfully executed; otherwise, false. Gets or sets the name of the virtual directory. The name of the virtual directory. Gets or sets the virtual directory physical path. The physical directory must exist before this task executes. The virtual directory physical path. Gets or sets a value that indicates if the file or the contents of the folder may be executed, regardless of file type. A value indicating if AccessExecute is enabled or disabled. A value of true indicates that remote requests to execute applications are denied; only requests from the same computer as the IIS server succeed if the AccessExecute property is set to true. You cannot set AccessNoRemoteExecute to false to enable remote requests, and set to false to disable local requests. Value indicating if AccessNoRemoteExecute is enabled or disabled. A value of true indicates that remote requests to view files are denied; only requests from the same computer as the IIS server succeed if the property is set to true. You cannot set to false to enable remote requests, and set to false to disable local requests. Value indicating if AccessNoRemoteRead is enabled or disabled. A value of true indicates that remote requests to view dynamic content are denied; only requests from the same computer as the IIS server succeed if the property is set to true. You cannot set AccessNoRemoteScript to false to enable remote requests, and set to false to disable local requests. Value indicating if AccessNoRemoteScript is enabled or disabled. A value of true indicates that remote requests to create or change files are denied; only requests from the same computer as the IIS server succeed if the property is set to true. You cannot set AccessNoRemoteWrite to false to enable remote requests, and set to false to disable local requests. Value indicating if AccessNoRemoteWrite is enabled or disabled. A value of true indicates that the file or the contents of the folder may be read through Microsoft Internet Explorer. Value indicating if AccessRead is enabled or disabled. A value of true indicates that users are allowed to access source code if either Read or Write permissions are set. Source code includes scripts in Microsoft ® Active Server Pages (ASP) applications. Value indicating if AccessSource is enabled or disabled. A value of true indicates that the file or the contents of the folder may be executed if they are script files or static content. A value of false only allows static files, such as HTML files, to be served. Value indicating if AccessScript is enabled or disabled. A value of true indicates that file access requires SSL file permission processing, with or without a client certificate. Value indicating if AccessSsl is enabled or disabled. A value of true indicates that file access requires SSL file permission processing with a minimum key size of 128 bits, with or without a client certificate. Value indicating if AccessSsl128 is enabled or disabled. A value of true indicates that SSL file permission processing maps a client certificate to a Microsoft Windows ® operating system user-account. The property must also be set to true for the mapping to occur. Value indicating if AccessSslMapCert is enabled or disabled. A value of true indicates that SSL file access processing requests a certificate from the client. A value of false indicates that access continues if the client does not have a certificate. Some versions of Internet Explorer will close the connection if the server requests a certificate and a certificate is not available (even if is also set to true). Value indicating if AccessSslNegotiateCert is enabled or disabled. A value of true indicates that SSL file access processing requests a certificate from the client. If the client provides no certificate, the connection is closed. must also be set to true when using AccessSSLRequireCert. Value indicating if AccessSslRequireCert is enabled or disabled. A value of true indicates that users are allowed to upload files and their associated properties to the enabled directory on your server or to change content in a Write-enabled file. Write can be implemented only with a browser that supports the PUT feature of the HTTP 1.1 protocol standard. Value indicating if AccessWrite is enabled or disabled. The AnonymousPasswordSync property indicates whether IIS should handle the user password for anonymous users attempting to access resources. Value indicating if AnonymousPasswordSync is enabled or disabled. The AppAllowClientDebug property specifies whether ASP client-side debugging is enabled. This property is independent of , which applies to server-side debugging. Value indicating if AppAllowClientDebug is enabled or disabled. The AppAllowDebugging property specifies whether ASP debugging is enabled on the server. This property is independent of the property, which applies to client-side debugging. Value indicating if AppAllowDebugging is enabled or disabled. The AspAllowSessionState property enables session state persistence for the ASP application. Value indicating if the AspAllowSessionState is enabled or disabled. The AspBufferingOn property specifies whether output from an ASP application will be buffered. Value indicating if the AspBufferingOn is enabled or disabled. The AspEnableApplicationRestart determines whether an ASP application can be automatically restarted. When changes are made to Global.asa or metabase properties that affect an application, the application will not restart unless the AspEnableApplicationRestart property is set to true. Value indicating if AspEnableApplicationRestart is enabled or disabled. The AspEnableAspHtmlFallback property controls the behavior of ASP when a new request is to be rejected due to a full request queue. Value indicating if AspEnableAspHtmlFallback is enabled or disabled. The AspEnableChunkedEncoding property specifies whether HTTP 1.1 chunked transfer encoding is enabled for the World Wide Web Publishing Service (WWW service). Value indicating if AspEnableChunkedEncoding is enabled or disabled. The AspErrorsToNTLog property specifies which ASP errors are written to the Windows event log. ASP errors are written to the client browser and to the IIS log files by default. Value indicating if AspErrorsToNTLog is enabled or disabled. The AspEnableParentPaths property specifies whether an ASP page allows paths relative to the current directory (using the ..\ notation) or above the current directory. Value indicating if AspEnableParentPaths is enabled or disabled. The AspEnableTypelibCache property specifies whether type libraries are cached on the server. The World Wide Web Publishing Service (WWW service) setting for this property is applicable to all in-process and pooled out-of-process application nodes, at all levels. Metabase settings at the Web server level or lower are ignored for in-process and pooled out-of-process applications. However, settings at the Web server level or lower are used if that node is an isolated out-of-process application. Value indicating if AspEnableTypelibCache is enabled or disabled. The AspExceptionCatchEnable property specifies whether ASP pages trap exceptions thrown by components. Value indicating if AspExceptionCatchEnable is enabled or disabled. The AspLogErrorRequests property controls whether the Web server writes ASP errors to the application section of the Windows event log. ASP errors are written to the client browser and to the IIS log files by default. Value indicating if AspLogErrorRequests is enabled or disabled. The AspScriptErrorSentToBrowser property specifies whether the Web server writes debugging specifics (file name, error, line number, description) to the client browser, in addition to logging them to the Windows Event Log. The property provides the error message to be sent if this property is set to false. Value indicating if AspScriptErrorSentToBrowser is enabled or disabled. The AspTrackThreadingModel property specifies whether IIS checks the threading model of any components (COM objects) that your application creates. The preferred setting of this metabase property is false. Value indicating if AspTrackThreadingModel is enabled or disabled. Specifies Anonymous authentication as one of the possible Windows authentication schemes returned to clients as being available. Value indicating if AuthAnonymous is enabled or disabled. Specifies Basic authentication as one of the possible Windows authentication schemes returned to clients as being available. Value indicating if AuthBasic is enabled or disabled. Specifies Integrated Windows authentication (also known as Challenge/Response or NTLM authentication) as one of the possible Windows authentication schemes returned to clients as being available. Value indicating if AuthNtlm is enabled or disabled. Setting this flag to true specifies that authentication persists only for a single request on a connection. IIS resets the authentication at the end of each request, and forces re-authentication on the next request of the session. Value indicating if AuthPersistSingleRequest is enabled or disabled. Setting this flag to true specifies authentication will persist only across single requests on a connection if the connection is by proxy. IIS will reset the authentication at the end of the request if the current authenticated request is by proxy and it is not the special case where IIS is running MSPROXY. Value indicating if AuthPersistSingleRequestIfProxy is enabled or disabled. Setting this flag to true specifies that authentication is valid for a single request if by proxy. IIS will reset the authentication at the end of the request and force re-authentication on the next request if the current authenticated request is by proxy of any type. Value indicating if AuthPersistSingleRequestAlwaysIfProxy is enabled or disabled. The CacheControlNoCache property specifies the HTTP 1.1 directive to prevent caching of content. Value indicating if CacheControlNoCache is enabled or disabled. The CacheISAPI property indicates whether ISAPI extensions are cached in memory after first use. Value indicating if CacheIsapi is enabled or disabled. The ContentIndexed property specifies whether the installed content indexer should index content under this directory tree. Value indicating if ContentIndexed is enabled or disabled. This property specifies whether process accounting and throttling should be performed for ISAPI extensions and ASP applications. To perform process accounting on CGI applications, use the property . Value indicating if CpuAppEnabled is enabled or disabled. This property indicates whether IIS should perform process accounting for CGI applications. To effectively throttle CGI applications, use the CgiTimeout property. To use process accounting for ISAPI and ASP applications, use . Value indicating if CpuCgiEnabled is enabled or disabled. The CreateCGIWithNewConsole property indicates whether a CGI application runs in its own console. Value indicating if CreateCgiWithNewConsole is enabled or disabled. The CreateProcessAsUser property specifies whether a CGI process is created in the system context or in the context of the requesting user. Value indicating if CreateProcessAsUser is enabled or disabled. When set to true, date information is displayed when browsing directories. Value indicating if DirBrowseShowDate is enabled or disabled. When set to true, file name extensions are displayed when browsing directories. Value indicating if DirBrowseShowExtension is enabled or disabled. When set to true, date information is displayed in extended format when displaying directories. Value indicating if DirBrowseShowLongDate is enabled or disabled. When set to true, file size information is displayed when browsing directories. Value indicating if DirBrowseShowSize is enabled or disabled. When set to true, file time information is displayed when displaying directories. Value indicating if DirBrowseShowTime is enabled or disabled. The DontLog property specifies whether client requests are written to the IIS log files. Value indicating if DontLog is enabled or disabled. When set to true, the default document (specified by the property) for a directory is loaded when the directory is browsed. Value indicating if EnableDefaultDoc is enabled or disabled. When set to true, directory browsing is enabled. Value indicating if EnableDirBrowsing is enabled or disabled. The EnableDocFooter property enables or disables custom footers specified by the DefaultDocFooter property. Value indicating if EnableDocFooter is enabled or disabled. The EnableReverseDns property enables or disables reverse Domain Name Server (DNS) lookups for the World Wide Web Publishing Service (WWW service). Reverse lookups involve looking up the domain name when the IP address is known. Reverse DNS lookups can use significant resources and time. Value indicating if EnableReverseDns is enabled or disabled. The SSIExecDisable property specifies whether server-side include (SSI) #exec directives are disabled under this path. Value indicating if SsiExecDisable is enabled or disabled. The UNCAuthenticationPassthrough property enables user authentication passthrough for Universal Naming Convention (UNC) virtual root access (for authentication schemes that support delegation). Value indicating if UncAuthenticationPassthrough is enabled or disabled. The AspScriptErrorMessage property specifies the error message to send to the browser if specific debugging errors are not sent to the client (if is set to false). Value indicating if AspScriptErrorMessage is enabled or disabled. The DefaultDoc contains one or more file names of default documents that will be returned to the client if no file name is included in the client's request. The default document will be returned if the flag of the DirBrowseFlags property is set to true for the directory. This property can contain a list of default document file names separated by a comma and a space, for example Default.htm, Default.asp. Listing of the default documents for the web application. 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. Delete an existing application pool on the local machine. ]]> When overridden in a derived class, executes the task. True if the task successfully executed; otherwise, false. Gets or sets the name of the application pool. The name of the application pool. 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. Deletes a web directory on the local machine. ]]> When overridden in a derived class, executes the task. True if the task successfully executed; otherwise, false. Gets or sets the name of the virtual directory. The name of the virtual directory. Actions the can do. Start the applicaiton pool Stop the applicaiton pool Restart the applicaiton pool Recycle the applicaiton pool 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. Restart an application pool on the local machine. ]]> When overridden in a derived class, executes the task. True if the task successfully executed; otherwise, false. Gets or sets the name of the app pool. The name of the app pool. Gets or sets the application pool action. The application pool action. Sends an email message Example of sending an email. ]]> Initializes a new instance of the class. Sends an email message Returns true if successful List of files to attach to message List of addresss that contains the blind carbon copy (BCC) recipients for this e-mail message List of addresss that contains the carbon copy (CC) recipients for this e-mail message The email message body The from address for this e-mail message This property is required. A value indicating whether the mail message body is in Html The priority of this e-mail message Possible values are High, Normal, and Low The subject line for this e-mail message This property is required. The name or IP address of the host used for SMTP transactions This property is required. List of addresss that contains the recipients of this e-mail message This property is required. Gets or sets the username. The username. Gets or sets the password. The password. Specify whether the Mail task uses SSL to encrypt the connection. true if the Mail task uses SSL; otherwise false. The default value is false. Add numbers Adding numbers: ]]> When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Divide numbers ]]> Above example will display: Divide 1/2= 0.5 Truncate the result to always return an integer: ]]> Above example will display: Divide 7/3= 2 When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. When , uses integer division to truncate the result. Default is Any remainder in the result is dropped, and the closest integer to zero is returned. Refer to the documentation for the \ Operator for more information about integer division. Multiple numbers ]]> When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Subtract numbers ]]> When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Moves files on the filesystem to a new location. Move a file to another folder ]]> Rename a file ]]> When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Gets the items that were successfully moved. The moved files. Gets or sets the list of files to moved the source files to. This list is expected to be a one-to-one mapping with the list specified in the SourceFiles parameter. That is, the first file specified in SourceFiles will be moved to the first location specified in DestinationFiles, and so forth. The destination files. Gets or sets the directory to which you want to move the files. The destination folder. Gets or sets the source files to move. The source files to move. Runs the NDoc application. Generated html help file. ]]> Initializes a new instance of the class. Returns a string value containing the command line arguments to pass directly to the executable file. A string value containing the command line arguments to pass directly to the executable file. Returns the fully qualified path to the executable file. The fully qualified path to the executable file. Logs the starting point of the run to all registered loggers. A descriptive message to provide loggers, usually the command line and switches. Returns the directory in which to run the executable file. The directory in which to run the executable file, or a null reference (Nothing in Visual Basic) if the executable file should be run in the current directory. Gets or sets the documenter. The documenter. Available documenters are VS.NET_2003, JavaDoc, LaTeX, LinearHtml, MSDN, XML. Gets or sets the project file path. The project file path. Gets or sets a value indicating whether the output is verbose. true if verbose; otherwise, false. Gets or sets the working directory. The working directory. The directory in which to run the executable file, or a null reference (Nothing in Visual Basic) if the executable file should be run in the current directory. Gets the name of the executable file to run. The name of the executable file to run. Gets the with which to log errors. The with which to log errors. Run NUnit 2.4 on a group of assemblies. Run NUnit tests. ]]> The default relative path of the NUnit installation. The value is @"NUnit 2.4\bin". Initializes a new instance of the class. Returns a string value containing the command line arguments to pass directly to the executable file. A string value containing the command line arguments to pass directly to the executable file. Returns the fully qualified path to the executable file. The fully qualified path to the executable file. Logs the starting point of the run to all registered loggers. A descriptive message to provide loggers, usually the command line and switches. Returns the directory in which to run the executable file. The directory in which to run the executable file, or a null reference (Nothing in Visual Basic) if the executable file should be run in the current directory. Gets or sets the assemblies. The assemblies. Gets or sets the categories to include. Multiple values must be separated by a comma "," Gets or sets the categories to exclude. Multiple values must be separated by a comma "," Gets or sets the fixture. The fixture. Gets or sets the XSLT transform file. The XSLT transform file. Gets or sets the output XML file. The output XML file. The file to receive test error details. Gets or sets the working directory. The working directory. The directory in which to run the executable file, or a null reference (Nothing in Visual Basic) if the executable file should be run in the current directory. Determines whether assemblies are copied to a shadow folder during testing. Shadow copying is enabled by default. If you want to test the assemblies "in place", you must set this property to True. The project configuration to run. Only applies when a project file is used. The default is the first configuration, usually Debug. Allows tests to be run in a new thread, allowing you to take advantage of ApartmentState and ThreadPriority settings in the config file. Determines whether the tests are run in a 32bit process on a 64bit OS. Determines the framework to run aganist. Gets the name of the executable file to run. The name of the executable file to run. Gets the with which to log errors. The with which to log errors. A strongly-typed resource class, for looking up localized strings, etc. Returns the cached ResourceManager instance used by this class. Overrides the current thread's CurrentUICulture property for all resource lookups using this strongly typed resource class. Looks up a localized string similar to Failed to lookup information for {0} in Active Directory.. Looks up a localized string similar to Attrib directory '{0}'. {1}. Looks up a localized string similar to Attrib file '{0}'. {1}. Looks up a localized string similar to Couldn't connect to remove server.. Looks up a localized string similar to Couldn't resolve server host name {0}.. Looks up a localized string similar to Creating directory "{0}".. Looks up a localized string similar to Both "{0}" and "{1}" were specified as input parameters in the project file. Please choose one or the other.. Looks up a localized string similar to File Not Found: {0}. Looks up a localized string similar to Local File Not Found: {0}. Looks up a localized string similar to {0}% Complete ({1}). Looks up a localized string similar to Transfered {0} ({1}) in {2}. Looks up a localized string similar to Upload File Complete, {0}. Looks up a localized string similar to Uploading "{0}" to "{1}" . Looks up a localized string similar to The URI "{0}" scheme is not valid.. Looks up a localized string similar to Compressed by {0}, from {1} to {2} byte(s). Looks up a localized string similar to Compressing JavaScript in "{0}".. Looks up a localized string similar to Writing compressed JavaScript back to "{0}" using {1}.. Looks up a localized string similar to Emailing "{0}".. Looks up a localized string similar to "{0}" is not a number.. Looks up a localized string similar to Merge Complete: {0} files merged into '{1}'.. Looks up a localized string similar to Merge Complete: No source files to merge.. Looks up a localized string similar to Merging file '{0}' into '{1}'. Looks up a localized string similar to Unable to move file "{0}" to "{1}". {2}. Looks up a localized string similar to Moving file from "{0}" to "{1}".. Looks up a localized string similar to Could not find the NUnit Project File open command. Please make sure NUnit is installed.. Looks up a localized string similar to Checking Oracle Home: {0}. Looks up a localized string similar to The parameter "{1}" does not apply to the current use of task "{0}".. Looks up a localized string similar to The "{0}" task was not given a value for the required parameter "{1}".. Looks up a localized string similar to Read Windows Registry. Looks up a localized string similar to Write Windows Registry. Looks up a localized string similar to Cannot continue service {0} on computer '{1}' as it does not support the pause and continue.. Looks up a localized string similar to Cannot pause service {0} on computer '{1}' as it does not support the pause and continue.. Looks up a localized string similar to Cannot stop service {0} on computer '{1}'.. Looks up a localized string similar to {0} service was continued successfully.. Looks up a localized string similar to {0} service is continuing .... Looks up a localized string similar to Couldn't find the '{0}' service on '{1}'. Looks up a localized string similar to Cannot continue service {0} on computer '{1}' as its not currently paused.. Looks up a localized string similar to Cannot pause service {0} on computer '{1}' as its not currently started.. Looks up a localized string similar to {0} service was paused successfully.. Looks up a localized string similar to {0} service is pausing .... Looks up a localized string similar to {0} service was started successfully.. Looks up a localized string similar to {0} service is starting .... Looks up a localized string similar to The '{0}' service on '{1}' is '{2}'.. Looks up a localized string similar to {0} service was stopped successfully.. Looks up a localized string similar to {0} service is stopping .... Looks up a localized string similar to Solution file "{0}" not found.. Looks up a localized string similar to LocalPath is not a working subversion copy.. Looks up a localized string similar to Could not {0} the file "{1}" to the destination file "{2}", because the destination is a folder instead of a file. To {0} the source file into a folder, consider using the DestinationFolder parameter instead of DestinationFiles.. Looks up a localized string similar to No destination specified for {0}. Please supply either "{1}" or "{2}".. Looks up a localized string similar to The source file "{0}" is actually a directory. The "{1}" task does not support moving directories.. Looks up a localized string similar to Failed to get current date!. Looks up a localized string similar to Getting current date.. Looks up a localized string similar to Adding TNSNAMES entry "{0}" to "{1}". Looks up a localized string similar to Looking for {0}. Looks up a localized string similar to Unable to locate a TNSNAMES.ORA file. Please specify a value for TnsNamesFile.. Looks up a localized string similar to TNSNAME entry "{0}" already exists in "{1}" and AllowUpdates=false.. Looks up a localized string similar to Updating TNSNAMES entry "{0}" in "{1}". Looks up a localized string similar to "{2}" refers to {0} item(s), and "{3}" refers to {1} item(s). They must have the same number of items.. Looks up a localized string similar to extracted "{0}". Looks up a localized string similar to Unzip File "{0}" to Directory "{1}" . Looks up a localized string similar to Unzipped file "{0}" successfully.. Looks up a localized string similar to Commitment of change set failed!. Looks up a localized string similar to Files added to Vault repository successfully.. Looks up a localized string similar to Files specified for addition to repository cannot be found.. Looks up a localized string similar to The file {0} could not be checked in: {1}.. Looks up a localized string similar to File or folder {0} not found for checkin.. Looks up a localized string similar to The folder {0} could not be checked in: {1}.. Looks up a localized string similar to {0} successfully checked out.. Looks up a localized string similar to {0} successfully checked out.. Looks up a localized string similar to Specified diskfile {0} does not exist.. Looks up a localized string similar to File [{0}] added to change set.. Looks up a localized string similar to Folder [{0}] added to change set.. Looks up a localized string similar to Incorrect parameters passed to VaultSession.. Looks up a localized string similar to Login to Vault repository failed.. Looks up a localized string similar to Error validating path "{0}".. Looks up a localized string similar to Selection of the repository failed: {0}.. Looks up a localized string similar to File or folder {0} not found for checkout.. Looks up a localized string similar to Set working folder for {0} to {1} from {2}.. Looks up a localized string similar to ClientInstance.TreeCache has not been initialized, Common cause is that SelectRepository has not been called sucessfully.. Looks up a localized string similar to Successfully undid check out for {0}.. Looks up a localized string similar to Url specifying vault location is required.. Looks up a localized string similar to Username must be set to access repository.. Looks up a localized string similar to Clearing working folder for {0}.. Looks up a localized string similar to Restoring working folder for {0} to {1}.. Looks up a localized string similar to Version file "{0}" not found - creating new file.. Looks up a localized string similar to Updated to version {0}. Looks up a localized string similar to Initialized to version {0}. Looks up a localized string similar to Reading version from file "{0}".. Looks up a localized string similar to Unable to read version number from "{0}". {1}. Looks up a localized string similar to Unable to write version number to "{0}". {1}". Looks up a localized string similar to Wrote version to file "{0}".. Looks up a localized string similar to Web directory {0} does not exist on {1}.. Looks up a localized string similar to Setting scriptmap for {0} on web directory {1} on {2}.. Looks up a localized string similar to Web directory {0} on {1} does not have a setting called {2}.. Looks up a localized string similar to Reading {0} property of web directory {1} on {2}.. Looks up a localized string similar to Setting {0} property of web directory {1} on {2}.. Looks up a localized string similar to Reading Xml Document "{0}".. Looks up a localized string similar to {0} node(s) selected for read.. Looks up a localized string similar to XmlRead Result: "{0}". Looks up a localized string similar to Updating Xml Document "{0}".. Looks up a localized string similar to {0} node(s) selected for update.. Looks up a localized string similar to XmlUpdate Wrote: "{0}".. Looks up a localized string similar to Adding Parameter "{0}": "{1}".. Looks up a localized string similar to Adding root attribute {0}="{1}".. Looks up a localized string similar to Creating root tag "{0}".. Looks up a localized string similar to No input files.. Looks up a localized string similar to No root tag inserted.. Looks up a localized string similar to added "{0}".. Looks up a localized string similar to Creating zip file "{0}".. Looks up a localized string similar to Zip File Not Found: {0}.. Looks up a localized string similar to Created zip file "{0}" successfully.. Reads a value from the Registry Read .NET Framework install root from Registry. ]]> The parameter is set according to the following rules: If a is provided, it will be used if the or does not exist. If a is not provided, the exists, but the does not exist, will be set to an empty string. If a is not provided, and the does not exist, the task will fail. Initializes a new instance of the class. When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Gets or sets the full registry path of the key, beginning with a valid registry root, such as "HKEY_CURRENT_USER". The name of the key. Gets or sets the name of the name/value pair. The name of the value. Gets or sets the default value. The default value. Gets the stored value. The value. Writes a value to the Registry Write a value to Registry ]]> Initializes a new instance of the class. When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Gets or sets the full registry path of the key, beginning with a valid registry root, such as "HKEY_CURRENT_USER". The name of the key. Gets or sets the name of the name/value pair. The name of the value. Gets or sets the value to be stored. The value. Executes code contained within the task. Simple script that writes to the console ]]> Executes the task. if the task ran successfully; otherwise . The required references The namespaces to import. The language of the script block (defaults to C#). The supported languages are: Visual Basic.NET (VB, vb, VISUALBASIC) C# (C#, c#, CSHARP) JavaScript (JS, js, JSCRIPT) J# (VJS, vjs, JSHARP) or, proviude the fully-qualified name for a class implementing . The name of the main class containing the static ScriptMain entry point. The code to compile and execute The code must include a static (Shared in VB) method named ScriptMain. It cannot accept any parameters. If you define the method return a , the returned value will be available in the output property. The string returned from the custom ScriptMain method. A task for sleeping for a specified period of time. Causes the build to sleep for 300 milliseconds. ]]> Executes the task. if the task ran successfully; otherwise . The number of milliseconds to add to the time to sleep. The number of seconds to add to the time to sleep. The number of minutes to add to the time to sleep. The number of hours to add to the time to sleep. Base class for all of the Visual SourceSafe tasks. Attempts to connect to the SourceSafe Database and load the specified item, or version of the item, if specified. Reserved. Reserved. Logs an exception using the MSBuild logging framework. The to log. The path to the folder that contains the srcsafe.ini file. The Visual SourceSafe project or file to perform the action on (starts with "$/"). The name of the user accessing the SourceSafe database. A version of the to reference. The password to use to log in to SourceSafe. Represents the VSS Database Represents the VSS item selected (file or project). Task that executes a checkin against a VSS Database. ]]> Base class for VSS tasks that can act recursively. Reserved. Reserved. Determines whether to perform the SourceSafe operation recursively. The default is . Executes the task. if the task ran successfully; otherwise . The path to the local working directory. Determines whether to leave the file(s) as writable once the checkin is complete. The default is . The checkin comment. Task that executes a checkout of files or projects against a Visual SourceSafe database. ]]> Executes the task. if the task ran successfully; otherwise . The path to the local working directory. Determines whether files will be writable once retrieved from the repository. The default is . Task that adds files to a Visual SourceSafe database. Executes the task. if the task ran successfully; otherwise . List of files that should be added to SourceSafe. The comment to be applied to the newly added file. 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. Generates a file containing all of the differences between the current version and the label "Test Label" ]]> Executes the task. if the task ran successfully; otherwise . The value of the label to compare to. The name of the file to send the output to. Task that retireves an item or project from a Visual SourceSafe database. Get the latest version (recursive) of a file from a VSS database and place in the specified local folder. Runs the task using the specified parameters. if the task ran successfully; otherwise . The path to the local working directory. Determines whether to replace writable files. The default is . Determines whether files will be writable once retrieved from the repository. The default is . Generates an XML file containing details of all changes made to a Visual SourceSafe project or file between specified labels or dates. Generates a file containing details of all the changes made to the $/Test project by a user called joe.bloggs ]]> Generates a file containing details of all the changes made between the labels Build1 and Build2 in the $/Test project. ]]> Generates a file containing details of all the changes made between the 1st December 2005 and 10th December 2005in the $/Test project. ]]> Executes the task. if the task ran successfully; otherwise . The label to start comparing to. The label to compare up to. The Start Date for the history. The End Date for the history. The name and path of the XML output file. The name of the user whose changes should be listed in the history. Task that applies a label to a Visual SourceSafe item. Executes the task. if the task ran successfully; otherwise . The text of the label. An optional comment. Task that undoes a checkout of files or projects against a Visual SourceSafe database. ]]> Executes the task. if the task ran successfully; otherwise . The path to the local working directory. Executes a SQL command. Execute a SQL command against a database. Target attributes to set: ConnectionString (required), Command (required, the SQL to execute), SelectMode (NonQuery, Scalar, or ScalarXml, default is NonQuery), OutputFile (required when SelectMode is Scalar or ScalarXml). Note: ScalarXml was created because of the 2033 byte limit on the sql return. See http://aspnetresources.com/blog/executescalar_truncates_xml.aspx for details. Example of returning a count of items in a table. Uses the default SelectMode of NonQuery. ]]> Example of returning the items of a table in an xml format. ]]> When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Determines if an output file was specified. The connection string The command to execute Command Timeout Defaults to 30 seconds. Set to 0 for an infinite timeout period. The SQL Selection Mode. Set to NonQuery, Scalar, or ScalarXml. Default is NonQuery. The file name to write to Output the return count/value Checkout a local working copy of a Subversion repository. Checkout a working copy ]]> Initializes a new instance of the class. Indicates whether all task paratmeters are valid. true if all task parameters are valid; otherwise, false. Subversion Commit command Initializes a new instance of the class. Indicates whether all task paratmeters are valid. true if all task parameters are valid; otherwise, false. Export a folder from a Subversion repository Export from repository ]]> Initializes a new instance of the class. Indicates whether all task paratmeters are valid. true if all task parameters are valid; otherwise, false. Summarize the local revision(s) of a working copy. The following example gets the revision of the current folder. ]]> Initializes a new instance of the class. Returns the fully qualified path to the executable file. The fully qualified path to the executable file. Logs the starting point of the run to all registered loggers. A descriptive message to provide loggers, usually the command line and switches. Returns a string value containing the command line arguments to pass directly to the executable file. A string value containing the command line arguments to pass directly to the executable file. Runs the exectuable file with the specified task parameters. true if the task runs successfully; otherwise, false. Logs the events from text output. The single line. The message importance. Path to local working copy. Specifies whether to use the last committed revision number as opposed to the last updated revision number. Revision number of the local working repository. High revision number of the local working repository revision range. Low revision number of the local working repository revision range. True if working copy contains modifications. True if working copy is switched. True if invoked on a directory that is not a working copy, svnversion assumes it is an exported working copy and prints "exported". Gets the with which to log errors. The with which to log errors. Gets the name of the executable file to run. The name of the executable file to run. Subversion Update command Initializes a new instance of the class. Indicates whether all task paratmeters are valid. true if all task parameters are valid; otherwise, false. Unzip a file to a target directory. Unzip file tasks ]]> Initializes a new instance of the class. When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Gets or sets the name of the zip file. The name of the zip file. Gets or sets the target directory. The target directory. Gets or sets a value indicating whether to overwrite any existing files on extraction. Defaults to true. true to overwrite any existing files on extraction; otherwise, false. Gets the files extracted from the zip. The files extracted from the zip. Generates version information based on various algorithms Get version information from file and increment revision. ]]> Specify Major and Minor version information and generate Build and Revision. ]]> Initializes a new instance of the class. When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Gets or sets the major version number. The major version number. Gets or sets the minor version number. The minor version number. Gets or sets the build version number. The build version number. Gets or sets the revision version number. The revision version number. Gets or sets the file used to initialize and persist the version. The version file. When specified, the task will attempt to load the previous version information from the file. After updating the version, the new value will be saved to the file. If you do not specify a value for this property, the version will be calculated based on the values passed to the , , , and properties. The new version will not be persisted. Gets or sets the method used to generate a number If value is not provided, None is assumed. The number is set according to the following table: MajorTypeDescription NoneThe number is not modified. IncrementIncreases the previous value by 1. Gets or sets the method used to generate a number If value is not provided, None is assumed. The number is set according to the following table: MinorTypeDescription NoneThe number is not modified. IncrementIncreases the previous value by 1. ResetResets the previous value to 0. Gets or sets the method used to generate a number If value is not provided, None is assumed. The number is set according to the following table: BuildTypeDescription NoneThe number is not modified. AutomaticThe number of days since . IncrementIncreases the previous value by 1. ResetResets the previous value to 0. Gets or sets the method used to generate a number If value is not provided, None is assumed. The number is set according to the following table: RevisionTypeDescription NoneThe number is not modified. AutomaticA number that starts at 0 at midnight, and constantly increases throughout the day (changing roughly every 1.3 seconds). Guaranteed to be safe for components of the AssemblyVersion attribute. IncrementIncreases the previous value by 1. BuildIncrementIncreases the previous value by 1 when the value of is unchanged. If the value of has changed, is reset to 0. ResetResets the previous value to 0. Gets or sets the starting date used to calculate the number when is Automatic. The starting date for calculation of the build number. This value is only used when the is Automatic. This default value is January 1, 2000. Downloads a resource with the specified URI to a local file. Download the Microsoft.com home page. ]]> Download a page from your local intranet protected by Windows Authentication ]]> Download a page from a password protected website ]]> When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Determines which credentials to pass with the web request Gets or sets the name of the local file that is to receive the data. The name of the file. Gets or sets the URI from which to download data. The file URI. When true, the current user's credentials are used to authenticate against the remote web server This value is ignored if the property is set to a non-empty value. The username used to authenticate against the remote web server The password used to authenticate against the remote web server. A value for must also be provided. The domain of the user being used to authenticate against the remote web server. A value for must also be provided. Reads a value from a XML document using a XPath. Read all targest from a build project. ]]> If the XPath returns multiple nodes, the Value will be a semicolon delimited list of the nodes text. Initializes a new instance of the class. When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Gets or sets the name of the XML file. The name of the XML file. Gets or sets the XPath. The XPath. Gets the value read from file. The value. If the XPath returns multiple nodes, the values will be semicolon delimited. Gets or sets the default namespace. The namespace. Gets or sets the prefix to associate with the namespace being added. The namespace prefix. Updates a XML document using a XPath. Update a XML element. ]]> The XML node being updated must exist before using the XmlUpdate task. Initializes a new instance of the class. When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Gets or sets the name of the XML file. The name of the XML file. Gets or sets the XPath. The XPath. Gets or sets the value to write. The value. Gets or sets a value indicating whether the matched node is deleted. true to delete matched node; otherwise, false. Gets or sets the default namespace. The namespace. Gets or sets the prefix to associate with the namespace being added. The namespace prefix. Create a zip file with the files specified. Create a zip file ]]> Create a zip file using a working directory. ]]> Initializes a new instance of the class. When overridden in a derived class, executes the task. true if the task successfully executed; otherwise, false. Gets or sets the name of the zip file. The name of the zip file. Gets or sets the zip level. Default is 6. The zip level. 0 - store only to 9 - means best compression Gets or sets the files to zip. The files to zip. Gets or sets a value indicating whether this is flatten. true if flatten; otherwise, false. Flattening the zip means that all directories will be removed and the files will be place at the root of the zip file Gets or sets the comment. The comment. Gets or sets the working directory for the zip file. The working directory. The working directory is the base of the zip file. All files will be made relative from the working directory. Gets or sets the password. The password. Gets or sets the encryption algorithm. The encryption algorithm. Possible values are None, PkzipWeak, WinZipAes128 and WinZipAes256