> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/rdm/de/knowledge-base/knowledge-base-articles/protocol-handler.md).

# Protokoll-Handler

In Remote Desktop Manager wurde ein ***Protokoll-Handler*** implementiert, um eine Sitzung direkt aus HTML-Inhalten starten zu können. Dies kann sehr nützlich sein, um Remote Desktop Manager aus einer Configuration Management Database (CMDB) oder sogar aus einem Document Management System (DMS) aufzurufen.

{% hint style="info" %}
Internet Explorer und Mozilla Firefox führen die URL aus, indem Sie darauf klicken oder <kbd>Enter</kbd> drücken. Bei einigen anderen Webbrowsern wie Google Chrome führt das Ausführen der URL normalerweise zu einer Websuche. Diese Browser erfordern möglicherweise <kbd>Ctrl</kbd>+Klick oder <kbd>Ctrl</kbd>+<kbd>Enter</kbd>, um die URL auszuführen.
{% endhint %}

### Szenarien

Es gibt zwei Möglichkeiten, den Handler zu verwenden:

* Erzeugen einer URL für eine Sitzung: im Grunde jeder Eintragstyp, der sich über ein Protokoll mit einem Remote-Gerät verbindet.
* Erzeugen einer URL für eine Vorlage: ermöglicht es Ihnen, den Hostnamen des Geräts anzugeben, mit dem Sie sich verbinden möchten, verwendet jedoch die Einstellungen der Vorlage.

### Parameter

Hier sind die Parameter, die zum Erstellen einer Protokoll-Handler-URL für fortgeschrittene Szenarien verwendet werden. ***DataSource*** und ***Session IDs*** genügen, um eine Verbindung zu öffnen.

{% hint style="info" %}
Der Parameter ***DataSource*** überschreibt die Datenquelle, mit der sich die Anwendung beim Start verbindet. Dies gilt auch dann, wenn der Benutzer aufgefordert wird, eine Datenquelle zum Verbinden auszuwählen.
{% endhint %}

<table><thead><tr><th width="123.5999755859375">PARAMETER</th><th>BESCHREIBUNG</th></tr></thead><tbody><tr><td>DataSource</td><td>Geben Sie die Datenquellen- oder Datenbank-ID an. Sie finden diese im Abschnitt <em><strong>IDs</strong></em> der <em><strong>Erweiterten Eigenschaften</strong></em> eines Eintrags.<br><br>Eine Datenquellen-ID ist pro Installation eindeutig, wodurch die URL nur von der Arbeitsstation verwendet werden kann, auf der die Datenquelle erstellt wurde. Standardmäßig erzeugt Remote Desktop Manager die URL mit der Datenbank-ID.</td></tr><tr><td>Session</td><td>Geben Sie die ID einer Sitzung an. Sie finden sie im Feld <em><strong>Session ID</strong></em> in den <em><strong>Erweiterten Eigenschaften</strong></em> einer Sitzung.</td></tr><tr><td>Template</td><td>Geben Sie die ID der Vorlage eines Eintrags an. Der Template-Parameter ruft einige Eigenschaften einer Vorlage ab und verwendet sie zusammen mit dem Session-Parameter. Der Host-Parameter ist erforderlich, wenn der Template-Parameter verwendet wird.</td></tr><tr><td>Host</td><td>Geben Sie den Hostnamen oder die IP-Adresse des Remote-Geräts an. Wird zusammen mit dem Template-Parameter verwendet oder um die Host-Eigenschaft des Session-Parameters zu überschreiben.</td></tr><tr><td>Port</td><td>Geben Sie den zu verwendenden Port an. Wird verwendet, um die Port-Eigenschaft des Session- oder Template-Parameters zu überschreiben.</td></tr><tr><td>Username</td><td>Geben Sie den zu verwendenden Benutzernamen an. Wird verwendet, um die Username-Eigenschaft des Session- oder Template-Parameters zu überschreiben.</td></tr><tr><td>Password</td><td>Geben Sie das zu verwendende Passwort an. Wird verwendet, um die Password-Eigenschaft des Session- oder Template-Parameters zu überschreiben.</td></tr><tr><td>Domain</td><td>Geben Sie die zu verwendende Domäne an. Wird verwendet, um die Domain-Eigenschaft des Session- oder Template-Parameters zu überschreiben.</td></tr><tr><td>Title</td><td>Geben Sie den Titel der Registerkarte an, wenn eine Sitzung im Anzeigemodus <em><strong>Eingebettet</strong></em> (mit Registerkarten) gestartet wird. Dies kann sehr nützlich sein, wenn mehrere Sitzungen gleichzeitig gestartet werden.</td></tr><tr><td>Filter</td><td>Füllt das Feld <em><strong>Suche</strong></em> aus.</td></tr><tr><td>Tabpage</td><td>Gibt einer Registerkarte im Dashboard den Fokus, nachdem die Anwendung den Startvorgang abgeschlossen hat. Nur mit der Aktion <em><strong>Select</strong></em> verfügbar. Die möglichen Registerkarten sind:- <em><strong>Überblick</strong></em></td></tr></tbody></table>

