This page refers to an older version of the product.View the current version of the online Help.
CCA Command Tool
The CCA Command tool, CcaCmd.exe, allows an administrator to configure the Deployment Agent from an endpoint giving an advanced level of control over the Deployment Agent and its behavior.
Administrators may use it to prepare a master image for provisioning. The commands can be run individually or in a batch file as part of an existing provisioning script.
In this section:
Before Using the CCA Command Tool
Before you can use CcaCmd.exe the following conditions must be met:
- ClientCommunicationsAgent.msi installed on the endpoint.
-
The following permissions must be enabled in Home > [Server] > Deployment Groups > [Deployment Group] > Settings > Deployment Agent Permissions:
- Allow self-registration - maps to CCA Command tool switch /URL
- Allow unregistration - maps to CCA Command tool switch /UNREGISTER and /IMAGEPREP
- Allow update initiation - maps to CCA Command tool switch /UPDATEAGENTS and /UPDATECONFIGS
- You must be a member of the local administrators group and running with an elevated token.
Using the CCA Command Tool
The CcaCmd.exe commands are as follows:
Command |
Description |
---|---|
/url |
Changes the url used to communicate with the Management Server. You can optionally include a Deployment Group with which to self register. This requires Allow self-registration to be enabled in the Deployment Group Settings. |
/imageprep |
Prepares this computer
for provisioning, the computer will be registered on the next
poll. This command can be combined with the /unregister command.
When running /imageprep, the Deployment Agent will automatically Check for and download new Configurations at Startup regardless of the Deployment Group Settings. |
/unregister |
Unregisters the
Deployment Agent from the Management Server and stops the
Deployment Agent service. Does not uninstall any User Workspace Manager
agents or configurations. This requires Allow
unregistration to be enabled in the Deployment Group Settings.
Once a computer has been unregistered the Deployment Agent Service must be restarted for the computer to re-register. |
/updateagents |
Initiates install of agents assigned to the Deployment Group, overriding the Installation Schedule. This requires Allow update initiation to be enabled in the Deployment Group Settings. A system restart is triggered if requested by the installer. The system restart can be suppressed by supplying the /suppressreboot option. The updating of agents is asynchronous. Use /isupdating to check if the Deployment Agent is still applying updates. |
/updateconfigs |
Initiates install of configurations assigned to the Deployment Group, overriding the Installation Schedule. This requires Allow update initiation to be enabled in the Deployment Group Settings. The updating of configurations is asynchronous. Use /isupdating to check if the Deployment Agent is still applying updates. |
/isupdating |
Determines whether a previous call to /updateagents or /updateconfigs is still processing updates. |