Wie entferne ich den Atera Agent nach Ablauf meiner Testphase?

Wenn Sie den Atera Agent nach Ablauf Ihrer Testphase (oder nach Deaktivierung Ihres Kontos) von den Endgeräten Ihrer Nutzer entfernen müssen, können Sie dieses von einem Nutzer eingereichte Skript verwenden. Ein großes Dankeschön an David Yoder für seinen Beitrag!

In diesem Artikel finden Sie das Entfernungs-Skript sowie eine kurze Beschreibung der enthaltenen Funktionen.

Agent entfernen (Windows)

Führen Sie dieses PowerShell-Skript aus, um den Atera Agent von Ihren Geräten zu entfernen.

Hinweis:

Dieses Skript funktioniert nur auf Windows-Geräten mit aktuellen PowerShell-Versionen (es funktioniert nicht unter Windows 7).
Um das Skript remote auszuführen, benötigen Sie für jedes Netzwerk einen Domain Controller, PSExec oder ein anderes RMM-Tool.
Für die Ausführung des Skripts sind Administratorrechte erforderlich. Sie müssen das Skript als Administrator ausführen.

Function Get-UninstallCodes ([string]$DisplayName) {
'HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall', 'HKLM:SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall' | ForEach-Object {
Get-ChildItem -Path $_ -ErrorAction SilentlyContinue | ForEach-Object {
If ( $(Get-ItemProperty -Path $_.PSPath -Name 'DisplayName' -ErrorAction SilentlyContinue) -and ($(Get-ItemPropertyValue -Path $_.PSPath -Name 'DisplayName' -ErrorAction SilentlyContinue) -eq $DisplayName) ) {
$str = (Get-ItemPropertyValue -Path $_.PSPath -Name 'UninstallString')
$UninstallCodes.Add($str.Substring(($str.Length - 37),36)) | Out-Null
}
}
}
}

Function Get-ProductKeys ([string]$ProductName) {
Get-ChildItem -Path 'HKCR:Installer\Products' | ForEach-Object {
If ( $(Get-ItemProperty -Path $_.PSPath -Name 'ProductName' -ErrorAction SilentlyContinue) -and ($(Get-ItemPropertyValue -Path $_.PSPath -Name 'ProductName' -ErrorAction SilentlyContinue) -eq $ProductName) ) {
$ProductKeys.Add($_.PSPath.Substring(($_.PSPath.Length - 32))) | Out-Null
}
}
}

Function Get-ServiceStatus ([string]$Name) { (Get-Service -Name $Name -ErrorAction SilentlyContinue).Status }

Function Stop-RunningService ([string]$Name) {
If ( $(Get-ServiceStatus -Name $Name) -eq "Running" ) { Write-Output "Stopping : ${Name} service" ; Stop-Service -Name $Name -Force }
}

Function Remove-StoppedService ([string]$Name) {
$s = (Get-ServiceStatus -Name $Name)
If ( $s ) {
If ( $s -eq "Stopped" ) {
Write-Output "Deleting : ${Name} service"
Start-Process "sc.exe" -ArgumentList "delete ${Name}" -Wait
}
} Else { Write-Output "Not Found: ${Name} service" }
}

Function Stop-RunningProcess ([string]$Name) {
$p = (Get-Process -Name $_ -ErrorAction SilentlyContinue)
If ( $p ) { Write-Output "Stopping : ${Name}.exe" ; $p | Stop-Process -Force }
Else { Write-Output "Not Found: ${Name}.exe is not running"}
}

Function Remove-Path ([string]$Path) {
If ( Test-Path $Path ) {
Write-Output "Deleting : ${Path}"
Remove-Item $Path -Recurse -Force
} Else { Write-Output "Not Found: ${Path}" }
}

Function Get-AllExeFiles ([string]$Path) {
If ( Test-Path $Path ) {
Get-ChildItem -Path $Path -Filter *.exe -Recurse | ForEach-Object { $ExeFiles.Add($_.BaseName) | Out-Null }
}
}

# Mount HKEY_CLASSES_ROOT registry hive
New-PSDrive -Name HKCR -PSProvider Registry -Root HKEY_CLASSES_ROOT | Out-Null

#######
# START: Information gathering
#######

# Get MSI package codes from the uninstall key
$UninstallCodes = New-Object System.Collections.ArrayList
'AteraAgent', 'Splashtop for RMM', 'Splashtop Streamer' | ForEach-Object { Get-UninstallCodes -DisplayName $_ }

# Get product keys from the list of installed products
$ProductKeys = New-Object System.Collections.ArrayList
'AteraAgent', 'Splashtop for RMM', 'Splashtop Streamer' | ForEach-Object { Get-ProductKeys -ProductName $_ }

# Define all the directories we'll need to cleanup at the end of this script
$Directories = @(
"${Env:ProgramFiles}\ATERA Networks",
"${Env:ProgramFiles(x86)}\ATERA Networks",
"${Env:ProgramFiles}\Splashtop\Splashtop Remote\Server",
"${Env:ProgramFiles(x86)}\Splashtop\Splashtop Remote\Server",
"${Env:ProgramFiles}\Splashtop\Splashtop Software Updater",
"${Env:ProgramFiles(x86)}\Splashtop\Splashtop Software Updater",
"${Env:ProgramData}\Splashtop\Splashtop Software Updater"
)

