Fehlerbehebung bei Splashtop

Mit dem Fernzugriff von Splashtop können Sie sich aus der Ferne mit Ihren Kunden verbinden. In diesem Artikel besprechen wir, wie Sie häufige Probleme mit Splashtop beheben können, die auftreten könnten.

Splashtop für RMM und Splashtop Streamer

Splashtop für RMM ist die Softwareanwendung, die Sie auf Ihrem Gerät installieren müssen, von dem Sie aus der Ferne zugreifen möchten.

Splashtop Streamer hingegen ist die Softwareanwendung, die auf den Geräten installiert wird, auf die Sie zugreifen möchten. In der Regel ist es nicht notwendig, Splashtop Streamer manuell auf Ihren Geräten zu installieren, da es automatisch installiert wird, wenn eine Fernverbindung initiiert wird. Eine manuelle Installation kann jedoch erforderlich sein, wenn bei der automatischen Installation Probleme auftreten.

Voraussetzungen

Bitte stellen Sie sicher, dass Sie alle für Splashtop benötigten Server in Ihrem Netzwerk auf die Whitelist gesetzt haben und die erforderlichen Ports geöffnet sind. Bitte überprüfen Sie den folgenden Artikel, um alle für Splashtop erforderlichen Firewall-Einstellungen zu sehen.

Firewall-Einstellungen für Ateras Integrationen
Stellen Sie sicher, dass die folgenden Pfade auf Ihren Geräten ebenfalls auf der Whitelist stehen: "C:\Program Files\ATERA Networks\AteraAgent", "C:\Program Files (x86)\Splashtop"
Wenn Sie ESET oder eine andere Art von Antivirus installiert haben, könnten Probleme auftreten, da AVs standardmäßig Remote Desktop Protocol (RDP)-Verbindungen blockieren können. Für ESET können Sie die Installationskonfiguration anpassen, um RDP-Verbindungen zuzulassen. Erfahren Sie mehr

Fehlerbehebung bei Splashtop-Fernzugriff

Falls Sie Probleme haben, auf eines Ihrer Geräte zuzugreifen oder Splashtop Streamer zu installieren, befolgen Sie bitte diese Schritte. Die folgenden Schritte sollten die häufigsten Probleme beheben, die beim Versuch, eine Fernverbindung herzustellen, auftreten können.

Zusammenfassung

Um Probleme mit der Splashtop-Fernverbindung zu beheben, befolgen Sie diese Schritte:

Agentenverbindung überprüfen: Öffnen Sie CMD (Windows), um die Verbindung zu überprüfen, und prüfen Sie, ob die Verwaltungsoptionen hängen oder nicht..
- Wenn nicht reagierend, liegt das Problem beim Atera-Agenten. Überprüfen Sie diesen KB-Artikel: Fehlerbehebung beim Atera Windows-Agenten
- Wenn reagierend, liegt das Problem bei Splashtop, setzen Sie die Fehlerbehebung fort.
Skript ausführen: Führen Sie das Fix Splashtop issues script zur Fehlerbehebung aus.
AteraAgent-Dienst neu starten: Setzen Sie den Dienst über den Dienst-Manager zurück, warten Sie zwei Minuten und versuchen Sie dann erneut, eine Verbindung herzustellen.

Fix Splashtop issues script (.ps1)

Sie können dieses Skript direkt von Atera auf Ihrem Agenten ausführen, um die häufigsten Splashtop-Probleme zu beheben und die Konnektivität zu den Splashtop-Servern zu überprüfen.

Um das Skript auf Ihren Agenten auszuführen, laden Sie es bitte gemäß den folgenden Wissensdatenbankartikeln in Ihre Atera-Instanz hoch:

Wichtiger Hinweis: Bitte stellen Sie sicher, dass Sie das Skript als System ausführen und dass es als .ps1 festgelegt ist.

$domains = @(
    "st-v3.api.splashtop.com",
    "st-v3-g3.api.splashtop.com",
    "st-v3-src.api.splashtop.com",
    "st-v3-src-g3.api.splashtop.com",
    "st-relay-v3.api.splashtop.com",
    "st-relay-v3-g3.api.splashtop.com",
    "st-premium-v3.api.splashtop.com",
    "st-premium-v3-g3.api.splashtop.com"
)

foreach ($domain in $domains) {
    try {
        $url = "https://$domain/api/fulong/v3/echo/check-relay"
        $response = Invoke-WebRequest -Uri $url -UseBasicParsing -TimeoutSec 10
        $success = $false

        if ($response.StatusCode -eq 200 -and $response.Content -match '"result"\s*:\s*20200') {
            $success = $true
        }

        if ($success) {
            Write-Host "$domain : $($response.StatusCode) - ERFOLG" -ForegroundColor Green
        } else {
            Write-Host "$domain : $($response.StatusCode) - UNERWARTETES ERGEBNIS" -ForegroundColor Yellow
        }
    }
    catch {
        Write-Host "$domain : FEHLER - $($_.Exception.Message)" -ForegroundColor Red
    }
}

