> 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

Utilizzi il gestore di protocollo di Remote Desktop Manager per avviare sessioni da collegamenti HTML con parametri per origine dati, host, credenziali e azioni.

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***.
2. Selezioni ***Gestore di protocollo RDM (rdm://)***.
3. L'URL è ora stato copiato negli appunti. Clicchi su ***OK*** per chiudere la finestra di conferma.
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 by asking a question.

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

```
GET https://docs.devolutions.net/rdm/it/knowledge-base/knowledge-base-articles/protocol-handler.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 `automate deployments from our CI pipeline` 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.