Righe di comando di Runtime

È possibile avviare il programma UbiquityRuntimeCli inserendo alcune righe di comando nel prompt dei comandi.

Il comando UbiquityRuntimeCli è disponibile per UBIQUITY Runtime a partire dalla versione 11.10. Utilizzare il file UbiquityRuntime.exe per le versioni di Runtime precedenti alla 11.10.
Nota: Vedere Righe di comando Runtime versione precedente per ulteriori informazioni su questo argomento.
Nota: I parametri della riga di comando sono supportati solo sui seguenti sistemi: Linux Ubuntu 22 e Windows, ad eccezione di Windows CE e Windows XP.
Nota: Legenda del codice restituito:
  • Output standard: Informazioni di output che seguono una voce della linea comando.
  • Stato di uscita: Il comando immesso nel file UbiquityRuntimeCli è stato eseguito correttamente e viene stampato nei Log.
Parametri Descrizione
--connect

Connettere Runtime ai server UBIQUITY quando Runtime è già in esecuzione ma disconnesso. Runtime si connette automaticamente per impostazione predefinita, a meno che non sia stata inserita la riga di comando --disconnect.
--disconnect

Disconnettere Runtime dai server UBIQUITY. Il collegamento al servizio di assistenza remota non è possibile.
--showChat

Aprire la finestra della chat di assistenza.
--hideChat

Nascondere la finestra della chat di assistenza.
--showKeyboard

Aprire la tastiera di sistema.
--hideKeyboard

Chiudere la tastiera di sistema.
--openWebUI

Aprire Windows Runtime tramite una pagina Web.
--remoteAccessServiceConnected

Vedere stato della connessione di Runtime.

Output standard:
  • 0: Runtime non è connesso al server
  • 1: Runtime è connesso al server
Stato di uscita:
  • 0: L'immissione del comando è riuscita
  • 1: Il collegamento al Runtime non è riuscito
--remoteAccessSessionCount

Vedere la quantità di supervisori remoti connessi al Runtime da UBIQUITY.

Output standard:
  • N: Numero di supervisori connessi a Runtime da UBIQUITY
Stato di uscita:
  • 0:L'immissione del comando è riuscita
  • 1: Il collegamento al Runtime non è riuscito
--getanonymousID

Visualizzare l'ID e la password necessari per registrare un dispositivo di Runtime a un dominio.

Stato di uscita:
  • 0: L'immissione del comando è riuscita
  • 1: Il collegamento al Runtime non è riuscito
  • 2: Runtime non è connesso ai server UBIQUITY
  • 3: Il dispositivo è già registrato in un dominio.
--requestAssistance

Abilita una richiesta di assistenza. Se l'opzione L'utente deve fornire i dettagli di contatto quando viene richiesta assistenza è abilitata, è necessario specificare tre parametri aggiuntivi corrispondenti ai campi <name>, <contact> e <description>.

Stato di uscita:
  • 0: L'immissione del comando è riuscita
  • 1: Il collegamento al Runtime non è riuscito
  • 2: Runtime non è connesso ai server UBIQUITY
  • 3: La richiesta di assistenza non può essere aperta.
--closeAssistance

Chiudere una richiesta di assistenza.

Stato di uscita:
  • 0: L'immissione del comando è riuscita
  • 1: Il collegamento al Runtime non è riuscito
  • 2: Runtime non è connesso ai server UBIQUITY
  • 3: La richiesta di assistenza non può essere chiusa.
--getRequestAssistanceStatus

Visualizzare lo stato di una richiesta di assistenza.

Output standard:
  • 0: È stata inviata una richiesta di assistenza.
  • 1: Al momento non è richiesta alcuna assistenza.
Stato di uscita:
  • 0: L'immissione del comando è riuscita
  • 1: Il collegamento al Runtime non è riuscito
  • 2: Runtime non è connesso ai server UBIQUITY
--canRequestAssistance

Controllare se è possibile aprire una richiesta di assistenza.

Output standard:
  1. 0: Runtime non è in grado di aprire una richiesta di assistenza
  2. 1: Runtime può aprire una richiesta di assistenza
Stato di uscita:
  1. 0: L'immissione del comando è riuscita
  2. 1: Il collegamento al Runtime non è riuscito
  3. 2: Runtime non è connesso ai server UBIQUITY
--exportConnectionLog
Esportare i log della connessione. Indicare i parametri dei log --fromDate, --toDate e --outputDirectory.
Nota: Se si seleziona un intervallo di date non valido, i log esportati restituiscono zero risultati.
Stato di uscita:
  1. 0: L'immissione del comando è riuscita
  2. 1: Il collegamento al Runtime non è riuscito
  3. 2: L'esportazione dei log di connessione non è riuscita
--setRuntimePassword seguita dalla <password> che si desidera configurare.

Configurare una password per accedere a Windows Runtime.

Nota: Vedere Installazione e configurazione di Ubuntu 22 Runtime per ulteriori informazioni su come configurare una password.
Stato di uscita:
  1. 0: L'impostazione della password è riuscita
  2. 1: L'utente non dispone dei diritti utente necessari per cambiare la password
  3. 2: La password non soddisfa gli standard di conformità alla sicurezza
