Enable uninstall validation during agent upgrade

task brazil Updated Sep 10, 2026 1 min read require-token-uninstall-upgrade.md
Raw file servicenow.com

Configure requiring a maintenance token to uninstall agents during agent upgrade. A maintenance token provides a layer of administrative control so that unauthorized personnel can't perform the uninstall.

Before you begin

Role required: sn_agent.token_admin

Procedure

  1. Navigate to All > System Properties > All Properties.

  2. Locate the sn_agent.upgrade_enable_uninstall_validation property and set its value to true.

    If the property does not exist, select New to create it.

    Note: If uninstall validation is enabled, setting the system property back to false disables the feature on the next version upgrade.

Result

The property is invoked for both selective upgrade and high volume upgrade, and the uninstall feature is enabled on Windows agents.

Parent Topic:Require a maintenance token for Windows uninstalls

Search documentation
Search document titles and file paths on the brazil branch