> 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/fr/knowledge-base/knowledge-base-articles/protocol-handler.md).

# Gestionnaire de protocole

Un ***Gestionnaire de protocole*** a été implémenté dans Remote Desktop Manager afin de pouvoir lancer une session directement à partir de contenu HTML. Cela peut être très utile pour appeler Remote Desktop Manager depuis une base de données de gestion de configuration (CMDB) ou même un système de gestion documentaire (DMS).

{% hint style="info" %}
Internet Explorer et Mozilla Firefox exécutent l'URL en cliquant dessus ou en appuyant sur <kbd>Enter</kbd>. Cependant, avec certains autres navigateurs web comme Google Chrome, l'exécution de l'URL entraîne normalement une recherche web. Ces navigateurs peuvent nécessiter de faire <kbd>Ctrl</kbd>+clic ou <kbd>Ctrl</kbd>+<kbd>Enter</kbd> pour exécuter l'URL.
{% endhint %}

### Scénarios

Il y a deux façons d'utiliser le gestionnaire :

* Générer une URL pour une session : essentiellement tout type d'entrée qui se connecte à un appareil distant à l'aide d'un protocole.
* Générer une URL pour un modèle : permet de spécifier le nom d'hôte de l'appareil auquel vous souhaitez vous connecter, tout en utilisant les paramètres du modèle.

### Paramètres

Voici les paramètres utilisés pour construire une URL de gestionnaire de protocole pour des scénarios avancés. Les ***DataSource*** et ***ID de session*** suffisent pour ouvrir une connexion.

{% hint style="info" %}
Le paramètre ***DataSource*** remplace l'espace de travail auquel l'application se connecte au démarrage. Cela s'applique même si l'utilisateur est invité à choisir un espace de travail auquel se connecter..
{% endhint %}

<table><thead><tr><th width="123.5999755859375">PARAMÈTRE</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td>DataSource</td><td>Indiquez l'ID de l'espace de travail ou de la base de données. Vous les trouverez dans la section <em><strong>IDs</strong></em> des <em><strong>Propriétés avancées</strong></em> d'une entrée.<br><br>Un ID d'espace de travail est unique par installation, ce qui rend l'URL utilisable uniquement par le poste de travail où l'espace de travail a été créé. Par défaut, Remote Desktop Manager génère l'URL avec l'ID de la base de données.</td></tr><tr><td>Session</td><td>Indiquez l'ID d'une session. Vous le trouverez dans le champ <em><strong>ID de session</strong></em> des <em><strong>Propriétés avancées</strong></em> d'une session.</td></tr><tr><td>Template</td><td>Indiquez l'ID du modèle d'une entrée. Le paramètre template récupère certaines propriétés d'un modèle et les applique au paramètre session. Le paramètre host est requis lors de l'utilisation du paramètre template.</td></tr><tr><td>Host</td><td>Indiquez le nom d'hôte ou l'adresse IP de l'appareil distant. Utilisé avec le paramètre template, ou pour remplacer la propriété host du paramètre session.</td></tr><tr><td>Port</td><td>Indiquez le port à utiliser. Utilisé pour remplacer la propriété port du paramètre session ou template.</td></tr><tr><td>Username</td><td>Indiquez le nom d'utilisateur à utiliser. Utilisé pour remplacer la propriété username du paramètre session ou template.</td></tr><tr><td>Password</td><td>Indiquez le mot de passe à utiliser. Utilisé pour remplacer la propriété password du paramètre session ou template.</td></tr><tr><td>Domain</td><td>Indiquez le domaine à utiliser. Utilisé pour remplacer la propriété domain du paramètre session ou template.</td></tr><tr><td>Title</td><td>Indiquez le titre de l'onglet lorsqu'une session est lancée avec le mode d'affichage <em><strong>Intégré</strong></em> (par onglets). Cela peut être très utile lorsque plusieurs sessions sont lancées en même temps.</td></tr><tr><td>Filter</td><td>Remplissez le champ <em><strong>Recherche</strong></em>.</td></tr><tr><td>Tabpage</td><td>Donne le focus à un onglet du tableau de bord après que l'application a terminé sa procédure de démarrage. Disponible uniquement avec l'action <em><strong>Select</strong></em>. Les onglets possibles sont :- <em><strong>Vue d'ensemble</strong></em></td></tr></tbody></table>

* ***Documentation***
* ***Macros/Scripts/Outils***
* ***Outils de gestion***
* ***Informations***
* ***Pièces jointes***
* ***Journaux***
* ***Enregistrements*** |

### Actions

* ***Open*** : Ouvrir la connexion spécifiée.
* ***Find*** : Trouver des sessions par hôte.
* ***Edit*** : Modifier la connexion spécifiée.
* ***View*** : Afficher le mot de passe de l'entrée spécifiée.
* ***OpenWithMacro*** : Ouvrir la connexion spécifiée avec une macro.
* ***Select*** : Sélectionner une connexion dans le ***volet de navigation*** (permet également de sélectionner un onglet dans le tableau de bord).

### Syntaxe

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

La syntaxe de base du gestionnaire de protocole nécessite le protocole d'application, une action et au moins un paramètre pour fonctionner.

Il y a trois règles à suivre lors de la construction d'une URL pour le gestionnaire de protocole :

* L'action est séparée des paramètres par un point d'interrogation (?).
* Chaque paramètre reçoit une valeur à l'aide d'un signe égal (=).
* Les paires paramètre/valeur sont séparées par une esperluette (&).

### Exemples

**Ouvrir Remote Desktop Manager avec le champ de recherche/filtre rempli et le focus sur le tableau de bord**

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

**Ouvrir une session RDP**

1. Dans la section ***Informations sur l'entrée*** des propriétés d'une entrée, cliquez sur ***Créer une URL Web***.

   <figure><img src="https://cdnweb.devolutions.net/docs/RDMW2029_2024_1.png" alt=""><figcaption></figcaption></figure>
2. Sélectionnez ***Gestionnaire de protocole RDM (rdm://)***.

   <figure><img src="https://cdnweb.devolutions.net/docs/RDMW2030_2024_1.png" alt=""><figcaption></figcaption></figure>
3. L'URL a maintenant été copiée dans le presse-papiers. Cliquez sur ***OK*** pour fermer la fenêtre de confirmation.

   <figure><img src="https://cdnweb.devolutions.net/docs/RDMW2031_2024_1.png" alt=""><figcaption></figcaption></figure>
4. Collez (<kbd>Ctrl</kbd>+<kbd>V</kbd>) cette URL dans toute application capable de gérer les protocoles d'application. Cela peut être dans une page web, dans la barre d'adresse d'un navigateur web, ou même dans une application de clavardage prise en charge. Le gestionnaire de protocole lance Remote Desktop Manager s'il est fermé, puis effectue l'action demandée avec les paramètres fournis.


---

# 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/fr/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.