Share via

IIsComputer.Restore (ADSI)

  • Article

You can use the Restore method of the IIsComputer (ADSI) 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 computer name other than the one on which your script is executing. You cannot use LocalHost as the name. You should be careful to plan for this service interruption when restoring the metabase from a backup.

Syntax

IIsComputer.RestoreBackupLocation, 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 it 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 prompt by using Cscript.exe. For more information, see Windows Script Host topics in the Windows documentation.

important Important The metabase backup and restore functionality exists for versioning purposes, not for cross-computer 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 Backing Up and Restoring the IIS Metabase.