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

# Gestore di protocollo

In Remote Desktop Manager è stato implementato un ***Gestore di protocollo*** per poter avviare una sessione direttamente da contenuto HTML. Questo può essere molto utile per richiamare Remote Desktop Manager da un Configuration Management Database (CMDB) o anche da un Document Management System (DMS).

{% hint style="info" %}
Internet Explorer e Mozilla Firefox eseguono l'URL facendo clic su di esso o premendo <kbd>Enter</kbd>. Tuttavia, con alcuni altri browser web come Google Chrome, l'esecuzione dell'URL normalmente produce una ricerca web. Questi browser possono richiedere di fare <kbd>Ctrl</kbd>+clic o <kbd>Ctrl</kbd>+<kbd>Enter</kbd> per eseguire l'URL.
{% endhint %}

### Scenari

Esistono due modi per utilizzare il gestore:

* Generare un URL per una sessione: fondamentalmente ogni tipo di voce che si connette a un dispositivo remoto utilizzando un protocollo.
* Generare un URL per un modello: consente di specificare il nome host del dispositivo a cui desidera connettersi, ma utilizza le impostazioni del modello.

### Parametri

Ecco i parametri utilizzati per costruire un URL del gestore di protocollo per scenari avanzati. ***DataSource*** e ***Session IDs*** sono sufficienti per aprire una connessione.

{% hint style="info" %}
Il parametro ***DataSource*** sovrascrive lo spazio di lavoro a cui l'applicazione si connette all'avvio. Questo vale anche se all'utente viene richiesto di scegliere uno spazio di lavoro a cui connettersi..
{% endhint %}

<table><thead><tr><th width="123.5999755859375">PARAMETRO</th><th>DESCRIZIONE</th></tr></thead><tbody><tr><td>DataSource</td><td>Indichi l'ID dello spazio di lavoro o del database. Li trova nella sezione <em><strong>IDs</strong></em> delle <em><strong>Proprietà avanzate</strong></em> di una voce.<br><br>Un ID dello spazio di lavoro è univoco per installazione, il che rende l'URL utilizzabile solo dalla postazione di lavoro in cui lo spazio di lavoro è stato creato. Per impostazione predefinita, Remote Desktop Manager genera l'URL con l'ID del database.</td></tr><tr><td>Session</td><td>Indichi l'ID di una sessione. Lo trova nel campo <em><strong>Session ID</strong></em> nelle <em><strong>Proprietà avanzate</strong></em> di una sessione.</td></tr><tr><td>Template</td><td>Indichi l'ID del modello di una voce. Il parametro template recupera alcune proprietà di un modello e le utilizza con il parametro session. Il parametro host è obbligatorio quando si utilizza il parametro template.</td></tr><tr><td>Host</td><td>Indichi il nome host o l'indirizzo IP del dispositivo remoto. Utilizzato insieme al parametro template, o per sovrascrivere la proprietà host del parametro session.</td></tr><tr><td>Port</td><td>Indichi la porta da utilizzare. Utilizzato per sovrascrivere la proprietà port del parametro session o template.</td></tr><tr><td>Username</td><td>Indichi il nome utente da utilizzare. Utilizzato per sovrascrivere la proprietà username del parametro session o template.</td></tr><tr><td>Password</td><td>Indichi la password da utilizzare. Utilizzato per sovrascrivere la proprietà password del parametro session o template.</td></tr><tr><td>Domain</td><td>Indichi il dominio da utilizzare. Utilizzato per sovrascrivere la proprietà domain del parametro session o template.</td></tr><tr><td>Title</td><td>Indichi il titolo della scheda quando una sessione viene avviata utilizzando la modalità di visualizzazione <em><strong>Embedded</strong></em> (a schede). Questo può essere molto utile quando vengono avviate più sessioni contemporaneamente.</td></tr><tr><td>Filter</td><td>Popola il campo <em><strong>Cerca</strong></em>.</td></tr><tr><td>Tabpage</td><td>Dà il focus a una scheda nella dashboard dopo che l'applicazione ha completato la procedura di avvio. Disponibile solo con l'azione <em><strong>Select</strong></em>. Le schede possibili sono:- <em><strong>Panoramica</strong></em></td></tr></tbody></table>

* ***Documentazione***
* ***Macro/Script/Strumenti***
* ***Strumenti di gestione***
* ***Informazioni***
* ***Allegati***
* ***Log***
* ***Registrazioni*** |

### Azioni

* ***Open***: Apre la connessione specificata.
* ***Find***: Trova sessioni per host.
* ***Edit***: Modifica la connessione specificata.
* ***View***: Visualizza la password della voce specificata.
* ***OpenWithMacro***: Apre la specificata con una macro.
* ***Select***: Seleziona una connessione nel ***riquadro di navigazione*** (consente anche di selezionare una scheda nella dashboard).

### Sintassi

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

La sintassi di base del gestore di protocollo richiede il protocollo dell'applicazione, un'azione e almeno un parametro per funzionare.

Ci sono tre regole da seguire nella costruzione di un URL per il gestore di protocollo:

* L'azione è separata dai parametri da un punto interrogativo (?).
* A ogni parametro viene assegnato un valore utilizzando un segno di uguale (=).
* Le coppie parametro/valore sono separate da una e commerciale (&).

### Esempi

**Aprire Remote Desktop Manager con il campo di ricerca/filtro popolato e il focus sulla Dashboard**

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

**Aprire una sessione RDP**

1. Nella sezione ***Informazioni voce*** delle proprietà di una voce, clicchi su ***Crea URL web***.

   <figure><img src="https://cdnweb.devolutions.net/docs/RDMW2029_2024_1.png" alt=""><figcaption></figcaption></figure>
2. Selezioni ***Gestore di protocollo RDM (rdm://)***.

   <figure><img src="https://cdnweb.devolutions.net/docs/RDMW2030_2024_1.png" alt=""><figcaption></figcaption></figure>
3. L'URL è ora stato copiato negli appunti. Clicchi su ***OK*** per chiudere la finestra di conferma.

   <figure><img src="https://cdnweb.devolutions.net/docs/RDMW2031_2024_1.png" alt=""><figcaption></figcaption></figure>
4. Incolli (<kbd>Ctrl</kbd>+<kbd>V</kbd>) questo URL in qualsiasi applicazione in grado di gestire i protocolli applicativi. Può essere in una pagina web, nella barra degli indirizzi di un browser web o anche in un'applicazione di chat supportata. Il gestore di protocollo avvia Remote Desktop Manager se è chiuso, quindi esegue l'azione richiesta con i parametri forniti.


---

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