Backup

You can use the Backup method of the IIsComputer 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.Backup BackupLocation, BackupVersion, BackupFlags

Parameters

BackupLocation

A string of up to 100 characters that specifies the backup location. The storage mechanism will be 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   The metabase backup and restore functionality exists for versioning purposes, not for cross-machine 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 the Metabase" in the IIS product documentation.

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 
%> 
 

See Also

DeleteBackup, EnumBackups, Restore

© 1997-2001 Microsoft Corporation. All rights reserved.