Controllo Runtime da riga di comando (versione precedente)¶

Attenzione

Questo documento deve essere utilizzato come verifica dei parametri utilizzati tramite Runtime.exe. Questa modalità, anche se funzionante, non è più supportata. Per i nuovi sviluppi fare riferimento al documento Controllo Runtime da riga di comando.

I parametri da riga di comando sono supportati solo sui Runtime Windows.

Parametri	Descrizione
-connect	Connette Runtime al servizio di teleassistenza, rendendolo visibile al Control Center. Si usa questa opzione quando Runtime è già in esecuzione ma è scollegato, poiché di default Runtime si collega automaticamente, a meno che non venga specificata l’opzione disconnect.
-disconnect	Se Runtime è già in esecuzione, lo disconnette dal servizio di teleassistenza, rendendolo inaccessibile al Control Center e lo lascia in esecuzione. Se Runtime non è in esecuzione, lo avvia ma non lo connette al servizio di teleassistenza.
-showChat	Mostra la chat di teleassistenza.
-hideChat	Nasconde la chat di teleassistenza.
-showKeyboard	Mostra la tastiera di sistema.
-hideKeyboard	Nasconde la tastiera di sistema.
-remoteAccessServiceConnected	Indica lo stato di connessione del Runtime. Possibili valori: 0: Runtime non connesso al server; 1: Runtime connesso al server.
-remoteAccessSessionCount	Indica il numero di supervisori Control Center connessi al Runtime
-getanonymousid	Indica il valore dell’ID necessario per la registrazione a Dominio di un dispositivo anonimo. Possibili valori: -1: il Runtime non è connesso al servizio di teleassistenza; 0: il dispositivo è già associato ad un Dominio; ID: il numero che rappresenta l’ID da utilizzare per la registrazione a Dominio.
-getanonymouspassword	Indica il valore della password necessario per la registrazione a Dominio di un dispositivo anonimo. Possibili valori: -1: il Runtime non è connesso al servizio di teleassistenza; 0: il dispositivo è già associato ad un Dominio; Password: numero che rappresenta la password da utilizzare per la registrazione a Dominio.
-requestAssistance	Attiva una richiesta di assistenza. Se è attiva l’opzione di dominio The user must provide contact details when assistance is requested, allora vanno passati ulteriori tre parametri che corrispondono ai campi Name, Contact information e Description. Per maggiori informazioni, vedere Richiesta di assistenza. -1: il Runtime non è connesso al servizio di teleassistenza; 0: Errore. Non è possibile aprire la richiesta di assistenza; 1: Richiesta di assistenza aperta correttamente.
-closeAssistance	Chiude una richiesta di assistenza. Per maggiori informazioni, vedere Richiesta di assistenza. -1: il Runtime non è connesso al servizio di teleassistenza; 0: Errore. Non è possibile chiudere la richiesta di assistenza; 1: Richiesta di assistenza chiusa correttamente.
-canRequestAssistance	Verifica se una richiesta di assistenza può essere aperta. Per maggiori informazioni, vedere Richiesta di assistenza. -1: il Runtime non è connesso al servizio di teleassistenza; 0: il Runtime non può aprire una richiesta di assistenza; 1: il Runtime può aprire una richiesta di assistenza.
-quit	Utilizzato solo con Runtime già in esecuzione. Disconnette e chiude Runtime.
-version	Visualizza la versione del Runtime.

Esempi:

<path> identifica il percorso di installazione di UBIQUITY Runtime, per esempio

C:\Program Files (x86)\ASEM\Ubiquity\Runtime\

Avvertimento

Per utilizzare i parametri con UbiquityRuntime.exe da riga di comando, anteporre sempre start "" /wait prima di UbiquityRuntime.exe. Per esempio,

start "" /wait "<path>\UbiquityRuntime.exe" –remoteAccessServiceConnected

"<path>\UbiquityRuntime.exe" -connect

Connette il Runtime al servizio di teleassistenza.
"<path>\UbiquityRuntime.exe" -disconnect

Disconnette il Runtime dal servizio di teleassistenza.
"<path>\UbiquityRuntime.exe" –quit

Chiude definitivamente il Runtime.
"<path>\UbiquityRuntime.exe" –showChat\hideChat

Apre o chiude la finestra di chat.
"<path>\UbiquityRuntime.exe" –showKeyboard\hideKeyboard

Apre o chiude tastiera di sistema.

Eseguire i due comandi

"<path>\UbiquityRuntime.exe" –remoteAccessServiceConnected

echo %ERRORLEVEL%

Interroga il Runtime sullo stato della connessione al server. Il valore di ritorno è disponibile nella variabile di ambiente ERRORLEVEL.

Di seguito altri esempi di interrogazione del Runtime con parametro -remoteAccessServiceConnected utilizzando .NET e VBScript:

var process = new Process();
var path = @"C:\Program Files (x86)\ASEM\Ubiquity\Runtime\UbiquityRuntime.exe";
process.StartInfo.FileName = path;
process.StartInfo.Arguments = "-remoteAccessServiceConnected";
process.StartInfo.CreateNoWindow = true;
process.StartInfo.UseShellExecute = false;
process.Start();
process.WaitForExit();
Console.WriteLine("Runtime is connected to Access Server? " + process.ExitCode);

set wshShell = CreateObject("WScript.Shell")
prog = "C:\Program Files (x86)\ASEM\Ubiquity\Runtime\UbiquityRuntime.exe"
prog = chr(34) & prog & chr(34)
prog = prog & " " & chr(45) & "remoteAccessServiceConnected"
strErrorCode = wshShell.run(prog,7,1)
WScript.Echo strErrorCode

Avvertimento

La variabile d’ambiente ERRORLEVEL non è supportata dai sistemi WCE.

Eseguire i due comandi

"<path>\UbiquityRuntime.exe" –remoteAccessSessionCount

echo %ERRORLEVEL%

Interroga il Runtime sul numero di Control Center connessi. Il valore di ritorno è disponibile nella variabile di ambiente ERRORLEVEL.
Eseguire i due comandi

"<path>\UbiquityRuntime.exe" -getanonymousid

echo %ERRORLEVEL%

Interroga il Runtime sull’ID del dispositivo. Il valore di ritorno è disponibile nella variabile di ambiente ERRORLEVEL.
Eseguire i due comandi

"<path>\UbiquityRuntime.exe" -getanonymouspassword

echo %ERRORLEVEL%

Interroga il Runtime sulla password del dispositivo. Il valore di ritorno è disponibile nella variabile di ambiente ERRORLEVEL.
"<path>\UbiquityRuntime.exe" –requestAssistance

echo %ERRORLEVEL%

Attiva una richiesta di assistenza.
"<path>\UbiquityRuntime.exe" –requestAssistance "John Doe" "john.doe@email.com" "A brief description of the problem"

echo %ERRORLEVEL%

Attiva una richiesta di assistenza passando i tre parametri per Name, Contact information e Description.
"<path>\UbiquityRuntime.exe" –closeAssistance

echo %ERRORLEVEL%

Cancella una richiesta di assistenza.
"<path>\UbiquityRuntime.exe" –canRequestAssistance

echo %ERRORLEVEL%

Interroga il Runtime per vedere se una richiesta di assistenza può essere aperta.
"<path>\UbiquityRuntime.exe" –version

Visualizza la versione del Runtime.

Suggerimento

Nei sistemi WCE il nome del file eseguibile è «UBIQUITYRuntimeCE.exe».