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
Last Updated: 2003/07/28
Direct corrections or suggestions to:
Rick Lively