# Splashtop- und MSI-Prozesse beenden
$processesToKill = @("SRApp", "SRService", "SRManager", "SRAgent", "SRFeature", "SRServer", "msiexec")

foreach ($proc in $processesToKill) {
    try {
        $found = Get-Process -Name $proc -ErrorAction Stop
        $found | Stop-Process -Force
        Write-Host "Prozess $proc erfolgreich beendet." -ForegroundColor Green
    } catch {
        Write-Host "Prozess $proc nicht gefunden oder konnte nicht beendet werden." -ForegroundColor DarkYellow
    }
}

# Splashtop-Agent-Paket für beide Agent-Versionen löschen
$agentPackagePaths = @(
    "C:\Program Files\ATERA Networks\AteraAgent\Agent\packages\AgentPackageSTRemote",  # 2.0.0.0 und höher
    "C:\Program Files\ATERA Networks\AteraAgent\Packages\AgentPackageSTRemote"        # unter 2.0
)

foreach ($agentPackagePath in $agentPackagePaths) {
    if (Test-Path $agentPackagePath) {
        try {
            Remove-Item -Path $agentPackagePath -Recurse -Force
            Write-Host "Paket gelöscht: $agentPackagePath" -ForegroundColor Green
        } catch {
            Write-Host "Löschen fehlgeschlagen: $agentPackagePath — $($_.Exception.Message)" -ForegroundColor Red
        }
    } else {
        Write-Host "Paket nicht gefunden unter $agentPackagePath" -ForegroundColor DarkGray
    }
}

# Splashtop Streamer-Installer (Dateiversion) löschen
$installerPath = "C:\Windows\Temp\SplashtopStreamer.exe"
if (Test-Path $installerPath) {
    try {
        Remove-Item -Path $installerPath -Force
        Write-Host "Installer gelöscht: $installerPath" -ForegroundColor Green
    } catch {
        Write-Host "Löschen des Installers fehlgeschlagen: $installerPath — $($_.Exception.Message)" -ForegroundColor Red
    }
} else {
    Write-Host "Installer nicht gefunden unter $installerPath" -ForegroundColor DarkGray
}

