Share via

IIsComputer.Backup (ADSI)

  • Article

You can use the Backup method of the IIsComputer (ADSI) object to back up the metabase to a location you specify by providing a backup location name of up to 100 characters in length. Multiple metabase backups can be stored in a backup location.

Syntax

IIsComputer.BackupBackupLocation, BackupVersion, BackupFlags

Parameters

  • BackupLocation
    A string of up to 100 characters that specifies the backup location. The storage mechanism is determined by IIS. If an empty string is specified, the backup will be stored in the default location.

  • BackupVersion
    Specifies the version number to be assigned to the backup. Must be less than or equal to MD_BACKUP_MAX_VERSION. Can be set to one of the following values.

    MD_BACKUP_HIGHEST_VERSION Overwrite the highest existing backup version in the specified backup location.
    MD_BACKUP_NEXT_VERSION Use the next backup version number available in the specified backup location.

  • BackupFlags
    One or more of the following flags.

    MD_BACKUP_FORCE_BACKUP Force the backup even if the SaveData operation specified by MD_BACKUP_SAVE_FIRST fails.
    MD_BACKUP_OVERWRITE Back up even if a backup of the same name and version exists in the specified backup location, overwriting if necessary.
    MD_BACKUP_SAVE_FIRST Perform a SaveData operation before the backup. Default if no flags are specified.
Remarks

IIS determines the backup storage mechanism, so the backup location name you provide does not necessarily translate to a particular directory, file, or database storage mechanism. As implemented in this release, metabase backups are stored as files in the System32\Inetsrv\MetaBack directory.

important Important The metabase backup and restore functionality exists for versioning purposes, not for cross-computer replication. However, you are not necessarily restricted to backing up and restoring the computer from which you initiate the process. For more information about backing up the metabase, see Backing Up and Restoring the IIS Metabase.

Code Example
  <% 
  Dim ComputerObj, iFlags 
  Set ComputerObj = GetObject("IIS://LocalHost") 
  'Backup to next available version number. 
  'Set flags to save the metabase first and 
  'force the backup even if save fails. 
  iFlags = (MD_BACKUP_SAVE_FIRST or MD_BACKUP_FORCE_BACKUP) 
  ComputerObj.Backup "MyBackups", MD_BACKUP_NEXT_VERSION, iFlags 
%>