Utilizzo di un file di connessione

Utilizzando il client nativo Windows, Linux o macOS, puoi creare un file di connessione che puoi usare per connetterti istantaneamente a una sessione NICE DCV.

Creazione del file di connessione

Il file di connessione è un file basato su testo con estensione file .dcv. Il formato del .dcv file è simile a quello di un .ini file. Il file include [groups] seguiti dai parametri e dai relativi valori. I gruppi e i parametri assumono il seguente formato:

[group_name]
parameter_name=parameter_value
    

Per esempio:

[options]
fullscreen=true
    

È possibile creare un file di connessione per una sessione NICE DCV specifica direttamente dal client. Oppure, in alternativa, è possibile creare un file di connessione partendo da zero utilizzando un editor di testo.

Nota

La procedura per creare un file di connessione da zero utilizzando un editor di testo è la stessa per i client Windows, Linux e macOS.

Per creare un file di connessione dal client

1. Apri il client.

2. Connect al server e alla sessione in cui si sta creando il file.

3. Seleziona il nome host per il server NICE DCV nell'angolo in alto a destra e scegli Salva connessione con nome.

4. Nella finestra Salva con nome, specificare un nome di file e la cartella di destinazione e scegliere Salva.

Per impostazione predefinita, quando create un file di connessione, il file include i parametriformat,, host portuser, e. proxytype Questi parametri sono necessari per connettersi alla sessione da cui è stato creato il file. Puoi personalizzare manualmente o aggiungere parametri in qualsiasi momento modificando il file utilizzando un editor di testo.

Per creare un file di connessione da zero utilizzando un editor di testo

1. Creare un file .dcv con il seguente formato di nome file: file_name.dcv

2. Aprire il file .dcv tramite l'editor di testo preferito.

3. Aggiungete il [version] gruppo e il format parametro all'inizio del file nel seguente formato:

   [version]
   format=1.0

   Importante

   Se il .dcv file non include il [version] gruppo e il format parametro, l'analisi non riesce.

4. Aggiungere i gruppi di parametri richiesti utilizzando il seguente formato:

   [group_name]

   Per ulteriori informazioni sui gruppi di parametri, consulta Parametri supportati.

5. Aggiungere i parametri e i valori dei parametri dopo i gruppi utilizzando il seguente formato:

   parameter_name=parameter_value

   Nota

   • I nomi dei parametri fanno distinzione tra maiuscole e minuscole.

   • Non racchiudete i valori dei parametri di stringa tra virgolette.

   Per ulteriori informazioni sui parametri e sui valori dei parametri, consulta Parametri supportati.

6. Salva i cambiamenti e chiudi il file .dcv.

Puoi anche utilizzare questa procedura per aggiungere ulteriori parametri a un file di connessione esistente in qualsiasi momento.

Parametri supportati

Attualmente, il .dcv file supporta parametri in tre gruppi di parametri: [version][connect], e. [options] Nelle tabelle seguenti vengono elencati i gruppi e i relativi parametri disponibili.

Gruppi

• Parametri [version]
• Parametri [connect]
• Parametri [options]

Parametri [version]

Importante

Questo è un gruppo obbligatorio. Se il .dcv file non include questo gruppo, l'analisi non riesce.

Nella tabella seguente vengono elencati i parametri che è possibile specificare nel gruppo [version].

Parametro	Type	Valore predefinito	Descrizione
format	string		Importante Questo è un parametro obbligatorio. Il valore del parametro deve essere 1.0. Se il .dcv file non include questo parametro, l'analisi non riesce.

Parametri [connect]

Nella tabella seguente vengono elencati i parametri che è possibile specificare nel gruppo [connect].

Parametro	Type	Valore predefinito	Descrizione
host	Stringa		L'hostname del server NICE DCV che ospita la sessione.
port	Numero intero	8443	La porta da utilizzare per la connessione al server NICE DCV.
weburlpath	Stringa		Un percorso personalizzato sul server NICE DCV per la connessione. Ad esempio, se si specifica customPath, il client tenta di connettersi a host:port/customPath.
sessionid	Stringa		L'ID della sessione NICE DCV a cui connettersi.
authtoken	Stringa		Il token di autenticazione da utilizzare per la connessione. Se si specifica un authtoken, è necessario specificare anche un sessionid. Quando si utilizza authtoken, è possibile omettere i parametri user e password.
Utente	Stringa		Il nome utente da utilizzare per la connessione al server NICE DCV.
password	Stringa		La password da utilizzare per la connessione al server NICE DCV. La password non è crittografata.
proxytype	Stringa	SYSTEM	Il tipo di proxy da utilizzare. I valori validi includono HTTPSHTTP,SOCKS5|SOCKS,SYSTEM, oNONE|DIRECT. Se si specifica SYSTEM, vengono utilizzate le impostazioni proxy del computer.
proxyhost	Stringa		L'indirizzo del server proxy da utilizzare per la connessione tramite un server proxy.
proxyport	Numero intero		La porta da utilizzare per la connessione tramite un server proxy.
proxyuser	Stringa		Il nome utente da utilizzare per l'autenticazione proxy.
proxypassword	Stringa		La password da utilizzare per l'autenticazione proxy. La password non è crittografata.
Trasporto	Stringa	websocket	Il protocollo da utilizzare per il trasporto dei dati. Specificate websocket di utilizzare il protocollo WebSocket (TCP) per il trasporto dei dati oppure specificate di quic utilizzare il protocollo QUIC (UDP) per il trasporto dei dati. Se si abilita QUIC, il protocollo QUIC viene utilizzato per il trasporto dei dati e WebSocket per il traffico di autenticazione. Se abiliti WebSocket, il WebSocket protocollo viene utilizzato sia per il trasporto dei dati che per il traffico di autenticazione.
webport	Numero intero	8443	La porta da utilizzare per il traffico WebSocket (TCP).
porta rapida	Numero intero	8443	La porta da utilizzare per il traffico QUIC (UDP).
politica di convalida dei certificati	Stringa	ask-user	La politica per la convalida di un certificato non attendibile. I valori includono strict, accept-untrusted e ask-user.

Parametri [options]

Nella tabella seguente vengono elencati i parametri che è possibile specificare nel gruppo [options].

Parametro	Type	Valore predefinito	Descrizione
fullscreen	Booleano	false	Indica se il client si avvia in modalità a schermo intero.
useallmonitors	Booleano	false	Indica se il client utilizza tutti i monitor quando avvia la modalità a schermo intero.
promptreconnect	Booleano	true	Indica se il client richiede di riconnettersi dopo la disconnessione da una sessione. Se il parametro è impostato sutrue, verrai reindirizzato alla schermata di accesso quando ti disconnetti. Se il parametro è impostato su false, il client si chiude quando si esegue la disconnessione.
abilita la decodifica uv444	Booleano	false	Indica se abilitare l'alta precisione del colore (YUV 4:4:4) durante la codifica di contenuti video dinamici.

Esecuzione del file di connessione

Per eseguire il file di .dcv connessione, accedete al file e fate doppio clic su di esso.

Oppure, specificare il percorso del file come un argomento per il comando dcvviewer.

• Client Windows

  C:\> dcvviewer.exe path\connection_file_name.dcv

• Client Linux e macOS

  $ dcvviewer path/connection_file_name.dcv