Skip to main content

Who is this article for?
Find your product plan in the Code42 console on the Account menu.

Incydr Professional, Enterprise, and Gov F2
Incydr Basic, Advanced, and Gov F1
Other product plans

Incydr Professional and Enterprise, yes.

Incydr Basic and Advanced, yes.

CrashPlan Cloud, yes.

Other product plans, yes.

CrashPlan for Small Business, no.

This article applies to Code42 cloud environments.

Other available versions:


Code42 Support

Code42 console command-line interface reference


You can interact with your Code42 environment through a command-line interface (CLI) as well as the regular graphical interface of the Code42 console. This article describes the CLI commands available and their uses.

To access the command-line interface, press Ctrl + Shift + X.

Before you begin

If you have any questions about command usage or best practices, contact our Customer Champions for support.

Use caution when you modify your Code42 environment
Some of these commands have the potential to interfere with backups, disconnect devices, or potentially destroy data. Some commands cannot be undone.

Because of this destructive potential, take care when modifying your Code42 environment on the command line.

Command parameters in this article

This article uses several standard conventions to describe command parameters and options.

Arrow brackets

Text in arrow brackets should be replaced with text specific to your environment. Do not include the arrow brackets in your command.

Example instruction: command <exampleEmail>

Correct commands:

Square brackets

Text in square brackets indicates an optional command. Do not include the square brackets in your command.

Example instruction: command [option]

Correct commands:
command option

Curly braces

Text in curly braces separated by pipes indicates mutually exclusive arguments. Do not include the curly braces in your command.

Example instruction: command {abc | def | ghi}

Incorrect command:
command abc def

Correct commands:
command abc
command ghi

Access the command-line interface

To interact with your Code42 environment through the command-line interface, open the CLI from the Code42 console.

  1. Sign in to the Code42 console.
  2. Press Ctrl + Shift + X.
    The command-line interface appears in the Code42 console.
  3. Enter commands at the top of the command-line interface.
  4. Review the output below.



Incydr Professional and Enterprise only

Sends a command to a specific user device. If the target device is offline, the command is sent the next time the device is online.

The example below is specific to the loglevel command.

agent.command create <guid> loglevel <modulename> <level>

Argument Function
<guid> GUID of the client device.

Sends the log level change command to the device.


(Optional) Specifies to which agent module the log level change applies. If no module name is provided, the change applies globally to all logs.


In most cases, the modulename argument can be omitted. However, a Code42 Customer Champion may instruct you to apply changes to a specific module to reduce unwanted log noise.


Specifies the logging level. In order of details logged, the levels are: trace, debug, infowarning, error, critical

  • Trace provides the most logging detail. 
  • Critical provides the least logging detail.
  • The default level is info.

agent.command create 123456789012345678 loglevel debug


Incydr Basic and Advanced, CrashPlan Cloud, and other plans only

Updates the :user directory for a specific device to correct errors in a user's home path so that files can back up as expected. This command adds the specified directory to the existing :user path for that device to preserve backed up files. Because the command is additive, you can update a device's :user directory even if the backup file selection is locked.

Requires Code42 app v8.6.0 or later
The agent.userhome command requires the device to be online and Code42 app v8.6.0 (or later) on the endpoint for which you want to update the :user directory.

agent.userhome <guid> <userHomePath>

Argument Function
<guid> GUID of the client device.

Absolute path to the user's home directory on that client device. For example:

  • Windows: C:\Users\johndoe
  • Mac: /Users/johndoe
  • Linux: /home/johndoe


  • This command accepts the directory path you enter. There is no validation to confirm that the directory exists on the endpoint.
  • The command fails and Code42 is unable to update the user's home directory when either of the following are true:
    • You use a deployment policy that both sets and locks the user's home directory.
    • The device's file selection is locked.

Use one of these methods to confirm the :user directory on a specific endpoint:

Subsequent file selection changes reset the :user directory
If you update the file selection on the Backup tab of the Device Backup Default Settings after using this command, the :user directory resets to use only the most recent path set.


Incydr Basic and Advanced, CrashPlan Cloud, and other plans only

Send a command, enclosed in quotation marks, to a client. If the client is not currently online, the command fails and no action will be taken.
clientCommand "<command>" <guid>

cc "<command>" <guid>

Argument Function
<command> Command to pass to the client device.
<guid> GUID of the client device.

clientCommand "java option Xmx 1024m" 123456789012345678


Return user ID, name, address, and other information fields for a specific computer.
computer <guid> [deauth]

Argument Function
<guid> GUID of the client device.
[deauth] (Optional) Returns deauthorization information. Only applicable for GUIDs that have been deauthorized.


Incydr Basic and Advanced, CrashPlan Cloud, and other plans only

Disconnect all devices, or a single device if given a GUID, from all cloud (non-provider) destinations. Does not deauthorize the device.
disconnect [<guid>]

Argument Function
[<guid>] (Optional) GUID of the device you want to disconnect from all cloud destinations. If guid is not specified, disconnect disconnects all devices from all cloud destinations.


Incydr Basic and Advanced, CrashPlan Cloud, and other plans only

Reset a given user's login attempt status.

login.monitor.reset <username>

Argument Function
<username> Specify the user whose login attempt status you want to reset.

Incydr Basic and Advanced, CrashPlan Cloud, and other plans only

Send one sample email or a set of sample emails.

Usage: <username> {customizable|code42|<templateKeyword>|<templatePath>} 

For example: customizable code42 backup_alerts /emails/templated/admin_initiated_password_reset.eml

Argument Function
<username> Recipient of the sample email, given by a Code42 username.
customizable Send emails that can be customized. (Sends emails that can be customized for Code42 cloud environments as well as on-premises environments.)

Send all Code42 emails.


Send a test email for emails that can be customized in Code42 cloud environments. Valid values are:

  • backup_alerts
  • backup_reports
  • password_reset_user
  • password_reset_admin 

Send an email defined by a template in the Code42 cloud environment.

Following are some examples:

  • /emails/templated/admin_initiated_password_reset.eml

  • /emails/templated/backup_alert_user.eml

  • /emails/templated/backup_alert_admin.eml

  • /emails/templated/backup_report_admin.eml

  • /emails/templated/backup_report_user.eml

  • /emails/templated/directory_sync_summary.eml

  • /emails/templated/system_alert_admin.eml

  • /emails/templated/user_initiated_password_reset.eml


  • Was this article helpful?