Web Deploy rootWebConfig32 Provider

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

rootWebConfig32

The rootWebConfig32 provider synchronizes 32–bit root Web.config file information between two computers.

Example

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

The rootWebConfig32 provider returns the 32–bit related contents of the root Web.config file, or synchronizes the 32–bit related contents of the root Web.config file from a source computer to a destination computer. You specify the source and destination values by using the -source and -dest arguments. The source and destination values must be the same and must be at the same level of configuration. On 64–bit versions of Windows, the provider will work, but will return or synchronize only 32–bit related content.

In a dump operation, the configuration contents, including attributes, will be displayed if you specify that 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:rootWebConfig32 -xml

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

msdeploy -verb:sync -source:rootWebConfig32 -dest:rootWebConfig32,computerName=Server1