Browse Docs
ONLINE DOCUMENTATION

Moving Agents Between Deployments and Customers

Deployment Change

You can move an agent from one deployment to another within the same customer in two ways:

  1. Changing the deployment via the DefensX Backend

  2. Changing the deployment via the registry

Change via DefensX Backend

Follow these steps in the DefensX Backend:

  • Navigate to Policies and click on the deployment name that includes the target agent.

  • Find the agent you want to move and click on its name (you can also search for the agent by computer name in the "Search Hostname/Logon User" input box).

  • Click on the Change Deployment link.

  • Select the new deployment group and click the Change button.

change deployment1

It will take approximately 2 minutes to complete the deployment change.

Change via Registry

If you have a Remote Monitoring and Management (RMM) solution that allows you to change Windows registry key-value pairs remotely, you can also change the deployment of an agent by updating a specific registry key. This method allows you to quickly move multiple agents to a different deployment group by applying the same RMM script to a group of computers.

To use this method, update the DeploymentKey value under HKLM:\SOFTWARE\DefensX\Agent in the registry. Copy the target deployment’s key from the DefensX Backend and use your RMM solution to update the registry. For example, you can use the following command in a PowerShell window to update the value:

Set-ItemProperty -Path "HKLM:\SOFTWARE\DefensX\Agent" -Name "DeploymentKey" -Value "<value-of-the-deployment-key-in-DefensX-Backend>"

Customer Change

It is also possible to move an agent from one customer to another within your Partner account.

The procedure is the same as changing an agent’s deployment via the registry. Set the DeploymentKey value under HKLM:\SOFTWARE\DefensX\Agent in the registry using a key from your target customer.
Secure Industries, Inc 101 Avenue of The Americas, Floor 9 New York, NY 10013