DefensX Docs

ONLINE DOCUMENTATION


Moving Agents Between Deployments and Customers In this document Deployment Change Change via DefensX Backend Change via Registry Customer Change Deployment Change You can move an agent from one deployment to another within the same customer in two ways: Changing the deployment via the DefensX Backend 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. 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.