Remote Support lets you provide attended or unattended remote assistance to AVD session hosts, Windows 365 Cloud PCs, and Intune-managed Windows devices from Nerdio Manager. Remote Support runs in your own Azure subscription. This article describes how to enable Remote Support, choose the host pools, policies, and device groups that use it, verify the installation, and turn the Toolbox on or off. It also describes the permissions that you need. For the requirements, sizes, and architecture, see Remote Support: overview and deployment.
Note
Remote Support is in Private Preview.
Before you can use Remote Support, you enable it. Enabling Remote Support deploys the Remote Support server and its supporting resources in your own Azure subscription, and uses its own App Service Plan, in addition to the one that Nerdio Manager uses.
-
Navigate to System > Settings > Nerdio, and then expand the Remote Support section. The section is shown only when Nerdio has enabled Remote Support for your installation. Your role needs the Remote Support deployment and settings permissions, and Settings full access. See Permissions later in this article.
-
Open the Enable Remote Support dialog box from this section.
-
From the Total number of endpoints list, select the number of endpoints that you plan to support. It is preselected to 1 to 1,999. The dialog box lists the App Service Plan SKU, the Postgres server SKU, and an estimated monthly cost. For the sizes, see Remote Support: overview and deployment.
-
Optionally, expand Customize resources. Select the Resource group for the new resources. For each of App Service, App Service Plan, Key Vault, Application Insights, Log Analytics Workspace, and Postgres server, the default is to create a new resource. You can instead select an existing one. An existing App Service must have a system-assigned managed identity and no previous deployments. An existing Application Insights resource must be workspace-based.
-
Optionally, expand Customize resources names, and then enter your own names for the App service, App service plan, Key vault, App insights, Workspace, Postgres server, and Postgres database. If you leave a name empty, the default name is used. The defaults follow the pattern
nmw-rs-app-{random postfix}, and the Postgres database name defaults toremote_support. -
Optionally, expand Customize resources tags to apply Azure tags to the new resources.
-
Optionally, turn on Configure private endpoints. The option is available when the Nerdio Manager web app has virtual network integration. The dialog box shows that integration subnet (Subnet for web app), which the Remote Support App Service also uses. You cannot change it. From the Subnet for private endpoints list, select a separate subnet for the private endpoints. Private endpoints are configured for the App Service, the Key Vault, and the Postgres Flexible Server.
-
Select Enable. Nerdio Manager validates the names, and then starts the job Deploy 'Remote Support' app. Follow the job in Jobs. Nerdio Manager selects the PostgreSQL size from the number of endpoints that you chose. If that size is not available in the deployment region, the PostgreSQL server cannot be created, and the job fails with an error.
What the deployment job does
-
Confirms that no other Remote Support deployment exists.
-
Creates the App Service Plan and the App Service.
-
Creates the PostgreSQL Flexible Server (or uses the one you selected), sets the App Service managed identity as its Microsoft Entra admin, and creates the database.
-
Creates the Log Analytics workspace and Application Insights.
-
Creates the Key Vault, and assigns the Key Vault Secrets Officer role to the Nerdio Manager service principal. This lets Nerdio Manager save the Remote Support secrets in the Key Vault.
-
Assigns the Key Vault Secrets User role to the managed identity of the Remote Support App Service, so the server can read the secrets.
-
If you selected private endpoints, configures a private endpoint for the App Service, the PostgreSQL server, and the Key Vault right after each resource is created.
-
Generates the Remote Support credentials, and saves them in the Key Vault.
-
Deploys the Remote Support server package, and creates the server tenant.
-
Saves the Remote Support settings in Nerdio Manager.
Note
Nerdio Manager assigns both Key Vault roles in the context of the signed-in user. The user who selects Enable must have permission to assign Azure roles on the Key Vault. Without it, the role assignment fails, and the deployment cannot save the secrets.
Note
If a deployment fails, open the job in Jobs, and then restart it or revert it. Some steps retry automatically. Reverting deletes only the resources that the job created, which are identified by the job tag, and keeps the existing resources that you selected.
-
Navigate to System > Settings > Nerdio.
-
Expand the Remote Support section.
The Current status row shows whether Remote Support is enabled, and has the following controls:
-
Configure: Choose the host pools, global pools, Windows 365 provisioning policies, and Intune device groups that use Remote Support.
-
View statistics (the chart icon next to Enabled): Shows the detected devices, and the AVD and Intune installation counts.
-
Force: Runs the Remote Support worker now. A confirmation asks whether you want to force Remote Support worker execution.
-
Common: Turn the Remote Support Toolbox on or off.
-
Disable: Opens the Disable Remote Support dialog box. Select which Azure resources to delete: App Service Plan, App Service, Key Vault, Log Analytics workspace, Application Insights, and PostgreSQL server. Resources that have the default
nmw-rs-names are selected by default. Selecting the App Service Plan also deletes its App Service. Selecting the Log Analytics workspace also deletes Application Insights.
-
In the Remote Support section, select Configure.
-
In the Configure Remote Support dialog box, use any of the following lists to select what to include:
-
Select AVD host pools to automatically add the session hosts to Remote Support.
-
Select Global Pools to automatically add the session hosts to Remote Support.
-
Select Windows 365 provisioning policies to automatically add these devices to Remote Support.
-
Select Intune device groups to automatically add to Remote Support.
You can select several items in each list. For Windows 365 provisioning policies and Intune device groups, Nerdio Manager adds the devices in batches to an Entra group that it manages (
REMOTE-SUPPORT-GROUP-...), and assigns an Intune script (REMOTE-SUPPORT-SCRIPT-...) to that group. Devices outside the selected Intune scope are skipped. -
-
Select Save.
-
Navigate to Cloud Desktops > Azure Virtual Desktop > Workspaces, and then open the workspace that contains the host pool.
-
On the Host Pools tab, select the three-dot menu for the host pool, and then select Settings.
-
Select the Remote Support tab.
-
Configure the following settings:
-
Use Remote Support: Turn on to use Remote Support for the host pool.
-
Limit concurrent tasks: The maximum number of agent deployment tasks that run at the same time for the pool, from 1 to 9999. The default for a newly enabled pool is 5.
-
Maintenance Window: Turn on to set when agent deployment tasks can run.
-
-
Select Save or Save and Close.
-
AVD session hosts: Nerdio Manager runs a temporary Azure Custom Script Extension named
remote-support-agent-installeron each host. It starts the VM if it is stopped, installs the agent, checks that the device is registered on your server, removes the extension, and stops the VM again. -
Intune devices and Cloud PCs: Nerdio Manager creates an Entra device group with the prefix
REMOTE-SUPPORT-GROUPand an Intune script with the prefixREMOTE-SUPPORT-SCRIPT. It adds the devices from your selected groups in batches.
-
In the Remote Support section, select the statistics icon next to Enabled.
-
Check the detected devices, and the AVD and Intune installation counts.
-
Optionally, select Force to run the Remote Support worker now.
On the AVD user sessions list, Filter by Remote Support shows the sessions in host pools where Remote Support is enabled or disabled.
The Toolbox gives administrators an unattended session with tools such as a terminal, file transfer, logs, and power controls. The tooltip for the setting reads: "Enable or disable access to the Toolbox during Remote Support sessions. When disabled, Toolbox features will not be available." The Toolbox is on by default. When it is off, the Toolbox option is disabled in the session dialog box.
-
In the Remote Support section, select Common.
-
In the Remote Support Configuration dialog box, use the Remote Support Toolbox toggle, and then select OK.
Nerdio Manager roles control who can deploy, configure, and connect. Operators do not get separate Remote Support accounts.
-
AVD role option Remote Support Operator: Lets the user open Remote Support sessions on session hosts in scope. The Manage, Manage hosts, and Manage sessions options also allow connecting. Installing the agent from the host menu requires full host management access.
-
Intune access level Manage Remote Support: Lets the user use Remote Support actions on Intune-managed devices.
Only the built-in Admin role can enable, disable, or change Remote Support. The built-in Reviewer role has read access to the three scopes. Custom roles do not see the Remote Support section, which also requires Settings full access.
Comments (0 comments)