### Restore

You can use the Restore method of the IIsComputer object to restore the metabase from a backup. The restore operation stops all services dependent on IISADMIN, including all servers, until the restore has completed, then restarts all services. Because of this, if you are restoring the metabase by using a script in an ASP page, you must specify a machine name other than the one on which your script is executing. You cannot use LocalHost as the machine name. You should be careful to plan for this service interruption when restoring the metabase from a backup.

###### Syntax

IIsComputer.Restore BackupLocation, BackupVersion, BackupFlags

###### Parameters

BackupLocation
  A string of up to 100 characters that specifies the backup location. If an empty string is specified, the backup will be retrieved from the default location.
BackupVersion
  Specifies the version number of the backup to be restored from the backup location, or can be the following constant.

  MD_BACKUP_HIGHEST_VERSION | Restore from the highest existing backup version in the specified backup location.

BackupFlags
  Reserved. Must be zero.

###### Code Example

    <%
      Dim ComputerObj, ComputerName
      'Restore metabase on a different computer.
      ComputerName = "MyOtherComputer"
      'You can use LocalHost if running under Windows Script Host.
      Set ComputerObj = GetObject("IIS://" & ComputerName)
      'Restore the highest number version in MyBackups.
      ComputerObj.Restore "MyBackups", MD_BACKUP_HIGHEST_VERSION, 0
    %>

###### Remarks

You can use the Restore method with LocalHost in scripts running in a command window by using Cscript.exe. For more information, see the Windows Script Host material in the Windows documentation.

Important The metabase backup and restore functionality exists for versioning purposes, not for cross-machine replication. However, you are not necessarily restricted to restoring the computer from which you initiate the process. For more information about restoring from a back up, see "Restoring the Metabase" in the IIS product documentation.

###### See Also

Backup, EnumBackups, DeleteBackup

© 1997-2001 Microsoft Corporation. All rights reserved.