Chat now with support

Get Live Help
Complete Registration

Sign In

Request Pricing

Contact Sales

NetVault 11.4.5 - CLI Reference Guide

Table of Contents

About Quest® NetVault® Backup About this document Target audience Recommended additional reading

Getting started

About NetVault Backup Command Line Interface Working with command-line utilities

Command syntax CLI help Command exit status Environment variables

Starting or stopping the NetVault Backup Service

Using the command-line utilities

Client-specific utilities

nvclient nvclientaccess nvclientadd nvclientlist nvclientname nvclientremove

Device-specific utilities Media-specific utilities

nvblankmedia nvbulkblankmedia nvexportmedia nvlabelmedia nvlistblankmedia nvlistmedia nvloadmedia nvmakemedia nvmediadetails nvremovemedia nvreusemedia nvscanmedia nvsyncronizesilomedia nvupdateserialnumber

Job-specific utilities

nvexpiresaveset nvjobabort nvjobcreate nvjobdelete nvjobhold nvjoblist nvjobmodify nvjobresume nvjobstart nvpolicy nvrestore nvsetcreate

Backup Selection Set Restore Selection Set Backup Options Set Schedule Set Backup Target Set Backup Advanced Options Set Restore Advanced Options Set

nvsetdelete nvsetexport nvsetimport nvsetmodify nvtrigger

Log-specific utilities

nvlogdump nvlogpurge nvreadlog

Other utilities

bonedate getmachineid installplugin licenseinstall nvlicenseinfo nvmeddbcheck nvpassword nvpluginaccess nvpgdbpasswd nvreport nvscheddbcheck nvsendmail nvsendopmsg nvtrace

Using the nvreport utility

About nvreport utility Report classes Plain text template files Formatting the reports

Using the format option Using the sort option Using the include option Using the title option

Creating external report files HTML template files

nvexportmedia

Exports a piece of media from a tape library to its entry/exit port (EEPort).

nvexportmedia -servername <Server Name> -barcode <Barcode> |
-medialabel <Media Label> | -slotspec <Library Name::Slot Number> [-wait]

Table 35. nvexportmedia
Option	Description
-servername	Specifies the name of the NetVault Backup Server that administers the job. This option is required when a remote server administers the job. It can be omitted when a local server administers the job. The server name is case‑sensitive.
-barcode	Specifies the barcode of the target media item.
-medialabel	Specifies the label of the target media item. Use this option only when searching by media label. If a media label contains spaces, enclose it within quotation marks (“”). Example: “Full DB Backups”
-slotspec	Specifies the name of the library and slot number where the target media item resides. These two values must be separated using a double colon delimiter (“::”). Use this option only when searching by library slot.
-wait	Waits until the task has completed.

nvlabelmedia

Use this utility to label new media items or re-label existing media items.

nvlabelmedia [-servername <Server Name>] -barcode <Barcode> |
-medialabel <Media Label> | -slotspec <Library Name::Slot Number>
-newlabelname <New Media Label> [-newgroupname <New Media Group Name>]
[-newoffsitelocation <New Offsite Location Name>] [-wait]

Table 36. nvlabelmedia
Option	Description
-servername	Specifies the name of the NetVault Backup Server that administers the job. This option is required when a remote server administers the job. It can be omitted when a local server administers the job. The server name is case‑sensitive.
-barcode	Specifies the barcode of the target media item.
-medialabel	Specifies the label of the target media item. Use this option only when searching by media label. If a media label contains spaces, enclose it within quotation marks (“”). Example: “Full DB Backups”
-slotspec	Specifies the name of the library and slot number where the target media item resides. These two values must be separated using a double colon delimiter (“::”). Use this option only when searching by library slot.
-newlabelname	Specifies the new label for the selected piece of media. If the new media label contains spaces, use underscores (“_”) in their place. Example: “new_label_1”
-newgroupname	Specifies the new media group for the selected media piece of media. If the media group label contains spaces, use underscores (“_”) in their place. Example: “new_group_1”
-newoffsitelocation	Specifies the new offsite location for the selected piece of media.
-wait	Waits until the task has completed.

•

To re-label media items that contain existing backups, you first blank it using the nvblankmedia or mark it for reuse using the nvreusemedia command.

•

The offsite location of the media can be changed without blanking the media or marking it for re-use. This property is set or changed using the -newoffsitelocation option.

nvlistblankmedia

Displays slots containing blank media items on the specified library.

nvlistblankmedia -servername <Server Name> -libraryname <Library Name>

Table 37. nvlistblankmedia
Option	Description
-servername	Specifies the name of the NetVault Backup Server that administers the job. This option is required when a remote server administers the job. It can be omitted when a local server administers the job. The server name is case‑sensitive.
-libraryname	Specifies the name of the target library.

nvlistmedia

Lists media items marked with the following tags:

•

•

•

•

•

•

•

Any media group tag

nvlistmedia [-servername <Server Name>] -libraryname <Library Name>
-readonly | -reusable | -unusable | -needsimport | -needsrecovery | -bad -group

Table 38. nvlistmedia
Option	Description
-servername	Specifies the name of the NetVault Backup Server that administers the job. This option is required when a remote server administers the job. It can be omitted when a local server administers the job. The server name is case‑sensitive.
-libraryname	Specifies the name of the target library.
-readonly	Lists read-only media items.
-reusable	Lists media items marked for reuse.
-unusable	Lists media items with the “unusable” tag.
-bad	Lists media items with the “bad” tag.
-needsimport	Lists media items that need to be imported.
-needsrecovery	Lists media items that need recovery.
-group	Lists media items that belong to any media group

Related Documents

NetVault - 11.4.5
Administration Guide
Built-in Plug-ins User Guide
CLI Reference Guide
Installation Guide
Release Notes
Compatibility Guide
Release Notes for GigaOS
Release Notes for Linux Live Client Plug-in
Release Notes for Linux Offline Client Plug-in
Release Notes for NetVault Backup Server

«
1
2
3
4
5
»

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating

© 2025 Quest Software Inc. ALL RIGHTS RESERVED. Terms of Use Privacy Cookie Preference Center