---
sourceDocument: Brazil IT Operations Management
sourceDocumentLink: https://www.servicenow.com/docs/r/it-operations-management

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Create a maintenance token

# Create a maintenance token {#ariaid-title1}

Release version: Brazil  
Updated September 10, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
Create a maintenance token to use when uninstalling an agent from a Windows device. Administrators require maintenance tokens to ensure that unauthorized employees can't perform an uninstall.

## Before you begin

Role required: sn_agent.token_admin

## About this task

Maintenance tokens are short-lived by design. The default expiration is after 30 minutes. To modify the expiration time:

1. Navigate to AllSystem PropertiesAll Properties.
2. Select New.
3. Configure the following values for the token's expiration time:{#create-maintenance-token__table_un4_gfq_jkc__entry__2}

   | Field | Value |
   |-|-|
   | Name | sn_agent.maintenance_token.expiry_minutes |
   | Type | integer |
   | Value | \<the amount of time, in minutes, before the token expires\> |
   [Table 1. Maintenance token fields]

   {#create-maintenance-token__table_un4_gfq_jkc}
4. Select Submit.
{#create-maintenance-token__ol_zqx_g2q_jkc}

## Procedure

1. Navigate to AllAgent Client CollectorDeploymentAgent Maintenance Token.
2. Select New.
3. Configure the following values for the token:  
   {#create-maintenance-token__table_ejw_tgq_jkc__entry__2}

   | Field | Description |
   |-|-|
   | Alias | Enter a descriptive name for the maintenance token. |
   | Purpose | Select uninstall. |
   | Scope | Select the token's scope: * global: Token applies to all agents. * targeted: Token applies only to selected agents. When selecting this option, the Agents field appears. {#create-maintenance-token__ul_xds_bhq_jkc} |
   | Agents | Select the Unlock agents (![Unlock agents icon]()) icon and select the agents for the token to apply to. This field appears only when selecting targeted as the token scope. |
   [Table 2. Maintenance token fields]

   {#create-maintenance-token__table_ejw_tgq_jkc}
4. Select the Activate check box to activate the token.
5. Select Submit.

## What to do next

Uninstall the agent using the maintenance token, as described in [Uninstall an agent using a maintenance token](https://www.servicenow.com/docs/ychR068xbB8sDTdBhLriJg "Uninstall an agent from a Windows device using a maintenance token. Administrators require maintenance tokens to ensure that unauthorized employees can't perform an uninstall.").  
Note:  
Ensure that you use the maintenance token before it expires.

*[\>]: and then