Web Deploy machineConfig64 Provider

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

machineConfig64

The machineConfig64 provider synchronizes 64-bit Machine.config file information between two computers.

Example

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

The machineConfig64 provider returns the 64–bit related contents of the Machine.config file from a source computer, or synchronizes the 64–bit related contents of the Machine.config file from a source computer to a destination computer. You specify the source and destination by using the -source and -dest arguments. On 32–bit versions of Windows, the provider will do nothing.

In a sync operation, the source and destination values must be the same, and the Machine.config files must be at the same level of configuration. If a path does not exist on the destination, it will be added to the destination. If the path already exists on the target computer, it will be updated with data from the source. Any child elements and attributes that exist underneath the path will be updated.

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 Machine.config file in XML format.

msdeploy -verb:dump -source:machineConfig64 -xml

2) Synchronize the contents of the Machine.config file to a target computer.

msdeploy -verb:sync -source:machineConfig64 -dest:machineConfig64,computerName=TargetServer