Dell Command | Update Version 3.1 User's Guide
Command line interface reference
The following table lists information about the CLI options available in Dell Command | Update:
The CLI syntax is as follows:
/<command> -option1=value1 -option2=value2 -option3=value3...
NOTE: There should not be any space after the forward slash when you are providing the command.
| CLI options | Description | Syntax | Supported Options |
|---|---|---|---|
| /help | Displays usage information.
NOTE: Any other command specified with this command is ignored.
|
dcu-cli.exe /help | Not Applicable |
| /version | Displays the version.
NOTE: Any other command specified with this command is ignored.
|
dcu-cli.exe /version | Not Applicable |
| /configure | Allows configuration of Dell Command | Update based on settings provided in the supported options.
NOTE: Options passed here are persistent, available through the life of the application on the system.
|
dcu-cli.exe /configure -<option>=<value>
Examples: dcu-cli.exe /configure -userConsent=disable |
-importSettings -exportSettings -lockSettings -advancedDriverRestore -driverLibraryLocation -catalogLocation -downloadLocation -updateSeverity -updateType -updateDeviceCategory -userConsent -biosPassword -customProxy -proxyAuthentication -proxyHost -proxyPort -proxyUserName -proxyPassword -scheduleWeekly -scheduleMonthly -scheduleManual -scheduleAuto -scheduleAction -scheduledReboot -silent -outputLog -restoreDefaults -autoSuspendBitLocker Mutually exclusive options These options cannot be used with the specific commands listed below: -importSettings, - exportSettings, -lockSettings. NOTE: This option cannot be used with any other options except -outputLog and -silent
-scheduleAuto, -scheduleManual, -scheduleMonthly, -scheduleWeekly |
| /scan | Performs a system scan to determine the updates for the current system configuration.
NOTE: Options passed here are for one time use only, for that current run.
|
dcu-cli.exe /scan -<option>=<value>
Ex: dcu-cli.exe /scan dcu-cli.exe /scan dcu-cli.exe /scan -updateType=bios,firmware |
-silent -outputLog -updateSeverity -updateType -updateDeviceCategory -catalogLocation -report |
| /applyUpdates | Applies all updates for the current system configuration.
NOTE: Options passed here are for one time use only, for that current run.
|
dcu-cli.exe / applyUpdates -<option>=<value>
Ex: dcu-cli.exe /applyUpdates dcu-cli.exe /applyUpdates -silent dcu-cli.exe /applyUpdates -updateType=bios,firmware |
-silent -outputLog -updateSeverity -updateType -updateDeviceCategory -catalogLocation -reboot -encryptedPassword -encryptedPasswordFile -encryptionKey -autoSuspendBitLocker Mandatory options: These options are required to be provided with the specific commands listed below: -encryptedPassword and -encryptionKey -encryptedPasswordFile and - encryptionKey |
| /driverInstall | Installs all base drivers for the current system configuration on a freshly installed operating system.
NOTE: Options passed here are for one time use only, for the current run.
|
dcu-cli.exe / driverInstall -<option>=<value>
Ex: dcu-cli.exe / driverInstall dcu-cli.exe / driverInstall -silent |
-driverLibraryLocation -silent -outputLog -reboot |
| /generateEncryptedPassword | Generates an encrypted BIOS password | dcu-cli.exe /generateEncryptedPassword
-encryptionKey=<in-line value> dcu-cli.exe /generateEncryptedPassword -password <in-line value> -outputPath=< folder path > |
-password -outputPath -encryptionKey Mandatory options: These options are required to be provided with the specific commands listed below: -password and -encryptionKey |
| CLI options | Description | Syntax | Expected values |
|---|---|---|---|
| -advancedDriverRestore | Allows the user to enable or disable the Advanced Driver Restore feature in the UI. | dcu-cli.exe /configure -advancedDriverRestore=disable | <enable|disable> |
| -autoSuspendBitLocker | Allows the user to enable or disable the automatic suspension of BitLocker, when applying BIOS updates.. | dcu-cli.exe /configure - autoSuspendBitLocker=disable | <enable|disable> |
| -biosPassword | Allows the user to provide the unencrypted BIOS password. The password will be cleared if a password is not provided or "" is supplied. NOTE: The value needs to be enclosed in double quotes. | dcu-cli.exe /configure -biosPassword="Test1234" | <password|""> |
| -catalogLocation | Allows the user to set the repository/catalog file location. If used with /applyUpdates, only one path may be specified. | dcu-cli.exe /configure -catalogLocation=C:\catalog.xml | One or more catalog file paths. |
| -customProxy | Allows the user to enable or disable the use of custom proxy.
NOTE: Setting this option to enable will cause validation of all custom proxy settings.
|
dcu-cli.exe /configure -customProxy=enable | <enable|disable> |
| -downloadLocation | Allows the user to specify the location to override the default application download path. | dcu-cli.exe /configure -downloadLocation=C:\Temp\AppDownload | A folder path |
| -driverLibraryLocation | Allows the user to set the system driver catalog location. If this option is not specified, the driver library shall be downloaded from Dell.com
NOTE: Requires functional networking components
|
dcu-cli.exe /configure -driverLibraryLocation=C:\Temp\DriverLibrary.cab | A file path with .cab extension |
| -encryptionKey | Allows the user to specify the encryption key used to encrypt the password.
NOTE: The key provided must be at least six nonwhitespace characters and include an uppercase letter, a lowercase letter, and a digit. Also, this value needs to be enclosed in double quotes.
|
dcu-cli /applyUpdates -encryptedPassword="myEncryptedPassword" -encryptionKey="myEncryptionKey"
dcu-cli /generateEncryptedPassword -encryptionKey="myEncryptionKey" -password="myPassword" -outputPath=C:\Temp |
<encryption key> |
| -encryptedPassword | Allows the user to pass the encrypted password in-line along with the encryption key that was used to generate it.
NOTE: -encryptionKey is required to be specified along with this option. Also, this value needs to be enclosed in double quotes.
|
dcu-cli /applyUpdates -encryptedPassword="myEncryptedPassword" -encryptionKey="myEncryptionKey" | <encrypted password> |
| -encryptedPasswordFile | Allows the user to pass the encrypted password via file.
NOTE: -encryptionKey is required to be specified along with this option.
|
dcu-cli /configure -encryptedPasswordFile=C:\Temp\EncryptedPasswordFile.txt -encryptionKey="myEncryptionKey" | A file path with extension .txt |
| -exportSettings | Allows the user to export application settings to the specified folder path.
NOTE: This option cannot be used with any other options except -outputLog and -silent.
|
dcu-cli.exe /configure -exportSettings=C:\Temp | A folder path |
| -importSettings | Allows the user to import application settings file.
NOTE: This option cannot be used with any other options except
-outputLog and
-silent.
|
dcu-cli.exe /configure -importSettings=C:\Temp\Settings.xml | An .xml file path |
| -lockSettings | Allows the user to lock all the settings in the UI.
NOTE: This option cannot be used with any other options except
-outputLog and
-silent.
|
dcu-cli.exe /configure -lockSettings=enable | <enable|disable> |
| -outputLog | Allows the user to log the status and progress information of a command execution in a given log path. | dcu-cli.exe /scan -outputLog=C:\Temp\\scanOutput.log | A file path, with .log extension |
| -outputPath | Allows the user to specify the folder path to which encrypted password file is saved. | dcu-cli.exe /generateEncryptedPassword -encryptionKey="myEncryptionKey" -password="myPassword" -outputPath=C:\Temp | A folder path |
| -password | Allows the user to specify the password to be encrypted.
NOTE: encryptionKey is required to be specified along with this option. Also, this value needs to be enclosed in double quotes.
|
dcu-cli.exe /generateEncryptedPassword -encryptionKey="myEncryptionKey" -password="myPassword" | password |
| -proxyAuthentication | Allows the user to enable or disable the use of proxy authentication.
NOTE: Changing this option will cause validation of all custom proxy settings
|
dcu-cli.exe /configure - proxyAuthentication=enable | <enable|disable> |
| -proxyHost | Allows the user to specify the proxy host. Giving an empty string as the value to this option clears proxy host.
NOTE: Changing this option will cause validation of all custom proxy settings.
|
dcu-cli.exe /configure -proxyHost=proxy.com | <FQDN|IP address|"">
Fully Qualified Domain Name (FQDN) |
| -proxyPassword | Allows the user to specify the proxy password. Giving an empty string as the value to this option clears proxy password.
NOTE: Changing this option will cause validation of all custom proxy settings. The value needs to be enclosed in double quotes
|
dcu-cli.exe /configure -proxyPassword="my password" | <password|""> |
| -proxyPort | Allows the user to specify the proxy port. Giving an empty string as the value to this option clears proxy port.
NOTE: Changing this option will cause validation of all custom proxy settings.
|
dcu-cli.exe /configure -proxyPort=8080 | <port number|""> |
| -proxyUserName | Allows the user to specify the proxy username. Giving an empty string as the value to this option clears proxy username.
NOTE: Changing this option will cause validation of all custom proxy settings.
|
dcu-cli.exe /configure -proxyUserName="john doe" | <user name|""> |
| -reboot | Reboot the system automatically (if required). | dcu-cli.exe /applyUpdates -reboot=enable | <enable|disable> |
| -report | Allows the user to create an XML report of the applicable updates. | dcu-cli.exe /scan -report=C:\Temp\UpdatesReport.xml | An .xml file path |
| -restoreDefaults | Allows the user to restore default settings. | dcu-cli.exe /configure - restoreDefaults | None |
| -scheduleAction | Allows the user to specify the action to perform when updates are found. | dcu-cli.exe /configure - scheduleAction=NotifyAvailableUpdates | <NotifyAvailableUpdates | DownloadAndNotify | DownloadInstallAndNotify> |
| -scheduleAuto | Allows the user to enable the default automatic update schedule.
NOTE: Automatic updates executes every 3 days. Also, this option cannot be used with
-scheduleManual -scheduleWeekly -scheduleMonthly |
dcu-cli.exe /configure - scheduleAuto | None |
| -scheduleManual | Allows the user to disable the automatic schedule and enable only manual updates.
NOTE: This option cannot be used with
-scheduleAuto -scheduleWeekly -scheduleMonthly |
dcu-cli.exe /configure - scheduleManual | None |
| -scheduleMonthly | Allows the user to specify the day of the month and time on which to schedule an update. If the scheduled day is greater than the last day of the month, the update will be performed on the last day of that month.
NOTE: This option cannot be used with
-scheduleManual -scheduleAuto -scheduleWeekly |
dcu-cli.exe /configure - scheduleMonthly=28,00:45 | Date of month[1–31],time[00:00(24 hr format, 15 minutes increment)] |
| -scheduleReboot | Allows the user to schedule a reboot time, in minutes, after updates are applied. | dcu-cli.exe /configure - scheduleReboot=5 | <0|5|15|60> (Note:0=Never reboot) |
| -scheduleWeekly | Allows the user to specify the day of the week and time on which to schedule an update.
NOTE: This option cannot be used with
-scheduleManual -scheduleAuto -scheduleMonthly |
dcu-cli.exe /configure - scheduleWeekly=Mon,23:45 | day[< Sun | Mon | Tue | Wed | Thu | Fri | Sat >],time[00:00(24 hr format, 15 minutes increment)] |
| -silent | Allows the user to hide status and progress information on the console. | dcu-cli.exe /scan -silent | None |
| -updateDeviceCategory | Allows the user to filter updates based on device type. | dcu-cli.exe /configure -updateDeviceCategory=network,storage | [audio, video, network, storage, input, chipset, and others] |
| -updateSeverity | Allows the user to filter updates based on severity. | dcu-cli.exe /configure -updateSeverity=recommended,optional | [critical, recommended, and optional] |
| -updateType | Allows the user to filter updates based on update type | dcu-cli.exe /configure -updatetype=bios | [bios, firmware, driver, apps, and others] |
| -userConsent | Allows the user to opt-in or out to send information to Dell regarding the update experience. | dcu-cli.exe /configure -userConsent=disable | <enable|disable> |
If BitLocker is enabled, the following applies:
-
When -autoSuspendBitLocker is set to enable, and a BIOS update is available, then the BIOS update is installed, and BitLocker is suspended during the duration of installation process. After the BIOS and other updates are installed, the system automatically reboots to complete the BIOS update, and BitLocker is re-enabled. The following warning message is displayed on the console before applying the updates
Warning: Because the BIOS update is selected, and BitLocker is enabled on this system, BitLocker will be suspended temporarily during the installation time to effectively apply the BIOS update. After the BIOS and other updates are applied, the system automatically reboots to complete the BIOS update, and BitLocker is re-enabled.
-
When -autoSuspendBitLocker is set to disable, the CLI removes the BIOS updates from the applicable updates and installs the rest of the updates. The following warning message is displayed on the console
Warning: One or more available updates will be skipped, as installing these updates may cause the system to become locked by BitLocker. To avoid this situation, enable BitLocker suspension and run again to install these updates.
Please provide ratings (1-5 stars).
Please provide ratings (1-5 stars).
Please provide ratings (1-5 stars).
Please select whether the article was helpful or not.
Comments cannot contain these special characters: <>()\