הוספת Atera לרשימת החרגות ב-Windows Defender

כדי להוסיף את סוכן Atera לרשימת החריגים של Windows Defender, הריצו את הפקודות הבאות ב-PowerShell עם הרשאות מנהל. ניתן להריץ את הפקודות מקומית באמצעות PowerShell ISE (סביבת סקריפטים משולבת).

Add-MpPreference -ExclusionPath "C:\Program Files\Atera Networks\AteraAgent" -Force
Add-MpPreference -ExclusionPath "C:\Program Files (x86)\Atera Networks\AteraAgent" -Force
Add-MpPreference -ExclusionProcess "AteraAgent.exe" -Force

כצעד מניעתי, ניתן להעלות את הפקודות ל-Atera ולהריץ אותן על הסוכנים שלכם. פעולה זו תמנע מ-Windows Defender לסמן ולהסיר את סוכן Atera.

הערה: יש להקפיד להריץ את הפקודות כSystem, ולבחור את סוג הקובץ הנכון, .ps1.

למידע נוסף על העלאת סקריפטים ל-Atera, ראו יצירה, העלאה והרצה של סקריפטים

שחזור סוכן Atera מהסגר

אם Atera נכנסה להסגר, יש לשחזר את Atera ואת השירותים שלה.

הריצו את הפקודה הבאה ב-CMD (.bat) עם הרשאות מנהל.

מחשב 64 ביט:

"C:\Program Files\Windows Defender\MpCmdRun.exe" -Restore -Name "HackTool:Win32/RemoteAdmin" -path "C:\Program Files\ATERA Networks\AteraAgent"

מחשב 32 ביט:

"C:\Program Files\Windows Defender\MpCmdRun.exe" -Restore -Name "HackTool:Win32/RemoteAdmin" -path "C:\Program Files (x86)\ATERA Networks\AteraAgent"

למידע נוסף על שחזור קבצים מהסגר, ראו את המאמר הזה של מיקרוסופט.

הערה: אם לא ניתן לשחזר את סוכן Atera, יש לבצע ניקוי מלא והתקנה מחדש של הסוכן (ראו בהמשך).

התקנה מחדש של סוכן Atera

הריצו את הסקריפט הבא ב-PowerShell ISE עם הרשאות מנהל כדי לבצע ניקוי מלא של סוכן Atera.

#Start Script
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 $_ }
#End of Script

לאחר הרצת הסקריפט על המכשיר, ניתן להתקין מחדש את סוכן Atera.

למידע נוסף, ראו התקנת סוכן

איך נוכל לעזור?

נושאים נפוצים:

שחזור סוכן Atera מהסגר

התקנה מחדש של סוכן Atera