--unsetRuntimePassword

Rimuovere una password impostata in precedenza per accedere a Windows Runtime

Stato di uscita:
  1. 0: La password è stata rimossa correttamente
  2. 1: L'utente non dispone dei diritti utente necessari per cambiare la password
--quit

Disconnettere Runtime quando è in esecuzione.
--version

Vedere la versione Runtime.
-h, --help

Consultare l'elenco dei comandi attualmente disponibili.

Esempi

path identifica il percorso di installazione di Runtime. Per esempio: C:\Program Files (x86)\ASEM\Ubiquity\Runtime\.

Parametri Descrizione
"<path>\UbiquityRuntimeCli" --connect

Connettere Runtime ai server UBIQUITY quando Runtime è già in esecuzione ma disconnesso. Runtime si connette automaticamente per impostazione predefinita, a meno che non sia stata inserita la riga di comando --disconnect.
"\UbiquityRuntimeCli" --disconnect

Disconnettere Runtime dai server UBIQUITY. Il collegamento al servizio di assistenza remota non è possibile.
"<path>\UbiquityRuntimeCli" --showChat

Aprire la finestra della chat di assistenza.
"<path>\UbiquityRuntimeCli" --hideChat

Nascondere la finestra della chat di assistenza e disconnettere Runtime dal servizio di assistenza remota.
"<path>\UbiquityRuntimeCli" --showKeyboard

Aprire la tastiera di sistema.
"<path>\UbiquityRuntimeCli" --hideKeyboard

Chiudere la tastiera di sistema.
"<path>\UbiquityRuntimeCli" --openWebUI

Aprire Windows Runtime tramite una pagina Web.
"<path>\UbiquityRuntimeCli" --remoteAccessServiceConnected

Vedere stato della connessione di Runtime.
"<path>\UbiquityRuntimeCli" --remoteAccessSessionCount

Vedere la quantità di supervisori remoti connessi al Runtime da UBIQUITY.
"<path>\UbiquityRuntimeCli" --getanonymousID

Visualizzare l'ID e la password necessari per registrare un dispositivo di Runtime a un dominio. Nell'esempio seguente viene illustrato come eseguire una query sul Runtime tramite il parametro --getAnonymousID usando .NET:

var process = new Process();
process.StartInfo.FileName = @"C:\Program Files (x86)\ASEM\Ubiquity\Runtime\UbiquityRuntimeCli.exe";
process.StartInfo.Arguments = "--getAnonymousID";
process.StartInfo.CreateNoWindow = true;
process.StartInfo.RedirectStandardOutput = true;
process.StartInfo.UseShellExecute = false;
process.StartInfo.WindowStyle = ProcessWindowStyle.Hidden;
process.Start();
process.WaitForExit();
Console.WriteLine("AnonymousID, Password: " + process.StandardOutput.ReadToEnd());
Console.WriteLine("exit code: " + process.ExitCode);
Console.ReadLine();
"<path>\UbiquityRuntimeCli" --requestAssistance

Abilita una richiesta di assistenza. Se l'opzione L'utente deve fornire i dettagli di contatto quando viene richiesta assistenza è abilitata, è necessario specificare tre parametri aggiuntivi che corrispondono ai campi Nome, Informazioni di contatto e Descrizione.

Esempio: "<path>\UbiquityRuntimeCli" --requestAssistance --name "John Doe" --contact "john.doe@email.com" --description "A brief description of the problem"
"<path>\UbiquityRuntimeCli" --closeAssistance

Chiudere una richiesta di assistenza.
"<path>\UbiquityRuntimeCli" --getRequestAssistanceStatus

Visualizzare lo stato di una richiesta di assistenza.
"<path>\UbiquityRuntimeCli" --canRequestAssistance

Controllare se è possibile aprire una richiesta di assistenza.
"<path>\UbiquityRuntimeCli" --exportConnectionLog

Esportare i log della connessione. Indicare i parametri dei log --fromDate, --toDate e --outputDirectory.

Esempio: "<path>\UbiquityRuntimeCli" --exportConnectionLog --fromDate "2020-06-06" --toDate "2020-06-07" --outputDirectory "/tmp"
"<path>\UbiquityRuntimeCli" --setRuntimePassword

Configurare una password per accedere a Windows Runtime. Per esempio:

"<path>\UbiquityRuntimeCli" --setRuntimePassword <password>
"<path>\UbiquityRuntimeCli" --unsetRuntimePassword Rimuovere una password impostata in precedenza per accedere a Windows Runtime.
"<path>\UbiquityRuntimeCli" --quit

Disconnettere Runtime quando è in esecuzione.
"<path>\UbiquityRuntimeCli" --version

Vedere la versione Runtime.
"<path>\UbiquityRuntimeCli" -h, \UbiquityRuntimeCli" --help

Consultare l'elenco dei comandi attualmente disponibili.