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à.

# Sintassi dei comandi CLI
<a name="cli-command-syntax"></a>

È possibile utilizzare i comandi CLI utilizzando la seguente sintassi:

```
aws-vpn-client <COMMAND> [OPTIONS]
```

Lo strumento CLI supporta i seguenti comandi.

```
Usage: aws-vpn-client <COMMAND>

Commands:
  connect                Connect a profile through the AWS VPN Client
  disconnect             Disconnect a profile from the AWS VPN Client
  delete-profile         Delete a profile from the AWS VPN Client
  import-profile         Import a VPN connection profile
  list-profiles          List all VPN profiles
  get-config             Get configuration for a profile
  put-preference         Put a preference value
  list-preferences       List all preferences
  get-connection-status  Get the current connection status for a VPN profile
  list-connections       List all active VPN connections
  send-diagnostic-logs   Send diagnostic logs to AWS for troubleshooting
  help                   Print this message or the help of the given subcommand(s)

Options:
  -h, --help     Print help
  -V, --version  Print version
```

## connect
<a name="cli-cmd-connect"></a>

### Description
<a name="cli-cmd-connect-description"></a>

Stabilisci una connessione VPN a un profilo.

### Riepilogo
<a name="cli-cmd-connect-synopsis"></a>

```
aws-vpn-client connect
  --profile-name <PROFILE>
  [--auth-user-pass <AUTH_USER_PASS>]
```

### Opzioni
<a name="cli-cmd-connect-options"></a>

`--profile-name` (Stringa)  
Il nome del profilo da connettere. Questa opzione è obbligatoria.

`--auth-user-pass` (Stringa)  
Percorso di un file contenente il nome utente (riga 1), la password (riga 2) e il codice MFA opzionale (riga 3). Questa opzione non è obbligatoria.

### Esempi
<a name="cli-cmd-connect-examples"></a>

**Esempio: connessione a un profilo VPN **

L'`connect`esempio seguente stabilisce una connessione VPN a un profilo.

```
aws-vpn-client connect --profile-name "Production-VPN"
```

Output:

```
{
  "status": "Connected"
}
```

## disconnettere
<a name="cli-cmd-disconnect"></a>

### Description
<a name="cli-cmd-disconnect-description"></a>

Termina una connessione VPN attiva.

### Riepilogo
<a name="cli-cmd-disconnect-synopsis"></a>

```
aws-vpn-client disconnect
  --profile-name <PROFILE_NAME>
```

### Opzioni
<a name="cli-cmd-disconnect-options"></a>

`--profile-name` (Stringa)  
Il nome del profilo connesso da disconnettere. Questa opzione è obbligatoria.

### Esempi
<a name="cli-cmd-disconnect-examples"></a>

**Esempio: disconnessione da un profilo VPN **

L'`disconnect`esempio seguente interrompe una connessione VPN. Non viene fornito alcun risultato sull'esito positivo.

```
aws-vpn-client disconnect --profile-name "Production-VPN"
```

**Esempio: errore di disconnessione **

L'`disconnect`esempio seguente mostra l'errore quando il profilo non è connesso.

```
aws-vpn-client disconnect --profile-name "Production-VPN"
```

Output:

```
{
  "status": "Error",
  "message": "Profile is not connected"
}
```

## import-profile
<a name="cli-cmd-import-profile"></a>

### Description
<a name="cli-cmd-import-profile-description"></a>

Importa un profilo di connessione VPN.

### Riepilogo
<a name="cli-cmd-import-profile-synopsis"></a>

```
aws-vpn-client import-profile
  --profile-name <PROFILE_NAME>
  --config-path <CONFIG_PATH>
  [--global]
```

### Opzioni
<a name="cli-cmd-import-profile-options"></a>

`--profile-name` (Stringa)  
Nome personalizzato per il profilo importato. Questa opzione è obbligatoria.

`--config-path` (Stringa)  
Percorso del file di configurazione OpenVPN (.ovpn). Questa opzione è obbligatoria.