# Temporären Ordner aus dem aktuellen Benutzerprofil löschen
try {
    $loggedInUser = (Get-CimInstance -ClassName Win32_ComputerSystem).UserName
    $userName = $loggedInUser.Split('\')[-1]
    $userTempPath = "C:\Users\$userName\AppData\Local\Splashtop"

    if (Test-Path $userTempPath) {
        Remove-Item -Path $userTempPath -Recurse -Force
        Write-Host "Benutzer-Temp-Ordner gelöscht: $userTempPath" -ForegroundColor Green
    } else {
        Write-Host "Temp-Ordner für Benutzer nicht gefunden: $userTempPath" -ForegroundColor DarkGray
    }
} catch {
    Write-Host "Benutzerprofil konnte nicht erkannt oder Temp-Ordner nicht gelöscht werden — $($_.Exception.Message)" -ForegroundColor Red
}

# Splashtop-Dienst neu starten
$serviceName = "SplashtopRemoteService"
try {
    Restart-Service -Name $serviceName -ErrorAction Stop
    Write-Host "Dienst neu gestartet: $serviceName" -ForegroundColor Green
} catch {
    Write-Host "Dienst konnte nicht neu gestartet werden: $serviceName — $($_.Exception.Message)" -ForegroundColor Red
}

Nach der Ausführung des Skripts auf Ihren Agenten stellen Sie bitte sicher, dass Sie den AteraAgent-Dienst neu starten, indem Sie zu Verwalten > Dienst-Manager navigieren, den AteraAgent -Dienst finden und neu starten. Warten Sie nach Abschluss zwei bis drei Minuten und versuchen Sie dann, auf Ihren Agenten zuzugreifen.

Wenn Sie weiterhin nicht auf Ihren Agenten über Splashtop zugreifen können, kontaktieren Sie bitte unser Support-Team.

Splashtop-Auflösungsprobleme beheben

Wenn Sie sich über Splashtop mit einem Gerät verbinden und Probleme mit der Auflösung Ihrer Splashtop-Instanz haben, bedeutet dies, dass die Video-Rendering-Einstellungen für Splashtop RMM nicht richtig eingerichtet sind.

So beheben Sie Auflösungsprobleme:

1. Öffnen Sie Splashtop für RMM auf dem Gerät, von dem aus Sie eine Fernverbindung herstellen möchten.

2. Klicken Sie im Fenster der Splashtop für RMM-App auf Optionen.

Ein neues Fenster für Splashtop für RMM mit dem Namen Option wird geöffnet.

3. Gehen Sie zu Erweitert. Hier können Sie testen, die Option "Kompatibilitätsmodus verwenden" zu deaktivieren. Für weitere Video-Rendering-Optionen klicken Sie auf Erweiterte Einstellungen.

4. In den Erweiterten Einstellungen können Sie die Video-Rendering-Optionen auswählen oder Hardwarebeschleunigung aktivieren/deaktivieren.

Wichtiger Hinweis: Wir können Ihnen nicht die genauen Video-Rendering-Einstellungen bereitstellen, die Sie benötigen, um eine hohe Auflösung bei Ihren Fernverbindungen zu erreichen. Dies liegt daran, dass es eine Vielzahl von Faktoren gibt, die Ihre Videoqualität bei der Initiierung einer Fernverbindung bestimmen können. Es ist von größter Bedeutung, die Einstellungen zu testen, um herauszufinden, welche Optionen Ihren Bedürfnissen entsprechen.

5. Nachdem Sie Ihre bevorzugten Video-Rendering-Optionen ausgewählt haben, klicken Sie auf OK, um Splashtop für RMM zu schließen.

Splashtop für RMM fehlt oder wurde nicht korrekt gestartet

Dieses Problem tritt auf, wenn versucht wird, direkt von Atera aus eine Fernverbindung zu einem Gerät herzustellen.

So beheben Sie das Problem:

1. Öffnen Sie Splashtop für RMM und klicken Sie auf Nach Updates suchen.

Sie erhalten eine von zwei Nachrichten: Entweder sind Updates verfügbar, in diesem Fall installieren Sie diese bitte und versuchen Sie dann, die Verbindung erneut herzustellen. Nach der Installation des Updates versuchen Sie, die Verbindung zu einem Gerät erneut herzustellen. Falls keine Updates verfügbar sind oder das Update das Problem nicht behoben hat, fahren Sie mit dem nächsten Schritt fort.

2. Installieren Sie Splashtop für RMM auf dem Gerät, von dem aus Sie eine Fernverbindung herstellen möchten, neu. Dies kann einfach über die Systemsteuerung > Programme und Funktionen erfolgen. Nach der Neuinstallation von Splashtop für RMM versuchen Sie eine weitere Verbindung.

3. Ein weiteres Problem, das Sie daran hindern könnte, eine Fernverbindung zu initiieren, ist das Blockieren von Pop-ups in Ihrem Browser. Stellen Sie bitte sicher, dass Pop-ups für Atera in Ihrem Browser aktiviert sind.

4. Falls der Verbindungsversuch nach den vorherigen Schritten immer noch fehlschlägt, starten Sie bitte Ihr Gerät neu und versuchen Sie es erneut. Dies sollte das Problem beheben.

Falls das Problem weiterhin besteht, wenden Sie sich bitte per E-Mail oder Chat an unser Support-Team.

Schwarzer/Grüner Bildschirm

Gelegentlich kann es vorkommen, dass die Remote-Verbindung den Desktop des Endbenutzers nicht anzeigt und stattdessen einen schwarzen oder grünen Bildschirm zeigt.

Um dieses Problem zu beheben, ändern Sie die Bildschirmaufnahme-Option über ein Skript:

Laden Sie das Skript zu Atera hoch als .ps1, und führen Sie es als System aus. Sobald das Skript in Ihrer Atera-Instanz hinzugefügt wurde, führen Sie es auf Ihrem Gerät aus.

Sie müssen den Wert "X" im Skript mit einer der folgenden Optionen ändern:

1 - Software
2 - Hardware
3 - NVIDIA-Grafik (falls verfügbar)
4 - Mirror Driver

Wir können keine genaue Option angeben, die Ihr Problem beheben wird, da mehrere Faktoren eine Rolle spielen. Bitte testen Sie, welche Option Ihren Bedürfnissen entspricht.

# Überprüfen, ob das System x64 oder x32 ist
if ($env:PROCESSOR_ARCHITECTURE -eq "AMD64") {
$regKey = "HKLM:\SOFTWARE\WOW6432Node\Splashtop Inc.\Splashtop Remote Server"
} else {
$regKey = "HKLM:\SOFTWARE\Splashtop Inc.\Splashtop Remote Server"
}

# Ändern des CaptureMode-Registrierungsschlüssels
try {
Set-ItemProperty -Path $regKey -Name CaptureMode -Value "X" -Type DWORD -Force
Write-Output "CaptureMode-Registrierungsschlüssel wurde erfolgreich aktualisiert."

# Neustart des SplashtopRemoteService
Restart-Service -Name SplashtopRemoteService -Force
Write-Output "SplashtopRemoteService wurde erfolgreich neu gestartet."
} catch {
Write-Error "Fehler: Registrierungsschlüssel konnte nicht geändert oder SplashtopRemoteService nicht neu gestartet werden."
}

Wichtige Hinweise: Wenn Sie Splashtop Streamer für Windows zusammen mit einer RDP-Sitzung verwenden, können beide erfolgreich koexistieren, wenn Sie zunächst über RDP eine Verbindung zu Ihrem Computer herstellen und dann über Splashtop Remote Desktop verbinden. Wenn Sie jedoch die RDP-Sitzung minimieren, kann Splashtop Remote Desktop einen schwarzen Bildschirm anzeigen.

Falscher Gerätename in Splashtop

Wenn der Hostname eines Geräts kürzlich geändert wurde, wird in Splashtop immer noch der alte Name angezeigt. Um dies zu beheben, führen Sie einfach das Skript auf Ihrem Gerät aus und der Name wird in Splashtop aktualisiert.

IF EXIST "%PROGRAMFILES(X86)%" (GOTO 64BIT) ELSE (GOTO 32BIT)
:64BIT
reg add "HKLM\SOFTWARE\WOW6432Node\Splashtop Inc.\Splashtop Remote Server" /f /v CloudComputerName /t REG_SZ /d %computername%
GOTO END
:32BIT
reg add "HKLM\SOFTWARE\Splashtop Inc.\Splashtop Remote Server" /f /v CloudComputerName /t REG_SZ /d %computername%
GOTO END
:END
sc stop "SplashtopRemoteService"
sc start "SplashtopRemoteService"

Sie können das Skript zu Atera hochladen und auf Ihren Geräten ausführen, die das Problem haben. Bitte fügen Sie das Skript als Batch-Datei (.bat) hinzu, wenn Sie es zu Atera hochladen.

Problem mit automatischer Bereitstellung

Wenn es ein Problem mit der automatischen Bereitstellung gibt, können Sie den Splashtop Streamer manuell von folgendem Link herunterladen:

Splashtop Streamer Installer

Sobald Sie den Splashtop Streamer-Client heruntergeladen haben, können Sie das Skript zu Atera hochladen und auf Ihren Geräten ausführen, die das Problem haben.

Wichtiger Hinweis: Bitte beachten Sie, dass Sie je nach Ihrem Abonnementplan möglicherweise den Installer nicht hochladen können. In diesem Fall können Sie ein Skript mit unserem Skript-Generator erstellen, um Splashtop von diesem Link auf Ihren Geräten zu installieren.

Der Lautsprecher und das Mikrofon funktionieren nicht auf Mac-Geräten

Es können Probleme auftreten, wenn Sie an einer Besprechung teilnehmen und Splashtop auf Ihren Geräten geöffnet ist. Um diese Probleme zu beheben, müssen Sie einige Einstellungen im Splashtop Streamer ändern. Greifen Sie auf den Splashtop Streamer auf dem Gerät zu, mit dem Sie verbunden sind, und ändern Sie Ihre Einstellungen auf "Ton nur auf diesem Computer ausgeben".

Splashtop für Linux-Geräte

Fehlerbehebungsschritte für Splashtop-Verbindungsprobleme in Atera.

Netzwerkverfügbarkeit prüfen:

Stellen Sie sicher, dass die VM eine stabile Internetverbindung hat.
Überprüfen Sie, ob die Netzwerkeinstellungen ausgehende Verbindungen auf den erforderlichen Ports (443 und 6783) zulassen.

Splashtop Streamer-Installation überprüfen:

Stellen Sie sicher, dass Splashtop Streamer korrekt installiert ist.
Überprüfen Sie, ob der Splashtop Streamer-Dienst läuft.

Firewall konfigurieren:

Stellen Sie sicher, dass die Firewall die erforderlichen Ports (443 und 6783) nicht blockiert.
Konfigurieren Sie die Firewall so, dass der Datenverkehr auf diesen Ports zugelassen wird.

Splashtop-Dienste neu starten:

Starten Sie den Splashtop Streamer-Dienst neu, um sicherzustellen, dass er ordnungsgemäß läuft.
Überprüfen Sie den Status des Dienstes, um zu bestätigen, dass er aktiv ist.

Wie können wir helfen?

Allgemeine Themen:

Related articles