

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Avvio di sessioni Amazon DCV
<a name="managing-sessions-start"></a>

Quando utilizzi le impostazioni predefinite per [installare il server Windows Amazon DCV](setting-up-installing-wininstall.md), una [sessione di console](managing-sessions-intro.md#managing-sessions-intro-console) viene automaticamente creata e attiva dopo l'installazione del server. La sessione della console predefinita è di proprietà di `Administrator` e dispone di un ID di sessione predefinito di `console`. Puoi usare questa sessione o [chiuderla](managing-sessions-lifecycle-stop.md) e creare una nuova sessione.

Se hai scelto di disattivare la creazione automatica della sessione della console quando hai installato il server Amazon DCV, devi crearne una manualmente. Dopo aver installato il server Amazon DCV, puoi abilitare o disabilitare la [creazione automatica della sessione della console](#managing-sessions-start-auto) in qualsiasi momento.

**Nota**  
I server Amazon DCV Linux e macOS non ricevono una sessione di console predefinita dopo l'installazione.

Supponiamo di utilizzare una licenza flottante su un server locale o alternativo basato sul cloud e di superare il numero massimo di sessioni simultanee supportate dalla licenza. Potresti ricevere un errore. `no licenses` Se si verifica questo errore, interrompi una sessione inutilizzata per liberare la licenza e riprova.

Il server Amazon DCV deve essere in esecuzione per avviare una sessione. Per ulteriori informazioni, consulta [Avvio del server Amazon DCV](manage-start.md).

**Topics**
+ [Avvio manuale della console e delle sessioni virtuali](#managing-sessions-start-manual)
+ [Abilitazione delle sessioni della console automatiche](#managing-sessions-start-auto)

## Avvio manuale della console e delle sessioni virtuali
<a name="managing-sessions-start-manual"></a>

Puoi avviare una sessione Amazon DCV in qualsiasi momento. Tuttavia, puoi eseguire solo una sessione della console alla volta. Se utilizzi un server Amazon DCV Linux, puoi eseguire più sessioni virtuali contemporaneamente.

È consigliabile eseguirla `dcv list-sessions` prima di creare una sessione, soprattutto se utilizzi il server Windows Amazon DCV.

Per creare una console o una sessione virtuale su un server Amazon DCV Windows, Linux o macOS, usa il comando. `dcv create-session`

**Topics**
+ [Sintassi](#managing-sessions-start-manual-syntax)
+ [Opzioni](#managing-sessions-start-manual-options)
+ [Esempi](#managing-sessions-start-manual-examples)

### Sintassi
<a name="managing-sessions-start-manual-syntax"></a>

La sintassi minima del comando per avviare una sessione è:

```
dcv create-session {{session_ID}}
```

La sintassi completa con tutte le opzioni è:

```
dcv create-session \
    --type {{console|virtual}} \
    --name {{session_name}} \
    --user {{username}} \
    --owner {{owner_name}} \
    --permissions-file {{/path_to/permissions_file}} \
    --storage-root {{/path_to/storage_directory}} \
    --gl {{on|off}} \
    --max-concurrent-clients {{number_of_clients}} \
    --init {{/path_to/init_script}} \
    {{session_ID}}
```

**Nota**  
Il `\` simbolo rappresenta la sintassi per dividere un comando in più righe.

È inoltre possibile `dcv create-session --help` utilizzarlo per visualizzare un riferimento rapido alla sintassi.

### Opzioni
<a name="managing-sessions-start-manual-options"></a>

Puoi utilizzare le seguenti opzioni con il comando `dcv create-session`:

**`--type`**  
Questa opzione è supportata solo sui server Amazon DCV Linux. Tale opzione specifica il tipo di sessione da creare, e può essere `console` o `virtual`.  
Tipo: String  
Valori consentiti: `console` \| `virtual`  
Obbligatorio: no

**`--name`**  
Speciifica un nome per la sessione. I nomi delle sessioni possono essere qualsiasi stringa composta da un massimo di 256 caratteri. Se la stringa supera i 256 caratteri, il comando ha esito negativo. Non è necessario che i nomi delle sessioni siano univoci tra le sessioni in esecuzione.  
È possibile modificare il nome di una sessione in qualsiasi momento utilizzando il `dcv set-name` comando. Per ulteriori informazioni, consulta [Gestione del nome della sessione](managing-session-name.md).  
Tipo: stringa  
Obbligatorio: sì

**`--user`**  
Questa opzione è supportata solo con sessioni virtuali su Linux Amazon DCV. Questo valore rappresenta l'utente da utilizzare per creare la sessione. Solo l'utente root è in grado di impersonare altri utenti.  
▬Tipo: stringa  
Obbligatorio: no

**`--owner`**  
Specifica il proprietario della sessione. Per impostazione predefinita, qualora non venga inserito l'utente, tale valore è rappresentato dall'utente che ha effettuato l'accesso.  
▬Tipo: stringa  
Obbligatorio: no

**`--permissions-file`**  
Specifica un percorso personalizzato per il file di autorizzazione. Se omesso, tale valore è rappresentato dal server predefinito.  
▬Tipo: stringa  
Obbligatorio: no

**`--storage-root`**  
Specifica il percorso della cartella usato per lo storage della sessione.  
Puoi utilizzare `%home%` per specificare la home directory dell'utente che ha attualmente effettuato l'accesso. Ad esempio, di seguito viene impostata la directory per lo storage della sessione come `c:\Users\{{username}}\storage\` per i server Windows o `$HOME/storage/` per i server Linux.  

```
--storage-root %home%/storage/
```
Se una sottodirectory specificata non esiste, l'archiviazione delle sessioni è disabilitata.
▬Tipo: stringa  
Obbligatorio: no

**`--gl`**  
Questa opzione è supportata solo con sessioni virtuali su Linux Amazon DCV. Sostituisce lo stato `dcv-gl` predefinito e può essere `on` o `off`.  
Tipo: String  
Valori consentiti: `on` \| `off`  
Obbligatorio: no

**`--max-concurrent-clients`**  
Speciifica il numero massimo di client Amazon DCV a cui è consentito connettersi alla sessione. Per impostazione predefinita, se omesso, tale valore è rappresentato da un numero illimitato di connessioni.  
Tipo: Integer  
Obbligatorio: no

**`--init`**  
Questa opzione è supportata solo con sessioni virtuali su server Amazon DCV Linux. Specifica il percorso di uno script `init` personalizzato. Lo script può essere utilizzato per avviare un determinato ambiente desktop e lanciare applicazioni specifiche automaticamente quando la sessione viene avviata. Lo script deve essere eseguibile. Per impostazione predefinita, se omesso, tale valore è rappresentato dall'ambiente desktop predefinito.  
▬Tipo: stringa  
Obbligatorio: no

**`{{session ID}}`**  
Fornisce un ID per la sessione alla fine del comando.  
Tipo: stringa  
Obbligatorio: sì

### Esempi
<a name="managing-sessions-start-manual-examples"></a>

**Esempio 1: sessione della console**  
Il comando seguente crea una sessione di console di proprietà di `dcv-user` con un ID di sessione univoco di `my-session` e un nome di sessione di`my graphics session`. Specifica inoltre un file di autorizzazioni denominato. `perm-file.txt`
+ Server Amazon DCV Windows

  ```
  C:\> dcv create-session^
      --owner {{dcv-user}}^
      --name "{{my graphics session}}"^
      --permissions-file {{perm-file.txt}}^
      {{my-session}}
  ```
+ Server Linux Amazon DCV

  ```
  $ sudo dcv create-session \
      --type={{console}} \
      --owner {{dcv-user}} \
      --name "{{my graphics session"}} \
      --permissions-file {{perm-file.txt}} \
      {{my-session}}
  ```

**Esempio 2 - Sessione virtuale (solo server Linux Amazon DCV)**  
Il comando seguente crea una sessione virtuale utilizzando l'utente root per impersonare il proprietario della sessione previsto,. `dcv-user` La sessione è di proprietà di `dcv-user` anche se è stata creata dall'utente root

```
$ sudo dcv create-session \
    --owner {{dcv-user}} \
    --user {{dcv-user}} \
    {{my-session}}
```

**Esempio 3 - Sessione virtuale (solo server Linux Amazon DCV)**  
Il comando seguente crea una sessione virtuale di proprietà dell'utente che la crea:

```
$ dcv create-session {{my-session}}
```

## Abilitazione delle sessioni della console automatiche
<a name="managing-sessions-start-auto"></a>

L'abilitazione di una sessione di console automatica garantisce che una sessione di console venga creata automaticamente ogni volta che viene avviato il server Amazon DCV. La sessione automatica della console è di proprietà dell'utente Amazon DCV specificato dal parametro di `owner` configurazione. Il suo ID sessione è sempre `console`.

Altri parametri che interessano le sessioni della console automatica sono `max-concurrent-clients`, `permissions-file` e `storage-root`. Per ulteriori informazioni su questi parametri, consultare [Parametri `session-management/automatic-console-session`](config-param-ref.md#session_management_automatic_console_session).

**Nota**  
Amazon DCV non supporta sessioni virtuali automatiche.

------
#### [ Windows Amazon DCV server ]

**Per abilitare una sessione di console automatica su un server Amazon DCV Windows**

1. Apri l'editor del Registro di Windows.

1. Passa alla **chiave HKEY\_USERS\\ S-1-5-18\\ Software\\\\ com\\nicesoftware\\ dcvGSettings\\ session-management**.

1. Crea un parametro `create-session`:

   1. ******Nel riquadro di navigazione, apri il menu contestuale (fai clic con il pulsante destro del mouse) per la chiave di gestione della sessione e scegli Nuovo, valore DWORD (32 bit).******

   1. In **Nome**, immetti `create-session` e premi **Invio**.

   1. Apri il parametro **create-session**. In **Dati valore**, immetti `1` e scegli **OK**.

1. Passa alla **chiave HKEY\_USERS\\ S-1-5-18\\ Software\\\\ com\\nicesoftware\\ dcv\\ session-management/ GSettings**. automatic-console-session

1. Crea un parametro `owner`:

   1. ****Nel riquadro di navigazione, apri il menu contestuale (fai clic con il pulsante destro del mouse) per la chiave e scegli Nuovo, String Value. **automatic-console-session******

   1. In **Nome**, immetti `owner` e premi **Invio**.

   1. Apri il parametro **owner**. In **Dati valore**, immetti il nome del proprietario della sessione e scegli **OK**.

1. Seleziona **OK** e chiudi l'editor del Registro di sistema di Windows.

1. [Arresta](manage-stop.md) e [riavvia](manage-start.md) il server Amazon DCV.

------
#### [ Linux Amazon DCV server ]

**Per abilitare una sessione di console automatica su un server Amazon DCV Linux**

1. Individua `/etc/dcv/` e utilizza un editor di testo per aprire il file `dcv.conf`.

1. Aggiungi i parametri `create-session` e `owner` alla sezione `[session-management/automatic-console-session]` utilizzando il formato seguente:

   ```
   [session-management]
   create-session = true
   
   [session-management/automatic-console-session]
   owner="{{session-owner}}"
   ```

1. Salva e chiudi il file.

1. [Arresta](manage-stop.md) e [riavvia](manage-start.md) il server Amazon DCV.

------
#### [ macOS Amazon DCV server ]

**Per abilitare una sessione di console automatica su un server Amazon DCV macOS**

1. Individua `/etc/dcv/` e utilizza un editor di testo per aprire il file `dcv.conf`.

1. Aggiungi i parametri `create-session` e `owner` alla sezione `[session-management/automatic-console-session]` utilizzando il formato seguente:

   ```
   [session-management]
   create-session = true
   
   [session-management/automatic-console-session]
   owner="{{session-owner}}"
   ```

1. Salva e chiudi il file.

1. [Arresta](manage-stop.md) e [riavvia](manage-start.md) il server Amazon DCV.

------