

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.

# Amazon DCV-Sitzungen starten
<a name="managing-sessions-start"></a>

Wenn Sie die Standardeinstellungen für die [Installation des Windows Amazon DCV-Servers](setting-up-installing-wininstall.md) verwenden, wird nach der Installation des Servers automatisch eine [Konsolensitzung](managing-sessions-intro.md#managing-sessions-intro-console) erstellt und aktiv. Die Standard-Konsolensitzung ist im Besitz der `Administrator` und hat die Standardsitzungs-ID `console`. Sie können diese Sitzung verwenden oder [sie schließen](managing-sessions-lifecycle-stop.md) und eine neue Sitzung erstellen.

Wenn Sie sich bei der Installation des Amazon DCV-Servers dafür entschieden haben, die automatische Erstellung einer Konsolensitzung zu deaktivieren, müssen Sie eine manuell erstellen. Nachdem Sie den Amazon DCV-Server installiert haben, können Sie die [automatische Erstellung von Konsolensitzungen](#managing-sessions-start-auto) jederzeit aktivieren oder deaktivieren.

**Anmerkung**  
Linux- und macOS-Amazon-DCV-Server erhalten nach der Installation keine Standardkonsolensitzung.

Gehen Sie davon aus, dass Sie eine Floating-Lizenz auf einem lokalen oder alternativen cloudbasierten Server verwenden und die maximale Anzahl gleichzeitiger Sitzungen überschreiten, die von Ihrer Lizenz unterstützt wird. Möglicherweise erhalten Sie eine `no licenses` Fehlermeldung. Wenn Sie diesen Fehler erhalten, beenden Sie eine unbenutzte Sitzung, um die Lizenz freizugeben, und versuchen Sie es erneut.

Der Amazon DCV-Server muss laufen, um eine Sitzung zu starten. Weitere Informationen finden Sie unter [Starten des Amazon DCV-Servers](manage-start.md).

**Topics**
+ [Manuelles Starten von Konsolen- und virtuellen Sitzungen](#managing-sessions-start-manual)
+ [Aktivieren von automatischen Konsolensitzungen](#managing-sessions-start-auto)

## Manuelles Starten von Konsolen- und virtuellen Sitzungen
<a name="managing-sessions-start-manual"></a>

Sie können jederzeit eine Amazon DCV-Sitzung starten. Sie können jeweils nur eine Konsolensitzung gleichzeitig ausführen. Wenn Sie einen Linux-Amazon-DCV-Server verwenden, können Sie mehrere virtuelle Sitzungen gleichzeitig ausführen.

Es empfiehlt sich, das Programm `dcv list-sessions` vor dem Erstellen einer Sitzung auszuführen, insbesondere wenn Sie den Windows Amazon DCV-Server verwenden.

Verwenden Sie den `dcv create-session` Befehl, um eine Konsole oder virtuelle Sitzung auf einem Windows-, Linux- oder macOS-Amazon-DCV-Server zu erstellen.

**Topics**
+ [Syntax](#managing-sessions-start-manual-syntax)
+ [Optionen](#managing-sessions-start-manual-options)
+ [Beispiele](#managing-sessions-start-manual-examples)

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

Die minimale Syntax des Befehls zum Starten einer Sitzung lautet:

```
dcv create-session session_ID
```

Die vollständige Syntax mit allen Optionen lautet:

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

**Anmerkung**  
Das `\` Symbol steht für die Syntax zum Aufteilen eines Befehls in mehrere Zeilen.

Sie können es auch verwenden`dcv create-session --help`, um eine Kurzreferenz zur Syntax anzuzeigen.

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

Für den `dcv create-session`-Befehl können die folgenden Optionen verwendet werden:

**`--type`**  
Diese Option wird nur auf Linux-Amazon-DCV-Servern unterstützt. Sie gibt die Art der Sitzung an, die erstellt werden soll, und kann `console` oder `virtual` sein.  
Typ: Zeichenfolge  
Zulässige Werte: `console` \$1 `virtual`  
Erforderlich: Nein

**`--name`**  
Gibt einen Namen für die Sitzung an. Sitzungsnamen können eine beliebige Zeichenfolge mit bis zu 256 Zeichen sein. Wenn die Zeichenfolge 256 Zeichen überschreitet, schlägt der Befehl fehl. Sitzungsnamen müssen in laufenden Sitzungen nicht eindeutig sein.  
Sie können den Namen einer Sitzung jederzeit mit dem `dcv set-name` Befehl ändern. Weitere Informationen finden Sie unter [Den Sitzungsnamen verwalten](managing-session-name.md).  
Typ: Zeichenfolge  
Erforderlich: Ja

**`--user`**  
Diese Option wird nur für virtuelle Sitzungen auf Linux Amazon DCV-Sitzungen unterstützt. Dieser Wert ist der Benutzer, mit dem die Sitzung erstellt werden soll. Nur der Root-Benutzer kann die Identität anderer Benutzer annehmen.  
Typ: Zeichenfolge  
Erforderlich: Nein

**`--owner`**  
Gibt den Eigentümer der Sitzung an. Standardmäßig ist dies der aktuell angemeldete Benutzer, wenn kein Wert angegeben wird.  
Typ: Zeichenfolge  
Erforderlich: Nein

**`--permissions-file`**  
Gibt den Pfad zu einer benutzerdefinierten Berechtigungsdatei an. Standardmäßig die Server-Standardwerte, falls kein Wert angegeben ist.  
Typ: Zeichenfolge  
Erforderlich: Nein

**`--storage-root`**  
Gibt den Pfad zu dem Ordner an, der als Speicher für die Sitzung verwendet wird.  
Sie können `%home%` verwenden, i, das Startverzeichnis des aktuell angemeldeten Benutzers anzugeben. Im Folgenden wird beispielsweise das Verzeichnis für die Sitzungsspeicherung als `c:\Users\username\storage\` für Windows-Server oder als `$HOME/storage/` für Linux-Server festgelegt.  

```
--storage-root %home%/storage/
```
Wenn ein bestimmtes Unterverzeichnis nicht existiert, ist der Sitzungsspeicher deaktiviert.
Typ: Zeichenfolge  
Erforderlich: Nein

**`--gl`**  
Diese Option wird nur für virtuelle Sitzungen auf Linux Amazon DCV-Sitzungen unterstützt. Sie überschreibt den standardmäßigen Status `on` und kann `dcv-gl` oder `off` sein.  
Typ: Zeichenfolge  
Zulässige Werte: `on` \$1 `off`  
Erforderlich: Nein

**`--max-concurrent-clients`**  
Gibt die maximale Anzahl von Amazon DCV-Clients an, die sich mit der Sitzung verbinden dürfen. Standardmäßig ist dies eine unbegrenzte Anzahl, wenn kein Wert angegeben ist.  
Typ: Ganzzahl  
Erforderlich: Nein

**`--init`**  
Diese Option wird nur bei virtuellen Sitzungen auf Linux-Amazon-DCV-Servern unterstützt. Gibt den Pfad zu einem benutzerdefinierten `init`-Skript an. Das Skript kann verwendet werden, um eine bestimmte Desktop-Umgebung zu starten und bestimmte Anwendungen automatisch zu starten, wenn die Sitzung beginnt. Das Skript muss ausführbar sein. Standardmäßig ein Skript, das die Standard-Desktop-Umgebung startet, wenn kein Wert angegeben ist.  
Typ: Zeichenfolge  
Erforderlich: Nein

**`session ID`**  
Stellt am Ende des Befehls eine ID für Ihre Sitzung bereit.  
Typ: Zeichenfolge  
Erforderlich: Ja

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

**Beispiel 1 – Konsolensitzung**  
`dcv-user`Mit dem folgenden Befehl wird eine Konsolensitzung erstellt`my-session`, deren Eigentümer die eindeutige Sitzungs-ID und der Sitzungsname ist`my graphics session`. Er gibt auch eine Berechtigungsdatei mit dem Namen an`perm-file.txt`.
+ Windows Amazon DCV-Server

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

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

**Beispiel 2 — Virtuelle Sitzung (nur Linux Amazon DCV-Server)**  
Der folgende Befehl erstellt eine virtuelle Sitzung, bei der der Root-Benutzer die Identität des beabsichtigten Sitzungsbesitzers annimmt. `dcv-user` Die Sitzung gehört dem Root-Benutzer, `dcv-user` obwohl sie vom Root-Benutzer erstellt wurde

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

**Beispiel 3 — Virtuelle Sitzung (nur Linux Amazon DCV-Server)**  
Der folgende Befehl erstellt eine virtuelle Sitzung, die dem Benutzer gehört, der sie erstellt hat:

```
$ dcv create-session my-session
```

## Aktivieren von automatischen Konsolensitzungen
<a name="managing-sessions-start-auto"></a>

Durch die Aktivierung einer automatischen Konsolensitzung wird sichergestellt, dass bei jedem Start des Amazon DCV-Servers automatisch eine Konsolensitzung erstellt wird. Die automatische Konsolensitzung gehört dem Amazon DCV-Benutzer, der im `owner` Konfigurationsparameter angegeben ist. Die Sitzungs-ID ist stets `console`.

Auswirkungen auf automatische Konsolensitzungen haben darüber hinaus auch die Parameter `max-concurrent-clients`, `permissions-file` und `storage-root`. Weitere Informationen zu diesen Parametern finden Sie unter [`session-management/automatic-console-session`-Parameter](config-param-ref.md#session_management_automatic_console_session).

**Anmerkung**  
Amazon DCV unterstützt keine automatischen virtuellen Sitzungen.

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

**Um eine automatische Konsolensitzung auf einem Windows Amazon DCV-Server zu aktivieren**

1. Öffnen Sie den Windows Registrierungs-Editor.

1. Navigieren Sie zum **Schlüssel HKEY\$1USERS\$1 S-1-5-18\$1 Software\$1\$1 com\$1nicesoftware\$1 dcvGSettings\$1 session-management**.

1. Erstellen Sie einen `create-session`-Parameter:

   1. ******Öffnen Sie im Navigationsbereich das Kontextmenü (Rechtsklick) für den Sitzungsverwaltungsschlüssel und wählen Sie Neu, DWORD-Wert (32-Bit).******

   1. Geben Sie in **Name (Name)** `create-session` ein und drücken Sie die **Eingabetaste**.

   1. Öffnen Sie den Parameter **create-session (Sitzung erstellen)**. Geben Sie in **Value data (Wertdaten)** `1` ein. Wählen Sie anschließend **OK** aus.

1. Navigieren Sie zum **Schlüssel HKEY\$1USERS\$1 S-1-5-18\$1 Software\$1\$1 com\$1nicesoftware\$1 dcvGSettings\$1 session-management/**. automatic-console-session

1. Erstellen Sie einen `owner`-Parameter:

   1. ****Öffnen Sie im Navigationsbereich das Kontextmenü (Rechtsklick) für den Schlüssel und wählen Sie Neu, Zeichenkettenwert. **automatic-console-session******

   1. Geben Sie in **Name (Name)** `owner` ein und drücken Sie die **Eingabetaste**.

   1. Öffnen Sie den **owner**-Parameter. Geben Sie in **Value data (Wertdaten)** den Namen des Sitzungsbesitzers ein und wählen Sie **OK** aus.

1. Klicken Sie auf **OK** und schließen Sie den Windows Registrierungs-Editor.

1. [Stoppen](manage-stop.md) [Sie den Amazon DCV-Server und starten Sie](manage-start.md) ihn neu.

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

**So aktivieren Sie eine automatische Konsolensitzung auf einem Linux-Amazon-DCV-Server**

1. Gehen Sie zu `/etc/dcv/` und öffnen Sie die `dcv.conf`-Datei mit Ihrem bevorzugten Texteditor.

1. Fügen Sie die Parameter `create-session` und `owner` dem Abschnitt `[session-management/automatic-console-session]` hinzu und verwenden Sie dazu das folgende Format:

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

1. Speichern und schließen Sie die Datei.

1. [Stoppen](manage-stop.md) [Sie den Amazon DCV-Server und starten Sie](manage-start.md) ihn neu.

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

**Um eine automatische Konsolensitzung auf einem macOS Amazon DCV-Server zu aktivieren**

1. Gehen Sie zu `/etc/dcv/` und öffnen Sie die `dcv.conf`-Datei mit Ihrem bevorzugten Texteditor.

1. Fügen Sie die Parameter `create-session` und `owner` dem Abschnitt `[session-management/automatic-console-session]` hinzu und verwenden Sie dazu das folgende Format:

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

1. Speichern und schließen Sie die Datei.

1. [Stoppen](manage-stop.md) [Sie den Amazon DCV-Server und starten Sie](manage-start.md) ihn neu.

------