Skip to main content

Desinstalación del agente (v6.9.4+)

Para clientes que necesitan remover el agente NESS de un equipo Windows (10, 11 o Server 2012 R2 en adelante).

Exclusiones requeridas

Antes de ejecutar ness-cleaner.exe, cree las exclusiones de antivirus en cualquier antivirus/EDR del equipo; de lo contrario podrían bloquear la limpieza.

1. Descargar el binario​

# Descarga directa (no requiere login)
Invoke-WebRequest -Uri "https://storage.googleapis.com/repo.nesshq.com/tools/ness-cleaner.exe" -OutFile "$env:TEMP\ness-cleaner.exe"
# Desbloquear (MOTW)
Unblock-File "$env:TEMP\ness-cleaner.exe"

Validación de hash (opcional):

Get-FileHash "$env:TEMP\ness-cleaner.exe" -Algorithm SHA256

SHA-256 esperado: 0DE9188C3F58B716A855E3F3A9D1B03DE68E558B0932E8E38A0FD5CCF4C4DE02

2. Elegir el modo​

ModoCuándoComando
Legacy (sin contraseña)El tenant no tiene "Uninstall Protection". Modo más común.ness-cleaner.exe --legacy --force --offline
ContraseñaEl tenant tiene "Uninstall Protection".ness-cleaner.exe --password "<CONTRASEÑA>" --force --offline
Token de emergenciaEquipo offline o contraseña desconocida.ness-cleaner.exe --emergency-token "<TOKEN>" --force --offline

Si --legacy no está autorizado verá:

[ERR] --legacy no autorizado: este tenant tiene Uninstall Protection habilitado.
Use --password o solicite un --emergency-token al administrador.
  • La contraseña se guarda cifrada en el vault DPAPI del agente; si el agente aún funciona, consúltela con ness-core-service --doctor (sección "Uninstall Password").
  • El token de un solo uso lo genera el administrador en la consola: Endpoint Generate Uninstall Token.

3. Ejecutar​

  1. Abra PowerShell como administrador (confirme UAC).
  2. Ejecute: 
    Set-Location $env:TEMP
    .\ness-cleaner.exe --legacy --force --offline
  3. Espere [ness-cleaner] EXIT 0 -- proceso terminado correctamente.

4. Reiniciar​

Algunos archivos (en especial WinDivert64.sys) quedan bloqueados por el kernel; el cleaner los programa para eliminación en el próximo reinicio.

shutdown /r /t 0 /c "NESS desinstalado - reinicio automatico"

5. Verificar​

Test-Path "C:\Program Files\NESS Core"
Test-Path "C:\ProgramData\NESS"
Get-Service | Where-Object Name -like "NESS*"
Get-ScheduledTask | Where-Object TaskPath -eq "\NESS\"
Get-WindowsDriver -Online | Where-Object ProviderName -eq "WinDivert"

Si Test-Path devuelve $false y lo demás está vacío, la desinstalación fue exitosa.

Pendiente: información por confirmar

Procedimiento de desinstalación para Linux y macOS.

Fuente

NESS Endpoint Agent – Guía de desinstalación v6.9.4.