qdelete client


This command can be used to deconfigure and delete a client, along with its agents.


You can mass-delete clients with or without their associated MediaAgents using the qdelete client command. You can include this command (along with the qdelete mediaagent command, if desired) in a script. Mass deletion of these items is useful if you want to remove them after a split of a CommCell. To mass-delete items where the CommCell is not split, be sure to run the script from the install location of the CommServe.

By default, the qdelete client command asks for confirmation before deleting the client. You can skip the confirmation prompt with the -y option.

Upon successful completion, qdelete client displays the message "Deleted the client successfully" on the command prompt. In case of an error, an error code and description are displayed as: "client: Error errorcode: errordescription"


qdelete client [-cs <commserve_host_name>] -c <client> [-deconfigure] [-y] [-tf <tokenfile>] [-tk <token>] [-af <clientfile>] [-h]



CommServe host name


Client computer name


Deconfigures a client without deleting it


Delete without confirmation


Reads token from a file


Token string


Reads client name from a file


Displays help


Possible exit status values are:

0 - Successful completion.

1 - CLI usage failures, due to the use of an unsupported option or missing argument.

2 - Any other failure.


  • Delete a client with name client1.

    qdelete client -c client1
     This command deconfigures and deletes a client, do you want to continue (y/n)? [n]
  • Deconfigure, but do not delete, a client with name client1

    qdelete client -c client1 -deconfigure -y
  • Delete a set of clients specified in an argument file.

    qdelete client -af "E:\clients.txt"

    In this example, clients.txt is a text file containing a list of client names. Ensure that the file is in the following format: