Moving Devices From One Organization to Another

Sometimes you must move a deviceClosed A subset of Assets, a general term denoting anything that runs the Automox Agent and is registered with the system. from one organizationClosed A subset of an account. An Automox customer account can be tied to multiple organizations, and users can be invited to, and access multiple organizations. An organization contains users, devices, and policies. (org) to another within the console. This process involves two steps, both of which are performed directly on the target device.

Note: Do not attempt this operation as a WorkletClosed Represents an automation script that can execute on a set of devices, consisting of evaluation and remediation code blocks. Worklets can be OS-specific or targeting a platform-agnostic language..

Prerequisites: You must have the required permissions to perform this action. See Roles and Permissions Management.

Manually moving a device

Manually moving a device to a new organization requires running just one command directly on the target device. The second step is to restart the device.

Update Agent Key

To move a device from one organization to another, you must update the access key the Automox agentClosed Lightweight client application, which is installed on managed devices. is using to the target organization. This can be done with the help of the --setkey option. This will deregister the device from the previous organization and set the agent key for the new organization.

  • You must pass a string to the --setkey argument, even if it is an invalid key.
  • The access key passed cannot be the last one used.

macOS

Copy
sudo /usr/local/bin/amagent --setkey <NEW_ORG_ACCESS_KEY>

Windows

Copy
C:\Program Files (x86)\Automox\amagent.exe --setkey <NEW_ORG_ACCESS_KEY>

Linux

Copy
sudo /opt/amagent/amagent --setkey <NEW_ORG_ACCESS_KEY>

Restart the Automox Agent

After setting the new organization access key, you must restart the Automox Agent service on the device using the following commands:

macOS

Copy
sudo launchctl bootout system/com.automox.agent
sudo launchctl bootstrap system /Library/LaunchDaemons/com.automox.agent.plist

Windows

Copy
net stop amagent
net start amagent

Linux

Copy
sudo service amagent restart

Related Topics