Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# CLI-Befehlssyntax
<a name="cli-command-syntax"></a>

Sie können CLI-Befehle verwenden, indem Sie die folgende Syntax verwenden:

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

Das CLI-Tool unterstützt die folgenden Befehle.

```
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>

Stellen Sie eine VPN-Verbindung zu einem Profil her.

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

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

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

`--profile-name` (string)  
Der Name des Profils, mit dem eine Verbindung hergestellt werden soll. Diese Option ist erforderlich.

`--auth-user-pass` (string)  
Pfad zu einer Datei, die den Benutzernamen (Zeile 1), das Passwort (Zeile 2) und den optionalen MFA-Code (Zeile 3) enthält. Diese Option ist nicht erforderlich.

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

**Beispiel: Stellen Sie eine Verbindung zu einem VPN-Profil her **

Das folgende `connect` Beispiel stellt eine VPN-Verbindung zu einem Profil her.

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

Ausgabe:

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

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

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

Beenden Sie eine aktive VPN-Verbindung.

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

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

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

`--profile-name` (string)  
Der Name des verbundenen Profils, das getrennt werden soll. Diese Option ist erforderlich.

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

**Beispiel: Trennen Sie die Verbindung zu einem VPN-Profil **

Das folgende `disconnect` Beispiel beendet eine VPN-Verbindung. Bei Erfolg gibt es keine Ausgabe.

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

**Beispiel: Fehler beim Trennen **

Das folgende `disconnect` Beispiel zeigt den Fehler, wenn das Profil nicht verbunden ist.

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

Ausgabe:

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

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

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

Importieren Sie ein VPN-Verbindungsprofil.

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

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

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

`--profile-name` (string)  
Benutzerdefinierter Name für das importierte Profil. Diese Option ist erforderlich.

`--config-path` (string)  
Pfad zur OpenVPN-Konfigurationsdatei (.ovpn). Diese Option ist erforderlich.

`--global`(boolesch)  
Import als globales Profil, das allen Benutzern zur Verfügung steht. Für diese Option sind Administratorrechte erforderlich.

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

**Beispiel: Ein Profil importieren **

Das folgende `import-profile` Beispiel importiert ein VPN-Verbindungsprofil.

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

Ausgabe:

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

**Beispiel: Importieren Sie ein globales Profil **

Das folgende `import-profile` Beispiel importiert ein globales Profil. Dies erfordert Administratorrechte.

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

Ausgabe:

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

**Beispiel: Importfehler mit ungültigem Dateipfad **

Das folgende `import-profile` Beispiel zeigt den Fehler, wenn die Konfigurationsdatei nicht gefunden wird.

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

Ausgabe:

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

## Profil löschen
<a name="cli-cmd-delete-profile"></a>

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

Löscht ein Profil vom Client.

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

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

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

`--profile-name` (string)  
Der Name des Profils, das gelöscht werden soll. Diese Option ist erforderlich.

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

**Beispiel: Löschen Sie ein Profil **

Das folgende `delete-profile` Beispiel löscht ein VPN-Profil. Bei Erfolg erfolgt keine Ausgabe.

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

**Beispiel: Fehler beim Löschen mit einem nicht existierenden Profil **

Das folgende `delete-profile` Beispiel zeigt den Fehler, wenn das Profil nicht existiert.

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

Ausgabe:

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

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

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

Listet alle VPN-Profile auf.

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

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

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

**Beispiel: Alle VPN-Profile auflisten **

Das folgende `list-profiles` Beispiel listet alle importierten VPN-Profile auf.

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

Ausgabe:

```
[
  {
    "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"
  }
]
```

**Anmerkung**  
Globale Profile (importiert mit`--global`) haben kein `owned-by` Feld.

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

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

Ruft die OpenVPN-Konfiguration für ein Profil ab.

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

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

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

`--profile-name` (string)  
Der Name des Profils, für das die Konfiguration abgerufen werden soll. Diese Option ist erforderlich.

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

**Beispiel: Rufen Sie die OpenVPN-Konfiguration ab **

Das folgende `get-config` Beispiel ruft die OpenVPN-Konfiguration für ein Profil ab.

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

Ausgabe:

```
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>

