Sometimes it is desirable to move a device from one zone to another in the Automox console. This can be accomplished in two steps that can be performed on the target device.
Note: A "zone" is the new term for what was formerly named "organization". Refer to Global Zone Management.
Note: This operation should not be attempted as a Worklet.
Prerequisites: You have Zone Administrator permissions.
Manual
Manually moving a device to a new zone requires running just one command directly on the target device.
Update Agent Key
To move a device from one zone to another, you must update the access key the Automox agent is using to the target zone. This can be done with the help of the --setkey
option. This will deregister the device from the previous zone and set the agent key for the new zone.
A string needs to be passed to the
--setkey
argument, even if it is an invalid key.The access key passed cannot be the last one used.
macOS
sudo /usr/local/bin/amagent --setkey <NEW_ZONE_ACCESS_KEY>
Windows
C:\Program Files (x86)\Automox\amagent.exe --setkey <NEW_ZONE_ACCESS_KEY>
Linux
sudo /opt/amagent/amagent --setkey <NEW_ZONE_ACCESS_KEY>
Restart the Automox Agent
After setting the new zone access key, you will need to restart the Automox Agent service on the device using the following commands:
macOS
sudo launchctl kickstart -k system/com.automox.agent
Windows
net stop amagent net start amagent
Linux
sudo service amagent restart