You can use the eportalstage command with the --config (-c) option to perform the configuration file transforms. The configname (referred in this topic) is the configuration name supplied with the -config option. Configuration file transforms can apply to each of the configuration files described in the Updating the Configuration Files (Optional).

A transform file is a special XML file that specifies how the associated base configuration file is to be updated when the stage operation is performed. Microsoft currently uses this mechanism to update the Web.config file during the publish operation. For more information on the syntax of a transform file, refer to https://msdn.microsoft.com/en-us/library/dd465326(v=vs.140).aspx.

A transform file appears in the same directory as its associated configuration file. The name of the transform file is the same as the associated configuration file, except that the file extension is added in the beginning with .configname.

For example, the following are the names of possible transform files provided to match a configname of the Release:

If an applicable transform file exists which matches the specified configname, then the actions defined in the transform file are applied to the corresponding base configuration file. The output is written to a temporary file location, however, the original base configuration file is not changed.

When the zipped stage file is produced, the base configuration files are replaced with the resulting transformed configuration files.

You can use file transform to perform following tasks:

For example, the following code can be used to replace the "RequireSSL" element in the original.epconfig file with a new element which sets the value to true.

<?xml version="1.0"?>
   <WebServerProperties xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform"> 
     <RequireSSL xdt:Transform="Replace">true</RequireSSL>
   </WebServerProperties>

For more information on using config transformation, visit http://go.microsoft.com/fwlink/?LinkId=125889.