黑料海角91入口

Help Center Home > Devices > Install or Uninstall the 黑料海角91入口 Agent

Install or Uninstall the 黑料海角91入口 Agent

This article covers the manual ways to install or uninstall the 黑料海角91入口 Agent via the 黑料海角91入口 Admin Portal on various operating systems.

Prerequisites:鈥�

Installing the Agent

Install the 黑料海角91入口 Agent on a MacOS Device

  1. Log in to the .
  2. Go to DEVICE MANAGEMENT > Devices.
  3. Click + to add a device and click the Mac tab.
  4. Select the Install via Mac Agent option.
  5. If you are currently on the target system, click Download Mac Agent. If not, click Copy Download Link to copy the link URL and open the link in a browser on the target system.
  6. Copy the Connect Key.
  7. Run jumpcloud-agent.pkg. 
  8. Follow the installer and enter the Connect Key when prompted.

Install the 黑料海角91入口 Agent on a Windows Device

  1. Log in to the .
  2. Go to DEVICE MANAGEMENT > Devices.
  3. Click + to add a device and click the Windows tab.
  4. Select the Install via MSI Download option.
  5. If you are currently on the target system, click Download Windows Agent. If not, click Copy Download Link to copy the link URL and open the link in a browser on the target system. 
  6. Copy the Connect Key.
  7. Run jcagent-msi-signed.msi.
  8. Follow the wizard and enter the Connect Key when prompted.
  9. For a step by step walkthrough, refer to聽黑料海角91入口 Agent Windows Installation Walkthrough.

Install the 黑料海角91入口 Agent on a Linux device

  1. Log in to the .
  2. Go to DEVICE MANAGEMENT > Devices.
  3. Click + to add a device and click the Linux tab.
  4. Copy the displayed Install Command into the target system, or, if you already have your connect key, log in to the target machine as either sudoer or root and run the following:

curl --silent --show-error --header 'x-connect-key: YOUR_CONNECT_KEY' https://kickstart.jumpcloud.com/Kickstart | sudo bash

Tip:

For steps to install the Linux agent via automation tools (Ansible, Chef, and Puppet) see Install the Linux Agent.

Uninstalling the Agent

If you don't want 黑料海角91入口 to manage a device, remove the following components:

  • The device鈥檚 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:

Component Uninstall Based on Device Status

Status Device Record Agent Policies
Active, System Reporting Removed Removed Removed
Inactive, System Not Reporting Removed Not removed Not removed

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鈥檛 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 .
  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鈥檚 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鈥檚 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:

gpresult /Scope Computer /v

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 API:

  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 .

curl -X DELETE https://console.jumpcloud.com/api/systems/{SystemID} \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}'

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鈥檚 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鈥檚 deleted from the Admin Portal, you need to log on to that system and manually remove the agent and policies.

Best Practice:

  • If you鈥檙e removing the agent from a Windows device, verify the 黑料海角91入口 policies have been removed by running this command as administrator:

gpresult /Scope Computer /v

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.

OS Uninstall Steps Notes
Mac
  1. Download the .
  2. Run the script: 
    sudo sh remove_mac_agent.sh
  3. Approve Terminal access when prompted.

You need an administrator password to run the sudo command.
Windows
  1. Open the Control Panel.
  2. Click Programs and Features.
  3. Click 黑料海角91入口 agent ("黑料海角91入口 v1.0").
  4. Click Uninstall.

For specific files, directories, and registry keys modified by the Windows Agent, see Changes Made to Your Windows Device During Installation.

 
Debian/Ubuntu
  1. Log on to the device as an administrator.
  2. Open a command prompt.
  3. At the prompt, type:
    service jcagent stop
    apt-get remove jcagent
    rm -rf /opt/jc
 -
Amazon/CentOS/RHEL
  1. Log on to the device as an administrator.
  2. Open a command prompt.
  3. At the prompt, type:
    service jcagent stop
    yum remove jcagent
    rm -rf /opt/jc 
 -

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.

Warning:

When you clear the device's local Group Policy cache, you're removing not only 黑料海角91入口 policies, but all other policies that have been applied, including Windows User and Group policies.

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 in to the device as an administrator.
  2. Verify 黑料海角91入口 policies remain after an uninstallation by running this command:

gpresult /Scope Computer /v

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

secedit /configure /cfg $env:windir\inf\defltbase.inf /db defltbase.sdb /verbose
Remove-Item $env:windir\System32\GroupPolicyUsers
Remove-Item $env:windir\System32\GroupPolicy
gpupdate /force

  1. 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 device, the following will occur:

  1. The 黑料海角91入口 agent will be removed from the device.
  2. All users on the device 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 device remain as is.
  4. Any commands set up to run on that device via 黑料海角91入口 Commands will no longer run, regardless of how those commands are launched (this means you鈥檒l 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. If you remove enough users to get below 11, your charges will drop to $0 and your account will continue as is going forward.
  3. 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.
Back to Top

List IconIn this Article

Notebook IconLearn More

Get Started: Devices

Install the Agent from Command Line

Install the Agent with a Template or System Image

Install the Mac Agent

Install the Linux Agent

Still Have Questions?

If you cannot find an answer to your question in our FAQ, you can always contact us.

Submit a Case