`--global`(booleano)  
Importa come profilo globale disponibile per tutti gli utenti. Questa opzione richiede i privilegi di amministratore.

### Esempi
<a name="cli-cmd-import-profile-examples"></a>

**Esempio: importazione di un profilo **

L'`import-profile`esempio seguente importa un profilo di connessione VPN.

```
aws-vpn-client import-profile --profile-name "Production-VPN" --config-path /path/to/vpn-config.ovpn
```

Output:

```
{
  "status": "Success"
}
```

**Esempio: importazione di un profilo globale **

L'`import-profile`esempio seguente importa un profilo globale. Ciò richiede i privilegi di amministratore.

```
sudo aws-vpn-client import-profile --profile-name "Company-VPN" --config-path /path/to/config.ovpn --global
```

Output:

```
{
  "status": "Success"
}
```

**Esempio: errore di importazione con percorso di file non valido **

L'`import-profile`esempio seguente mostra l'errore quando il file di configurazione non viene trovato.

```
aws-vpn-client import-profile --profile-name "test" --config-path /invalid/path.ovpn
```

Output:

```
{
  "status": "Error",
  "message": "Failed to read OpenVPN config file: No such file or directory (os error 2)"
}
```

## delete-profile
<a name="cli-cmd-delete-profile"></a>

### Description
<a name="cli-cmd-delete-profile-description"></a>

Elimina un profilo dal client.

### Riepilogo
<a name="cli-cmd-delete-profile-synopsis"></a>

```
aws-vpn-client delete-profile
  --profile-name <PROFILE_NAME>
```

### Opzioni
<a name="cli-cmd-delete-profile-options"></a>

`--profile-name` (Stringa)  
Il nome del profilo da eliminare. Questa opzione è obbligatoria.

### Esempi
<a name="cli-cmd-delete-profile-examples"></a>

**Esempio: eliminare un profilo **

L'`delete-profile`esempio seguente elimina un profilo VPN. Non viene fornito alcun risultato sull'esito positivo.

```
aws-vpn-client delete-profile --profile-name "Production-VPN"
```

**Esempio: errore di eliminazione con profilo inesistente **

L'`delete-profile`esempio seguente mostra l'errore quando il profilo non esiste.

```
aws-vpn-client delete-profile --profile-name "nonexistent"
```

Output:

```
{
  "status": "Error",
  "message": "Profile not found"
}
```

## list-profiles
<a name="cli-cmd-list-profiles"></a>

### Description
<a name="cli-cmd-list-profiles-description"></a>

Elenca tutti i profili VPN.

### Riepilogo
<a name="cli-cmd-list-profiles-synopsis"></a>

```
aws-vpn-client list-profiles
```

### Esempi
<a name="cli-cmd-list-profiles-examples"></a>

**Esempio: elenca tutti i profili VPN **

L'`list-profiles`esempio seguente elenca tutti i profili VPN importati.

```
aws-vpn-client list-profiles
```

Output:

```
[
  {
    "profile-name": "Production-VPN",
    "owned-by": "jdoe",
    "auth-type": "saml",
    "imported-at": "2026-07-21T13:04:42-07:00"
  },
  {
    "profile-name": "Staging-VPN",
    "owned-by": "jdoe",
    "auth-type": "ma",
    "imported-at": "2026-07-22T10:30:00-07:00"
  }
]
```

**Nota**  
I profili globali (importati con`--global`) non hanno un `owned-by` campo.

## get-config
<a name="cli-cmd-get-config"></a>

### Description
<a name="cli-cmd-get-config-description"></a>

Recupera la configurazione OpenVPN per un profilo.

### Riepilogo
<a name="cli-cmd-get-config-synopsis"></a>

```
aws-vpn-client get-config
  --profile-name <PROFILE_NAME>
```

### Opzioni
<a name="cli-cmd-get-config-options"></a>

