Veritas NetBackup™ Commands Reference Guide
- Appendix A. NetBackup Commands
W2KOption — run the utility program that modifies normal backup and restore behavior on Windows systems
-backup -display [-server server_name] -system_state value | -kms_activated_server value | -snapshotprovidertype value | -ignore_unresolved_volumes volume[:volume...]
-restore -display [-server server_name] same_hardware value | -mounted_devices value | -sysvol value | -hard_links value | -active_directory value | -system_state value
The directory path to this command is <install_path>\NetBackup\bin\
This command operates only on Windows systems.
- -ad, active_directory value
Controls how the Active Directory is restored. By default, Active Directory are restored in an authoritative manner. If you want to perform an Active Directory restore in a catchup manner, use this utility to change the behavior from authoritative to catchup.
1 - Run an authoritative restore, which replaces all existing Active Directory objects.
4 - Run a non-authoritative (catchup) restore. The restore merges with changes on other controllers in the domain.
- -b, -backup
Lets you modify values for one or more of the backup options. The backup options are system_state, kms_activated_server, snapshotprovidertype, and ignore_unresolved_volumes.
- -d, -display
Displays the program usage and shows how the options operate.
- -hl, -hard_links 0 | 1
Controls how hard links are restored. By default, if the file is not present on the system, NetBackup tries to restore the file after the current restore completes. This action is called a secondary restore. You can change the behavior to shut off the secondary restore.
0 - Do not perform the secondary restore.
1 - Perform the secondary restore.
- -iuv, -ignore_unresolved_volumes volume[:volume...]
Deletes the log files from the folder that the product configures.
- -kas, -kms_activated_server 0 | 1
Specifies if NetBackup treats the computer as a Key Management Service (KMS) activated host during backups.
0 - Do not treat the host as a KMS activated server.
1 - Treat the host as a KMS activated server.
- -md, -mounted_devices 0 | 1
Determines if the mounted devices registry key is restored.
0 - Restore the mounted device configuration.
1 - Do not restore the mounted device configuration.
- -r, -restore options
Lets you modify values for one or more of the restore options. The restore options are - same_hardware, -mounted_devices, -sysvol, -hard_links, -active_directory, and - system_state.
- -sh, -same_hardware 0 | 1
Determines how to restore the registry system hive. A normal restore operation does not restore all the registry items. However, when you restore to the same hardware, you can safely restore all these items.
0 - Assume different hardware. Do not restore all the registry items.
1 - Assume the same hardware. Restore all the registry items.
- -s, -server server_name
Displays or sets the options on a computer other than the local computer. The default is the local computer.
- -spt, -snapshotprovidertype 0 | 1 | 2 | 3
Selects the snapshot provider type.
0 - Automatic provider selection
1 - Use the system provider
2 - Use a software provider
3 - Use a hardware provider
- -ss, -system_state 0
Changes the backup method from the legacy system state method back to the normal VSS system state method. Selecting the legacy system state method is not allowed.
0 - Disallow legacy system state restore.
- -sv, -sysvol 2 | 4
Determines how the Active Directory SYSVOL is restored. By default, NetBackup restores as if the SYSVOL being restored is the primary version. You can change this setting from the primary version to the non-authoritative version.
2 - Non-authoritative version.
4 - Primary version.
Example 1 - Ignore volumes H, K, and I during backup.
W2KOption -backup -ignore_unresolved_volumes H:K:I:
Example 2 - Treat the host as a KMS activated server.
W2KOption -backup -kms_activated_server 1