> For the complete documentation index, see [llms.txt](https://docs.pascom.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pascom.net/operations/clients/thin-client-shared-workstation-mode.md).

# RDP - und Thin-Client-Betrieb im Shared Workstation Modus

Einrichten der PASCOM App für gemeinsam genutzte Arbeitsplätze (z. B. DATEV) in Terminalserver-Umgebungen.

In modernen Terminalserver-Umgebungen (wie z. B. bei DATEV-Arbeitsplätzen) teilen sich oft mehrere Mitarbeiter physische Thin-Clients mit einer automatischen Anmeldung. Um eine nahtlose Telefonie- und App-Steuerung zu ermöglichen, unterstützt die PASCOM App den **Shared Workstation Modus**.

Hierbei läuft eine lokale Instanz der PASCOM App auf dem Thin-Client im Hintergrund (Wartemodus) und wird automatisch von der PASCOM App innerhalb der RDP-Sitzung (Remote Desktop) des jeweiligen Benutzers übernommen.

{% hint style="info" %}
**Vorteile dieser Lösung:**

* **Lizenzierung:** Lokale Thin-Clients im Wartemodus belegen keine Concurrent-User-Lizenzen (CU).
* **Datenschutz:** Nach Beenden der RDP-Sitzung kehrt die lokale PASCOM App automatisch in den gesperrten Wartemodus zurück. Andere Benutzer können somit nicht versehentlich Chats oder Anruflisten einsehen.
  {% endhint %}

## Voraussetzungen

1. **Technischer PASCOM Benutzer:** Für den Shared Workstation Modus wird ein Benutzeraccount auf der PASCOM Telefonanlage benötigt, unter dem sich die lokale PASCOM App auf dem Thin-Client anmeldet.
   * Sie können hierfür zwar jeden regulären Benutzer verwenden, es wird jedoch empfohlen, einen **speziellen technischen Benutzer** (z. B. `thinclient`) anzulegen.
   * *Tipp:* Diesen technischen Benutzer können Sie über die [Rollen und Berechtigungen](/setup/user/role.md) in den Kontaktlisten ausblenden.
2. **Lokale Installation:** Installieren Sie die PASCOM Desktop App Preview auf dem Thin-Client. - [Hier Herunterladen](/reference/downloads.md#pascom-app-preview)
3. **Remote-Desktop Installation:** Installieren Sie die PASCOM Desktop App auf dem Terminalserver. - [Hier Herunterladen](/reference/downloads.md#pascom-app)

## Lokalen Thin-Client konfigurieren und starten

Um die lokale PASCOM Desktop App Preview auf dem Thin-Client im Wartemodus zu starten, führen Sie folgende Schritte aus:

{% hint style="warning" %}
Installieren Sie auf der lokalen Maschine nicht die reguläre PASCOM Desktop App, sondern die **PASCOM Desktop App Preview**.
{% endhint %}

1. Starten Sie die PASCOM Desktop App auf dem Thin-Client mit dem Parameter `--thinclient` oder setzen Sie die Windows-Systemumgebungsvariable `PC_THINCLIENT_WORKSTATION=1`.
2. Melden Sie sich in der lokalen App mit dem zuvor erstellten Benutzer `thinclient` an.
3. Nach erfolgreicher Anmeldung wechselt die PASCOM Desktop App Preview in den **Wartemodus** (eine entsprechende Wartemeldung wird angezeigt).

## Remote-Desktop-Sitzung (RDP) starten und App steuern

Sobald der lokale Thin-Client betriebsbereit im Wartemodus ist, kann sich der Endanwender auf dem Terminalserver anmelden:

1. Starten Sie die RDP-Sitzung zum Terminalserver.
2. Starten Sie die PASCOM DesktopApp innerhalb der RDP-Sitzung auf dem Terminalserver.
3. Melden Sie sich mit Ihrem persönlichen PASCOM Benutzerkonto (z. B. `mmustermann`) an.
4. Der lokale Thin-Client auf Ihrer physischen Maschine erkennt die Verbindung und übernimmt vollautomatisch die Identität und Oberfläche Ihres persönlichen Benutzers.

Die PASCOM Desktop App auf dem Terminalserver läuft nun in einem RDP-Modus und synchronisiert sich automatisch mit dem lokalen Thin-Client in Echtzeit. Sie können nun wie gewohnt Telefonie, Chat und alle weiteren PASCOM Funktionen sowohl innerhalb der RDP-Sitzung als auch über das lokale Headset/Telefon des Thin-Clients nutzen.

Der RDP-Modus ist standardmäßig aktiviert, wenn die PASCOM Desktop App eine Terminalsitzung erkennt. Daher muss auf einer Serverumgebung keine umständliche Konfiguration vorgenommen werden. Sie kann jedoch bei Bedarf mit Umgebungsvariablen aktiviert oder deaktiviert werden.

![RDP SPLIT MODE](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-90ed1085e0c46e1be02a7beb3b44d9366cb86ec8%2Frdp-split-mode.png?alt=media)

#### Was bewirkt der RDP-Modus?

* Bessere Audioqualität, da das Audio nicht in die RDP-Sitzung übertragen werden muss.
* Headsetsteuerung (z. B. Annehmen über Taste am Headset) funktioniert dadurch.
* Integrationen in Software die auf einem Terminal-Server läuft (z. B. Outlook, DATEV) funktioniert weiterhin.
* Weniger CPU-Last auf Terminal-Servern, da Audio und Video über die App auf dem jeweiligen Endgerät enkodiert und dekodiert werden.
* Anrufsteuerung ist über jede App vollständig möglich.

Das Feature funktioniert plattformübergreifend (Windows, macOS, Linux) und ist nicht auf Terminalserver RDP-Sitzungen beschränkt.

## Sitzung beenden

Wenn Sie Ihren Arbeitstag beenden oder sich vom Terminalserver abmelden:

1. Schließen Sie die PASCOM Desktop App in Ihrer RDP-Sitzung oder melden Sie sich vom Terminalserver ab.
2. Der lokale Thin-Client mit der PASCOM Desktop App Preview auf dem physischen Arbeitsplatz wechselt sofort wieder zurück in den gesperrten **Wartemodus** und wartet auf die nächste Verbindung.

## Hostnamen-Abgleich für automatische Zuordnung

Damit die PASCOM Desktop App in der RDP-Sitzung den lokalen Thin-Client automatisch finden und steuern kann, müssen die Hostnamen übereinstimmen. Die Zuweisung erfolgt im Hintergrund über den Computernamen (Hostnamen) der lokalen Maschine, den der Terminalserver als Client-Name ausliest.

Sollte die Verbindung nicht automatisch hergestellt werden, prüfen Sie bitte folgende Werte:

1. **In der RDP-Sitzung (Terminalserver):** Öffnen Sie die Eingabeaufforderung (CMD) oder PowerShell und geben Sie folgenden Befehl ein:

   **Eingabeaufforderung (CMD):**

   ```cmd
   echo %CLIENTNAME%
   ```

   *Beispiel-Ausgabe:* `MM-THINKPAD22`

   **PowerShell:**

   ```powershell
   Write-Output $env:CLIENTNAME
   ```

   *Beispiel-Ausgabe:* `MM-THINKPAD22`
2. **Auf dem lokalen Thin-Client:** Öffnen Sie auf der lokalen Maschine die Eingabeaufforderung (CMD) und geben Sie folgenden Befehl ein:

   ```cmd
   hostname
   ```

   *Beispiel-Ausgabe:* `mm-thinkpad22`

Die Groß- und Kleinschreibung wird beim Abgleich automatisch ignoriert. Wichtig ist jedoch, dass die ausgelesenen Namen inhaltlich exakt übereinstimmen.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.pascom.net/operations/clients/thin-client-shared-workstation-mode.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
