Kommandozeilenparameter

Installations-Schalter für das Setup (EXE)

Beispiel

pcvisit_RemoteHost_Setup.exe /S /CompanyAccountId=12345678 /UseCompanyPreset

Parameter für Supporter-Modul und Remote-Host

/log
erstellt eine Datei im Ziel-Installationsordner, die Logausgaben vom Setup enthält

/S
Installation ohne grafische Oberfläche (silent Installation z.B. für unattended Installation)

Für die Deinstallation ohne grafische Oberfläche kann der Parameter /S zusammen mit dem jeweiligen Uninstaller genutzt werden.

Supporter-Modul:

C:\Program Files (x86)\pcvisit Software AG\pcvisit Support\uninstall.exe /S

/InSessionInstall
verhindert, dass der Nutzer bei der Installation, den Wizard überspringen kann.

/Gateway=lb3.pcvisit.de
Legt den verwendeten Verbindungsserver "lb3.pcvisit.de" fest. Diese Angabe ist nur bei einem eigenen Private Server notwendig.

Parameter für pcvisit Supporter-Modul

/directStart
Führt das Supporter-Modul nach der Installation aus. (nur in Verbindung mit /S)

/checkForRunningHost
Prüft vor dem Schreiben der Dateien, ob noch ein Supporter-Modul läuft. Wenn ja, dann bricht die Installation mit einer Fehlermeldung ab.

/setNoShortcuts
Verhindert, dass das Setup Links auf dem Desktop oder im Startmenu anlegt bzw. vorhandene verändert. (wird für z.B. für Updates verwendet)

Parameter für pcvisit Remote-Host

/CompanyAccountId=123456789
Ordnet diesen pcvisit Remote-Host der Computer-Liste des Supporters mit der Firmen-ID 12345678 zu. 

/AccessPW=Geheim
Setzt das Zugriffspasswort dieses Remote-Hosts auf "Geheim". 

/UseSettingsPW
Setzt das Einstellungspasswort (auf den Wert des Zugriffspasswortes. Bei zusätzlicher Verwendung der Option /SettingsPW kann ein separates Passwort angegeben werden).

/SettingsPW=AuchGeheim
Setzt ein separates Einstellungspasswort "AuchGeheim". (nur in Verbindung mit /UseSettingsPW)

/UseCompanyPreset
nutzt die Voreinstellungen im Supporter-Modul für den Remote-Host (nur in Verbindung mit /CompanyAccountId). Fehlt dieser Schalter, werden die übergebenen Daten gesetzt.

/useSupportPermission
legt fest, dass beim Kunde vor dem Remotezugriff eine Abfrage angezeigt wird.

Silent Deinstallation für Remote-Host unter Windows

Die uninstall.exe des Remote-Host wird in dem Ordner "release" innerhalb des Installationspfades abgelegt.

C:\Program Files (x86)\pcvisit Software AG\pcvisit RemoteHost\release

In diesen Release Ordner wird jetzt die jeweilige Version des Remote-Hosts abgelegt, dort drin enthalten ist dann auch die jeweilige uninstall.exe. Das nachfolgende Skript prüft welche Version installiert ist und führt das die zugehörige uninstall.exe aus.

# Pfad zum Release-Ordner
$releasePath = "C:\Program Files (x86)\pcvisit Software AG\pcvisit RemoteHost\release"

# Name des Dienstes
$serviceName = "Pcvisit Caloa Agent Service 1.5"