`--profile-name` (Stringa)  
Il nome del profilo per cui recuperare la configurazione. Questa opzione è obbligatoria.

### Esempi
<a name="cli-cmd-get-config-examples"></a>

**Esempio: recupera la configurazione di OpenVPN **

L'`get-config`esempio seguente recupera la configurazione OpenVPN per un profilo.

```
aws-vpn-client get-config --profile-name "Production-VPN"
```

Output:

```
client
dev tun
proto udp
remote cvpn-endpoint-0123456789abcdef0.prod.clientvpn.us-east-1.amazonaws.com 443
remote-random-hostname
resolv-retry infinite
nobind
remote-cert-tls server
cipher AES-256-GCM
verb 3
<ca>
-----BEGIN CERTIFICATE-----
...
-----END CERTIFICATE-----
</ca>
auth-user-pass
reneg-sec 0
```

## get-connection-status
<a name="cli-cmd-get-connection-status"></a>

### Description
<a name="cli-cmd-get-connection-status-description"></a>

Ottieni lo stato attuale della connessione per un profilo VPN.

### Riepilogo
<a name="cli-cmd-get-connection-status-synopsis"></a>

```
aws-vpn-client get-connection-status
  --profile-name <PROFILE_NAME>
  [--show-details]
```

### Opzioni
<a name="cli-cmd-get-connection-status-options"></a>

`--profile-name` (Stringa)  
Il nome del profilo per cui recuperare lo stato della connessione. Questa opzione è obbligatoria.

`--show-details`(booleano)  
Includi le statistiche sui byte di connessione nell'output.

### Esempi
<a name="cli-cmd-get-connection-status-examples"></a>

**Esempio: ottieni lo stato della connessione **

L'`get-connection-status`esempio seguente recupera lo stato della connessione per un profilo.

```
aws-vpn-client get-connection-status --profile-name "Production-VPN"
```

Output:

```
{
  "connection-status": "Connected",
  "latest-connection-attempt": {
    "initiated-by": "jdoe",
    "updated-at": "2026-07-24T15:50:36-07:00"
  }
}
```

**Esempio: ottieni lo stato della connessione con i dettagli **

L'`get-connection-status`esempio seguente include le statistiche sui byte utilizzando l'`--show-details`opzione.

```
aws-vpn-client get-connection-status --profile-name "Production-VPN" --show-details
```

Output:

```
{
  "connection-status": "Connected",
  "latest-connection-attempt": {
    "initiated-by": "jdoe",
    "updated-at": "2026-07-24T15:50:36-07:00",
    "details": {
      "tunnel-bytes-in": 0,
      "tunnel-bytes-out": 0,
      "transport-bytes-in": 9674,
      "transport-bytes-out": 11413
    }
  }
}
```

## connessioni a lista
<a name="cli-cmd-list-connections"></a>

### Description
<a name="cli-cmd-list-connections-description"></a>

Elenca tutte le connessioni VPN attive.

### Riepilogo
<a name="cli-cmd-list-connections-synopsis"></a>

```
aws-vpn-client list-connections
```

### Esempi
<a name="cli-cmd-list-connections-examples"></a>

**Esempio: elenco delle connessioni attive **

L'`list-connections`esempio seguente elenca tutte le connessioni VPN attive.

```
aws-vpn-client list-connections
```

Output:

```
[
  {
    "profile-name": "Production-VPN",
    "initiated-by": "jdoe",
    "connection-status": "Connected",
    "last-updated-at": "2026-07-24T15:50:36-07:00"
  }
]
```

**Esempio: nessuna connessione attiva **

L'`list-connections`esempio seguente mostra l'output quando non ci sono connessioni attive.

```
aws-vpn-client list-connections
```

Output:

```
[]
```

## put-preferences
<a name="cli-cmd-put-preference"></a>

### Description
<a name="cli-cmd-put-preference-description"></a>

Imposta una preferenza di configurazione globale. La maggior parte delle impostazioni richiede i privilegi di amministratore.

