ºÚÁϺ£½Ç91Èë¿Ú

If you don't want ºÚÁϺ£½Ç91Èë¿Ú to manage a device, remove the following components:

• The device's record from the Admin Portal.
• The agent from the local device.
• Any ºÚÁϺ£½Ç91Èë¿Ú policies on the local device.

If a device is active, all of these components are automatically removed for you. You can find the status of a device in the Admin Portal in the Devices list. Depending on the device status, the agent's components are uninstalled in the following ways:

• If the device has a status of Active, System Reporting when it's deleted from the Admin Portal, the device's record, the ºÚÁϺ£½Ç91Èë¿Ú agent, and policies are automatically removed.
• If the device has a status of Inactive, System Not Reporting when it's deleted from the Admin Portal, only the device's record is removed. To complete the uninstall process, you need to log on to that device and manually remove the agent and policies.

There are two methods to uninstall the agent:

• Using the Admin Portal to Uninstall the Agent
• Using the ºÚÁϺ£½Ç91Èë¿Ú API to Uninstall the Agent

Both of these tools can uninstall all agent components from Mac, Windows, and Linux devices.

Considerations:

• In rare cases, policies aren't removed automatically from Windows devices. If this happens, you can manually remove Windows policies.
• Uninstalling the agent from a device should be used as a last resort if the device is no longer online or communicating with ºÚÁϺ£½Ç91Èë¿Ú.

Using the Admin Portal to Uninstall the Agent

When you remove the agent from a device, all associated policies, files, and directories are also removed. See the complete list in Agent Compatibility, System Requirements, and Impacts.

Considerations:

• If you log on to a device and manually remove the agent first, a record remains in the Admin Portal. You can use these steps to remove only the device record if the device has a status of Inactive, System Not Reporting.

To uninstall the agent from the Admin Portal:

1. Log in to the Admin Portal: https://console.jumpcloud.com.
2. Go to Device Management > Devices.
3. Select the device you want to stop managing. To uninstall all ºÚÁϺ£½Ç91Èë¿Ú components associated with the device, make sure it has a status of Active, System Reporting.
4. Click delete.

The device's record is removed from the Admin Portal.

• If the device has a status of Active, System Reporting when it's deleted from the Admin Portal, the ºÚÁϺ£½Ç91Èë¿Ú agent and policies are also automatically removed.
• If the device has a status of Inactive, System Not Reporting when it's deleted from the Admin Portal, you need to log in to that device and manually remove the agent and policies.
• It can take up to two minutes for the agent and all associated files to be uninstalled from the local device.

Best Practice:

If you're removing the agent from a Windows device, verify the ºÚÁϺ£½Ç91Èë¿Ú policies have been removed by running this command as administrator:

If they remain, you need to manually remove policies from the Windows device.

Using the ºÚÁϺ£½Ç91Èë¿Ú API to Uninstall the Agent

Follow these steps to run a curl command to access the ºÚÁϺ£½Ç91Èë¿Ú API and uninstall the agent. The ºÚÁϺ£½Ç91Èë¿Ú API allows interaction with ºÚÁϺ£½Ç91Èë¿Ú resources such as commands, devices, and users.

Considerations:

• Deleting a device through the ºÚÁϺ£½Ç91Èë¿Ú API can take up to a minute to complete.
• When you remove the agent from a device, all associated policies, files, and directories are also removed. See the complete list in the Agent Compatibility, System Requirements, and Impacts article.
• If you log on to a device and manually remove the agent first, a record remains in the Admin Portal. You can use these steps to remove only the system record if the system has a status of Inactive, System Not Reporting.

To uninstall the agent from the Admin Portal:

1. Review the API documentation to determine, based on your type of integration, which version of the ºÚÁϺ£½Ç91Èë¿Ú API to use.
2. Use the following sample request, replacing SystemID and API_KEY with the values specific to the device you want to stop managing. For definitions of keys, path parameters, and headers, review the API documentation for .

When the command completes successfully, the system's record is removed from the Admin Portal.

• If the device has a status of Active, System Reporting when it's deleted from the Admin Portal, the ºÚÁϺ£½Ç91Èë¿Ú agent and policies are also automatically removed.
• If the device has a status of Inactive, System Not Reporting when it's deleted from the Admin Portal, you need to log on to that system and manually remove the agent and policies.

Best Practice:

• If you're removing the agent from a Windows device, verify the ºÚÁϺ£½Ç91Èë¿Ú policies have been removed by running this command as administrator:

If they remain, you must manually remove policies from the Windows devices.

Manually Remove the Agent from an Inactive Device

You should use these steps only if you want to uninstall the agent from a device that has a status of Inactive, System Not Reporting in the Admin Portal.

Considerations:

• If the device has a status of Active, System Reporting, you should remove all agent components automatically using either the Admin Portal or the ºÚÁϺ£½Ç91Èë¿Ú API.
• If you log on to a device and manually remove the agent first, a record remains in the Admin Portal. You also need to remove the record using either the Admin Portal or the ºÚÁϺ£½Ç91Èë¿Ú API.

To manually remove the agent:
Use the steps in the following table for the OS on your system.

Manually Remove ºÚÁϺ£½Ç91Èë¿Ú Policies from a Windows Device

Follow these steps only after you have uninstalled the agent. If the ºÚÁϺ£½Ç91Èë¿Ú policies weren't automatically removed, you can manually remove them from the Windows device.

In these steps, you'll use the secedit command to clear the system's local Group Policy cache. The secedit command lets you configure the current device's security settings stored in a database.

To remove ºÚÁϺ£½Ç91Èë¿Ú policies from a Windows device:

1. Log on to the device as an administrator.
2. Verify ºÚÁϺ£½Ç91Èë¿Ú policies are removed after an uninstallation by running this command:

3. If group policies are listed, open a PowerShell terminal.
4. At the prompt, type this command:

5. After you run this command, you need to reapply any Windows User and Group policies that are required by your organization.

Device Status After Removing ºÚÁϺ£½Ç91Èë¿Ú

When you remove ºÚÁϺ£½Ç91Èë¿Ú from a device, either by deleting the device in the Admin Portal, or by manually removing the agent from the system, the following will occur:

1. The ºÚÁϺ£½Ç91Èë¿Ú agent will be removed from the system.
2. All users on the system will remain unaffected regardless of whether they were provisioned by ºÚÁϺ£½Ç91Èë¿Ú or were pre-existing and taken over by ºÚÁϺ£½Ç91Èë¿Ú. 
3. All user data and permissions on the system remain as is.
4. Any commands set up to run on that system via ºÚÁϺ£½Ç91Èë¿Ú Commands will no longer run, regardless of how those commands are launched (this means you'll need to move any scheduled commands manually in cron or another scheduling tool).

Your Data In ºÚÁϺ£½Ç91Èë¿Ú

1. Your account will remain intact, should you wish to use ºÚÁϺ£½Ç91Èë¿Ú in the future.
2. Any undeleted devices that go offline without being removed from the ºÚÁϺ£½Ç91Èë¿Ú Admin Portal will remain in the Portal indefinitely, or until ºÚÁϺ£½Ç91Èë¿Ú chooses to delete them.