# Get all possible relevant exe files so we can make sure they're closed later on
$ExeFiles = New-Object System.Collections.ArrayList
"${Env:ProgramFiles}\ATERA Networks" | ForEach-Object { Get-AllExeFiles -Path $_ }

# Define a list of services we need to stop and delete (if necessary)
$ServiceList = @(
'AteraAgent',
'SplashtopRemoteService',
'SSUService'
)

# Define a list of registry keys we'll delete
$RegistryKeys = @(
'HKLM:SOFTWARE\ATERA Networks',
'HKLM:SOFTWARE\Splashtop Inc.',
'HKLM:SOFTWARE\WOW6432Node\Splashtop Inc.'
)

#######
# END: Information gathering
#######

# Uninstall each MSI package code in $UninstallCodes
$UninstallCodes | ForEach-Object { Write-Output "Uninstall: ${_}" ; Start-Process "msiexec.exe" -ArgumentList "/X{${_}} /qn" -Wait }

# Stop services if they're still running
$ServiceList | ForEach-Object { Stop-RunningService -Name $_ }

# Terminate all relevant processes that may still be running
$ExeFiles.Add('reg') | Out-Null
$ExeFiles | ForEach-Object { Stop-RunningProcess $_ }

# Delete services if they're still present
$ServiceList | ForEach-Object { Remove-StoppedService -Name $_ }

# Delete products from MSI installer registry
$ProductKeys | ForEach-Object { Remove-Path -Path "HKCR:Installer\Products\${_}" }

# Unmount HKEY_CLASSES_ROOT registry hive
Remove-PSDrive -Name HKCR

# Delete registry keys
$RegistryKeys | ForEach-Object { Remove-Path -Path $_ }

# Delete remaining directories
#Write-Host "Waiting for file locks to be freed" ; Start-Sleep -Seconds 4
$Directories | ForEach-Object { Remove-Path -Path $_ }

Das PowerShell-Skript kurz erklärt

Das Agent-Entfernungs-Skript besteht aus mehreren Funktionen, die hier kurz erläutert werden:

Get-UninstallCodes: Holt die MSI-Paketcodes aus dem Uninstall-Schlüssel für:
- Atera Agent
- Splashtop for RMM
- Splashtop Streamer
Get-ProductKeys: Holt die Produkt-Keys der folgenden Produkte:
- Atera Agent
- Splashtop for RMM
- Splashtop Streamer
Get-ServiceStatus: Listet alle laufenden Dienste auf.
Stop-RunningService: Stoppt Dienste, die von der Funktion 'Get-ServiceStatus' gefunden wurden.
Remove-StoppedService: Entfernt Dienste, die durch die Funktion 'Stop-RunningService' gestoppt wurden.
Stop-RunningProcess: Beendet laufende Prozesse (Atera Agent und Splashtop Streamer).
Remove-Path: Entfernt alle Dateien aus folgenden Verzeichnissen:
- {Env:ProgramFiles}\ATERA Networks
- {Env:ProgramFiles(x86)}\ATERA Networks
- {Env:ProgramFiles}\Splashtop\Splashtop Remote\Server
- {Env:ProgramFiles(x86)}\Splashtop\Splashtop Remote\Server
- {Env:ProgramFiles}\Splashtop\Splashtop Software Updater
- {Env:ProgramFiles(x86)}\Splashtop\Splashtop Software Updater
- {Env:ProgramData}\Splashtop\Splashtop Software Updater
Get-AllExeFiles: Sucht nach relevanten .exe-Dateien unter Atera Networks und Splashtop Streamer – inklusive deren Unterprozessen – um sicherzustellen, dass sie entfernt wurden.

Agent entfernen (Mac)

Führen Sie die folgenden Befehle aus, um eine vollständige Bereinigung auf Mac-Geräten durchzuführen:

cd "/Library/Application Support"
sudo rm -rf com.atera*
sudo rm -rf /Library/LaunchDaemons/com.atera.ateraagent.plist
sudo rm -rf /Applications/AteraAgent.app

sudo launchctl unload /Library/LaunchDaemons/com.atera.agent.plist 2>/dev/null
sudo launchctl stop com.atera.agent
sudo rm -rf /Library/Application\ Support/com.atera*
sudo rm -f /Library/LaunchDaemons/com.atera*
sudo rm -rf /Applications/AteraAgent.app
sudo pkgutil --forget com.atera.ateraagent
sudo pkgutil --forget com.atera.agent

Agent entfernen (Linux)

Führen Sie diesen Befehl im Terminal aus, um den Atera Agent von Ihrem Linux-Gerät zu entfernen.

/usr/lib/atera-agent/uninstall.sh

Wie können wir helfen?

Allgemeine Themen:

Agent entfernen (Windows)

Das PowerShell-Skript kurz erklärt

Agent entfernen (Mac)

Agent entfernen (Linux)