### Riepilogo
<a name="cli-cmd-put-preference-synopsis"></a>

```
aws-vpn-client put-preference
  --key <PREFERENCE_KEY>
  --value <PREFERENCE_VALUE>
```

### Opzioni
<a name="cli-cmd-put-preference-options"></a>

`--key` (Stringa)  
Il nome della chiave di preferenza da impostare. Questa opzione è obbligatoria.

`--value` (Stringa)  
Il valore da impostare per la chiave di preferenza. Questa opzione è obbligatoria.

Sono disponibili i seguenti tasti di preferenza:

`enable-telemetry`  
Abilita o disabilita la telemetria (). true/false

`enable-user-profile-management`  
Consenti o impedisci agli utenti finali di importare o eliminare i profili (). true/false

`max-connections`  
Numero massimo di connessioni simultanee (numero intero, 1-5).

### Esempi
<a name="cli-cmd-put-preference-examples"></a>

**Esempio: imposta una preferenza **

L'`put-preference`esempio seguente imposta il numero massimo di connessioni. Ciò richiede i privilegi di amministratore. Non viene fornito alcun risultato in merito al successo.

```
sudo aws-vpn-client put-preference --key max-connections --value 4
```

**Esempio: errore senza privilegi di amministratore **

L'`put-preference`esempio seguente mostra l'errore quando si esegue il comando senza privilegi di amministratore.

```
aws-vpn-client put-preference --key max-connections --value 4
```

Output:

```
{
  "status": "Error",
  "message": "Permission denied: admin privileges required"
}
```

**Esempio: errore con un valore non valido **

L'`put-preference`esempio seguente mostra l'errore quando si fornisce un valore non valido.

```
sudo aws-vpn-client put-preference --key max-connections --value 8
```

Output:

```
{
  "status": "Error",
  "message": "Preference value is invalid"
}
```

## list-preferences
<a name="cli-cmd-list-preferences"></a>

### Description
<a name="cli-cmd-list-preferences-description"></a>

Visualizza tutte le preferenze di configurazione globali e i valori correnti.

### Riepilogo
<a name="cli-cmd-list-preferences-synopsis"></a>

```
aws-vpn-client list-preferences
```

### Esempi
<a name="cli-cmd-list-preferences-examples"></a>

**Esempio: elenca tutte le preferenze **

L'`list-preferences`esempio seguente visualizza tutte le preferenze di configurazione globali e i relativi valori correnti.

```
aws-vpn-client list-preferences
```

Output:

```
{
  "enable-telemetry": true,
  "enable-user-profile-management": true,
  "max-connections": 1
}
```

## send-diagnostic-logs
<a name="cli-cmd-send-diagnostic-logs"></a>

### Description
<a name="cli-cmd-send-diagnostic-logs-description"></a>

Raccogli e invia i registri diagnostici a per la risoluzione dei problemi. AWS 

### Riepilogo
<a name="cli-cmd-send-diagnostic-logs-synopsis"></a>

```
aws-vpn-client send-diagnostic-logs
```

### Esempi
<a name="cli-cmd-send-diagnostic-logs-examples"></a>

**Esempio: invio di registri diagnostici **

L'`send-diagnostic-logs`esempio seguente raccoglie e invia i registri diagnostici a. AWS

```
aws-vpn-client send-diagnostic-logs
```

Output:

```
{
  "reference-id": "us-west-2:78ff6531-5dc4-c706-7149-e6cfd8adadc7/2026-07-24-16-03-55.zip"
}
```

**Nota**  
Condividi il `reference-id` valore con l' AWS assistenza quando segnali problemi.

## Codici di uscita
<a name="cli-cmd-exit-codes"></a>

Lo strumento AWS Client VPN CLI restituisce i seguenti codici di uscita.


| Codice di uscita | Significato | 
| --- | --- | 
| 0 | Completato | 
| 1 | Errore generale | 
| 2 | Sintassi del comando non valida |