Home > Commands A-M > Commands I

IISBACK


Description | Syntax | Parameters | Switches | Related | Notes | Examples | Errorlevels | Availability

Creates and manages backup copies of the Internet Information Services (IIS) configuration (metabase and schema) of a remote or local computer. Administrators can use this script tool to create a backup copy of their IIS configuration, to restore an IIS configuration from a backup copy, and to list and delete backup copies.


Syntax

IISBACK[.VBS] [/backup | /delete | /list /restore] /?

IISBACK[.VBS] /backup [/b backup_name] [/e encryption_password] [/overwrite] [/s computer [/u [Domain\]User [/p password]]] [/v value]

IISBACK[.VBS] /delete /b backup_name [/s computer [/u [Domain\]User [/p password]]] /v value

IISBACK[.VBS] /list [/s computer [/u [Domain\]User [/p password]]]

IISBACK[.VBS] /restore /b backup_name [/e encryption_password] [/s computer [/u [Domain\]User [/p password]]] [/v value]


Parameters

none.


Switches
/? (NT2003)
Display help.
/b backup_name (NT2003)
Specifies the name of the backup copy. SampleBackup is the default.
/backup (NT2003)
Creates a backup copy of the Internet Information Services (IIS) configuration (metabase and schema) of a remote or local computer.
/delete (NT2003)
Deletes a backup copy of the Internet Information Services (IIS) configuration (metabase and schema) from a remote or local computer.
/e encryption_password (NT2003)
Encrypts the backup copy with the specified password. You can use any string as the password.
Creates a secure backup by encrypting the session key and secure properties with the specified password. Administrators must provide the password to use the backup in a /restore operation.
If you omit this parameter or omit the password argument, then the backup is encrypted with a blank password. As a result, only the secure properties are encrypted and any Administrator can use the backup copy to restore the metabase.
/list (NT2003)
Displays backup copies of the Internet Information Services (IIS) configuration (metabase and schema) stored on a remote or local computer.
Only lists the backup copies stored in the default location, %SYSTEMROOT%\System32\inetsrv\MetaBack. Backup copy files moved to a different directory will not appear in the list.
/overwrite (NT2003)
Replace an existing backup copy with the newly created backup copy. If omitted, attempts to create a backup copy with the same name and version number as an existing backup copy fail.
/p password (NT2003)
Specifies the password of the user account that is specified in /u. If omitted, you will be prompted.
/restore (NT2003)
Specifies the name or IP address of a remote computer (do not use backslashes). The default is the local computer.
/s computer (NT2003)
Replaces the current Internet Information Services (IIS) configuration (metabase and schema) settings on a local or remote computer with the configuration settings stored in a backup copy.
Restore is a complex operation that can take several minutes to complete. A brief delay is normal.
During the restore operation, Web pages, FTP sites, and SMTP and NNTP services are temporarily stopped. They are automatically restarted when the operation completes.
/u [Domain\]User (NT2003)
Runs the command with the account permissions of the user specified by User or Domain\User. The default is the permissions of the current logged on user on the computer issuing the command.
/v value (NT2003)
Specifies the version number of the backup copy:
      Value            Description /backup
      Integer          Version number of the backup copy
      NEXT_VERSION     Highest version number plus 1 (default)
      HIGHEST_VERSION  Reuses the highest version number
                       Because this option replaces a backup copy,
                       the /overwrite switch is required when
                       using this value (valid only when previous
                       versions of the file are stored on the
                       computer. Otherwise, returns an error
                       explaining that it cannot find a file to
                       replace)
      Value            Description /delete /restore
      Integer          Version number of the backup copy
      HIGHEST_VERSION  Highest version number backup copy (default)
      Value            Description

Related

none.


Notes

To perform this procedure, you must be a member of the Administrators group on the local computer, or you must have been delegated the appropriate authority. If the computer is joined to a domain, members of the Domain Admins group might be able to perform this procedure. As a security best practice, consider using "Run as" to perform this procedure.

Backup copies store only the metabase configuration and schema. They do not store and cannot be used to restore Web site content.

Each backup operation creates two files, an .MDX file to store the metabase and an .SCX file to store the schema, where X is the version number of the backup copy. Stores backup copy files in the %SYSTEMROOT%\System32\inetsrv\MetaBack directory.

Displays the date and time in Coordinated Universal Time (UTC), not in the local time for the IIS server.


Examples

none.


Errorlevels

none.


Availability
External
DOS
none
Windows
none
Windows NT
NT2003