Schemi Uniform Resource Identifier con il client Desktop remoto per Desktop virtuale Azure
È possibile usare schemi URI (Uniform Resource Identifier) per richiamare il client Desktop remoto con comandi, parametri e valori specifici da usare con Desktop virtuale Azure. Ad esempio, è possibile sottoscrivere un'area di lavoro o connettersi a un determinato desktop o a RemoteApp.
Questo articolo illustra in dettaglio i comandi e i parametri disponibili, insieme ad alcuni esempi.
Client supportati
La tabella seguente elenca i client supportati da usare con gli schemi URI:
| Client | Versione |
|---|---|
| Client Desktop remoto per Windows | 1.2.4065 e versioni successive |
Schemi URI disponibili
Esistono due schemi URI per i client Desktop remoto supportati, ms-avd e ms-rd. Con ms-avd è possibile specificare una determinata risorsa di Desktop virtuale Azure e un utente con cui connettersi. Con ms-rd, è possibile sottoscrivere automaticamente un'area di lavoro nel client Desktop remoto, anziché dover aggiungere manualmente l'area di lavoro.
Le sezioni seguenti illustrano in dettaglio i comandi e i parametri che è possibile usare con ogni schema URI.
ms-avd
Lo schema ms-avd Uniform Resource Identifier per Desktop virtuale Azure è ora disponibile a livello generale. Ecco l'elenco dei comandi attualmente supportati per ms-avd e i relativi parametri corrispondenti.
ms-avd:connect
ms-avd:connect individua una risorsa Desktop virtuale Azure specificata e avvia la sessione RDP, connettendo direttamente un utente specificato a tale risorsa.
Nome comando: connect
Parametri del comando:
| Parametro | Valori | Descrizione |
|---|---|---|
| WorkspaceID | ID oggetto (GUID). | Specificare l'ID oggetto di un'area di lavoro valida. Per ottenere il valore dell'ID oggetto tramite PowerShell, vedere Recuperare l'ID oggetto di un pool di host, un'area di lavoro, un gruppo di applicazioni o un'applicazione. È anche possibile usare le API REST di virtualizzazione desktop. |
| resourceid | ID oggetto (GUID). | Specificare l'ID oggetto di una risorsa pubblicata contenuta nell'area di lavoro. Il valore può essere per un desktop o RemoteApp. Per ottenere il valore dell'ID oggetto tramite PowerShell, vedere Recuperare l'ID oggetto di un pool di host, un'area di lavoro, un gruppo di applicazioni o un'applicazione. È anche possibile usare le API REST di virtualizzazione desktop. |
| utente | Nome entità utente (UPN), ad esempio user@contoso.com. |
Specificare un utente valido con accesso alla risorsa specificata. |
| env (facoltativo) | avdarm (Azure commerciale) usgov (Azure per enti pubblici) |
Specificare il cloud di Azure in cui si trovano le risorse. |
| versione | 0 | Specificare la versione dello schema URI di connessione da usare. |
| launchpartnerid (facoltativo) | GUID. | Specificare l'ID fornito dal partner o dal cliente che è possibile usare con Diagnostica desktop virtuale Azure per facilitare la risoluzione dei problemi. È consigliabile usare un GUID, che è possibile generare con il cmdlet di PowerShell New-Guid . |
| peeractivityid (facoltativo) | GUID. | Specificare l'ID fornito dal partner o dal cliente che è possibile usare con Diagnostica desktop virtuale Azure per facilitare la risoluzione dei problemi. È consigliabile usare un GUID, che è possibile generare con il cmdlet di PowerShell New-Guid . |
| usemultimon | true o false | Specificare se la sessione remota userà uno o più schermi dal computer locale. |
Esempio:
ms-avd:connect?workspaceId=1638e073-63b2-46d8-bd84-ea02ea905467&resourceid=a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1&username=user@contoso.com&version=0
ms-rd
Ecco l'elenco dei comandi attualmente supportati per ms-rd e i relativi parametri corrispondenti.
Suggerimento
L'uso ms-rd: senza comandi avvia il client Desktop remoto.
ms-rd:subscribe
ms-rd:subscribe avvia il client Desktop remoto e avvia il processo di sottoscrizione.
Nome del comando: subscribe
Parametri del comando:
| Parametro | Valori | Descrizione |
|---|---|---|
| URL. | Un URL valido, ad esempio https://rdweb.wvd.microsoft.com. | Specificare un URL dell'area di lavoro. |
Esempio:
ms-rd:subscribe?url=https://rdweb.wvd.microsoft.com
Limitazioni note
Ecco le limitazioni note con gli schemi URI:
- Impossibile configurare le proprietà di visualizzazione tramite URI. È possibile configurare le proprietà di visualizzazione come amministratore in un pool di host o gli utenti finali possono configurare le proprietà di visualizzazione nel client Desktop virtuale Azure.
Passaggi successivi
Informazioni su come connettersi a Desktop virtuale Azure con il client Desktop remoto per Windows.