* ***Dokumentation***
* ***Makros/Skripte/Werkzeuge***
* ***Verwaltungswerkzeuge***
* ***Informationen***
* ***Anhänge***
* ***Protokolle***
* ***Aufzeichnungen*** |

### Aktionen

* ***Open***: Öffnet die angegebene Verbindung.
* ***Find***: Findet Sitzungen anhand des Hosts.
* ***Edit***: Bearbeitet die angegebene Verbindung.
* ***View***: Zeigt das Passwort des angegebenen Eintrags an.
* ***OpenWithMacro***: Öffnet die angegebene mit einem Makro.
* ***Select***: Wählt eine Verbindung im ***Navigationsbereich*** aus (ermöglicht auch die Auswahl einer Registerkarte im Dashboard).

### Syntax

`rdm://<action>=<value>[&=<value>]`

Die Basissyntax des Protokoll-Handlers erfordert das Anwendungsprotokoll, eine Aktion und mindestens einen Parameter, um zu funktionieren.

Beim Erstellen einer URL für den Protokoll-Handler sind drei Regeln zu beachten:

* Die Aktion wird von den Parametern durch ein Fragezeichen (?) getrennt.
* Jedem Parameter wird über ein Gleichheitszeichen (=) ein Wert zugewiesen.
* Parameter/Wert-Paare werden mit einem Ampersand (&) getrennt.

### Beispiele

**Remote Desktop Manager mit ausgefülltem Such-/Filterfeld und dem Fokus auf dem Dashboard öffnen**

`rdm://open?Filter=RDP&Tabpage=Dashboard`

**Eine RDP-Sitzung öffnen**

1. Klicken Sie im Abschnitt ***Eintragsinformationen*** der Eigenschaften eines Eintrags auf ***Web-URL erstellen***.

   <figure><img src="https://cdnweb.devolutions.net/docs/RDMW2029_2024_1.png" alt=""><figcaption></figcaption></figure>
2. Wählen Sie ***RDM-Protokoll-Handler (rdm://)***.

   <figure><img src="https://cdnweb.devolutions.net/docs/RDMW2030_2024_1.png" alt=""><figcaption></figcaption></figure>
3. Die URL wurde nun in die Zwischenablage kopiert. Klicken Sie auf ***OK***, um das Bestätigungsfenster zu schließen.

   <figure><img src="https://cdnweb.devolutions.net/docs/RDMW2031_2024_1.png" alt=""><figcaption></figcaption></figure>
4. Fügen Sie diese URL (<kbd>Ctrl</kbd>+<kbd>V</kbd>) in eine beliebige Anwendung ein, die Anwendungsprotokolle verarbeiten kann. Das kann eine Webseite, die Adressleiste eines Webbrowsers oder sogar eine unterstützte Chat-Anwendung sein. Der Protokoll-Handler startet Remote Desktop Manager, falls es geschlossen ist, und führt dann die angeforderte Aktion mit den angegebenen Parametern aus.


---

# 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 current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.devolutions.net/rdm/de/knowledge-base/knowledge-base-articles/protocol-handler.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.