Web Deploy rootWebConfig64 Provider

Applies To: Windows 7, Windows Server 2003, Windows Server 2003 R2, Windows Server 2008, Windows Server 2008 R2, Windows Vista, Windows XP

rootWebConfig64

The rootWebConfig64 provider synchronizes 64–bit root Web.config file information between two computers.

Example

msdeploy -verb:sync -source:rootWebConfig64 -dest:rootWebConfig64,computername=Server2

The rootWebConfig64 provider returns the 64–bit related root Web.config file contents from a source computer, or synchronizes these contents from a source computer to a destination computer. The source and destination are specified with the -source and -dest arguments. The source and destination values must be the same and must be at the same level of configuration. On 32–bit versions of Windows, the provider will do nothing.

In a dump operation, the configuration contents, including attributes, will be displayed if the -xml operation setting is used; otherwise, only the configuration paths will be returned.

In a sync operation, if a path is on the source but not on the destination, the path will be added to the destination. If the path exists on the destination, all attributes and elements under the path will be updated. If an object on the destination does not exist on the source, the object on the destination will be deleted.

Synchronizing the .NET Framework 4 Machine.config and Root Web.config Files

You may want to synchronize the .NET Framework 4 versions of the Machine.config and root Web.config files, which are located by default in the %windir%\Microsoft.NET\Framework\v4.0.<xxxxx>\Config folder (32-bit) or in the %windir%\Microsoft.NET\Framework64\v4.0.<xxxxx>\Config folder (64-bit).

In order to synchronize these files, you must remove the entries for the .NET Framework 2.0 from the Msdeploy.exe.config and Msdepsvc.exe.config configuration files. The Msdeploy.exe.config and Msdepsvc.exe.config files are located in the %ProgramFiles%\IIS\Microsoft Web Deploy folder.

The Msdeploy.exe.config and Msdepsvc.exe.config files both contain the following entries by default.

<configuration>

   <startup>

      <supportedRuntime version="v2.0.50727" />

      <supportedRuntime version="v4.0" />

   </startup>

</configuration>

Before you synchronize the .NET Framework 4 Machine.config and root Web.config files, remove the entry for .NET Framework 2.0 from each file, as in the following example.

<configuration>

   <startup>

      <supportedRuntime version="v4.0" />

   </startup>

</configuration>

Important

If you later want to synchronize the .NET Framework 2.0 versions of the Machine.config and root Web.config files, you will need to restore the .NET Framework 2.0 entry in the Msdeploy.exe.config and Msdepsvc.exe.config files.

Warning

You cannot synchronize .Net Framework 2.0 and .Net Framework 4 configuration files in the same Web Deploy command.

Example usages

1) Display the contents of the root Web.config file in XML format.

msdeploy -verb:dump -source:rootWebConfig64 -xml

2) Synchronize the root Web.config file between a source and a destination.

msdeploy -verb:sync -source:rootWebConfig64 -dest:rootWebConfig64