# Überprüfen, ob der Pfad existiert
if (Test-Path $releasePath) {
    # Dienst stoppen
    Write-Output "Stoppe Dienst: $serviceName..."
    $serviceStopResult = Stop-Service -Name $serviceName -Force -ErrorAction SilentlyContinue

    if ($?) {
        Write-Output "Dienst $serviceName erfolgreich gestoppt."
    } else {
        Write-Output "Dienst $serviceName konnte nicht gestoppt werden oder ist nicht aktiv. Fahre fort..."
    }

    # Ordner im Release-Verzeichnis auflisten
    $versionFolders = Get-ChildItem -Path $releasePath -Directory |
        Where-Object { $_.Name -match "^\d+\.\d+\.\d+\.\d+$" } # Filter für Versionsordner

    if ($versionFolders) {
        # Aktuellste Version ermitteln (höchste Nummer)
        $latestVersion = $versionFolders | Sort-Object Name -Descending | Select-Object -First 1

        # Anzeige der Version
        Write-Output "Gefundene Version: $($latestVersion.Name)"

        # Pfad zur uninstall.exe
        $uninstallPath = Join-Path -Path $latestVersion.FullName -ChildPath "uninstall.exe"

        if (Test-Path $uninstallPath) {
            # Deinstallationsbefehl mit dem Schalter /S ausführen
            Write-Output "Starte Deinstallation im stillen Modus..."
            Start-Process -FilePath $uninstallPath -ArgumentList "/S" -Wait

            # Kurze Wartezeit, um sicherzustellen, dass der Ordner vollständig entfernt wurde
            Start-Sleep -Seconds 2

            # Überprüfen, ob der Ordner noch existiert
            if (Test-Path $releasePath) {
                Write-Output "Entferne Release-Ordner..."
                Remove-Item -Path $releasePath -Recurse -Force

                if (-Not (Test-Path $releasePath)) {
                    Write-Output "Release-Ordner erfolgreich gelöscht."
                } else {
                    Write-Output "Fehler beim Löschen des Release-Ordners."
                }
            } else {
                Write-Output "Release-Ordner wurde während der Deinstallation entfernt."
            }
        } else {
            Write-Output "Uninstall.exe nicht gefunden im Ordner: $($latestVersion.FullName)"
        }
    } else {
        Write-Output "Keine Versionsordner im Release-Verzeichnis gefunden."
    }
} else {
    Write-Output "Der Pfad zum Release-Ordner existiert nicht: $releasePath"
}

Silent Installation für Remote-Host unter macOSX

sudo installer -store -pkg <PATH_TO_PKG> -target /

Hiermit wird die .pkg silent installiert. Mit der .dmg ist dieser Aufruf nicht möglich. Die .pkg kann aus der .dmg kopiert werden oder die angepasste .pkg inklusive eigener Firmen-ID im Supporter-Modul und in der Webapp generiert werden.

Webapp: https://mobile.pcvisit.de/settings/remote-host - Remote Host-Setup verteilen

Supporter-Modul:  Einstellungen - pcvisit Remote-Hosts bei Kunden installieren - Downloadlink in die Zwischenablage kopieren

Verwendung in den installierten Modulen

Beispiel

"C:\Program Files (x86)\pcvisit Software AG\pcvisit Support\host.exe" -I CommandLine.txt --UsageMode 0 --gateway lb3.pcvisit.de

Parameter für alle Module

--gateway lb3.pcvisit.de
legt den Verbindungsserver für den gesamten PC fest (Diese Angabe ist nur bei einem eigenen Private Server sinnvoll.)

Parameter für pcvisit Supporter-Modul

--connectToRH "c:\Desktop\Mein Rechner.pcv"
Verbindet sich mit Hilfe der pcvisit Verknüpfung zu dem entsprechenden Remote-Host"c:\Desktop\Mein Rechner.pcv" mit den entsprechenden Voreinstellungen. (siehe auch Integration in Drittsysteme)

--connectToRH MeinServer#1
Baut eine Fernwartung mit dem entsprechenden Remote-Host "MeinServer#1" auf, sofern dieser bereits in der Computer-Liste vorhanden ist. Wenn er noch nicht vorhanden ist, wird er der Computer-Liste hinzugefügt. (Siehe Beispiel Integration von pcvisit in Remote Desktop Manager)

--CustomSessionComment
siehe angepasste Sitzungskommentare

Parameter für pcvisit Kunden-Modul und pcvisit Remote-Host

Beispiele

Kunden-Modul:
pcvisit_Support_Kunden_Modul.exe /args="--connectTo 12435678"

Remote-Host:
"C:\Program Files (x86)\pcvisit Software AG\pcvisit RemoteHost\pcvisit_client.exe" --connectTo 12435678

Parameter

--connectTo 12435678
Startet das Kunden-Modul und trägt im Tab "Fernwartung" die Fernwartungs-ID "12435678" ein

--connectTo F12435678
Startet das Kunden-Modul und trägt im Tab "Support-Anfrage" die Firmen-ID "F12435678" ein