Ruft den aktuellen Verbindungsstatus für ein VPN-Profil ab.

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

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

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

`--profile-name` (string)  
Der Name des Profils, für das der Verbindungsstatus abgerufen werden soll. Diese Option ist erforderlich.

`--show-details`(boolesch)  
Schließt Verbindungsbyte-Statistiken in die Ausgabe ein.

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

**Beispiel: Verbindungsstatus abrufen **

Das folgende `get-connection-status` Beispiel ruft den Verbindungsstatus für ein Profil ab.

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

Ausgabe:

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

**Beispiel: Verbindungsstatus mit Details abrufen **

Das folgende `get-connection-status` Beispiel beinhaltet Byte-Statistiken mithilfe der `--show-details` Option.

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

Ausgabe:

```
{
  "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
    }
  }
}
```

## Verbindungen auflisten
<a name="cli-cmd-list-connections"></a>

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

Listet alle aktiven VPN-Verbindungen auf.

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

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

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

**Beispiel: Listet aktive Verbindungen auf **

Das folgende `list-connections` Beispiel listet alle aktiven VPN-Verbindungen auf.

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

Ausgabe:

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

**Beispiel: Keine aktiven Verbindungen **

Das folgende `list-connections` Beispiel zeigt die Ausgabe, wenn keine aktiven Verbindungen bestehen.

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

Ausgabe:

```
[]
```

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

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

Legen Sie eine globale Konfigurationspräferenz fest. Für die meisten Einstellungen sind Administratorrechte erforderlich.

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

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

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

`--key` (string)  
Der Name des Einstellungsschlüssels, der festgelegt werden soll. Diese Option ist erforderlich.

`--value` (string)  
Der Wert, der für den Einstellungsschlüssel festgelegt werden soll. Diese Option ist erforderlich.

Die folgenden Einstellungsschlüssel sind verfügbar:

`enable-telemetry`  
Aktiviert oder deaktiviert Telemetrie (true/false).

`enable-user-profile-management`  
Erlauben oder verbieten Sie Endbenutzern das Importieren oder Löschen von Profilen ()true/false.

`max-connections`  
Maximale Anzahl gleichzeitiger Verbindungen (Ganzzahl, 1-5).

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

**Beispiel: Legen Sie eine Präferenz fest **

Im folgenden `put-preference` Beispiel wird die maximale Anzahl von Verbindungen festgelegt. Dies erfordert Administratorrechte. Bei Erfolg gibt es keine Ausgabe.

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

**Beispiel: Fehler ohne Administratorrechte **

Das folgende `put-preference` Beispiel zeigt den Fehler, wenn Sie den Befehl ohne Administratorrechte ausführen.

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

Ausgabe:

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

**Beispiel: Fehler mit ungültigem Wert **

Das folgende `put-preference` Beispiel zeigt den Fehler, wenn Sie einen ungültigen Wert angeben.

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

Ausgabe:

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

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

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

Zeigt alle globalen Konfigurationseinstellungen und aktuellen Werte an.

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

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

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

**Beispiel: Alle Einstellungen auflisten **

Im folgenden `list-preferences` Beispiel werden alle globalen Konfigurationseinstellungen und ihre aktuellen Werte angezeigt.

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

Ausgabe:

```
{
  "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>

Sammeln Sie Diagnoseprotokolle und senden Sie sie zur Problembehandlung an. AWS 

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

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

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

**Beispiel: Diagnoseprotokolle senden **

Im folgenden `send-diagnostic-logs` Beispiel werden Diagnoseprotokolle gesammelt und an AWS diese gesendet.

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

Ausgabe:

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

**Anmerkung**  
Teilen Sie dem AWS Support den `reference-id` Wert mit, wenn Sie Probleme melden.

## Ausgangscodes
<a name="cli-cmd-exit-codes"></a>

Das AWS Client VPN CLI-Tool gibt die folgenden Exit-Codes zurück.


| Beendigungscode | Bedeutung | 
| --- | --- | 
| 0 | Success | 
| 1 | Allgemeiner Fehler | 
| 2 | Ungültige Befehlssyntax |