Skip to content

Commit 9afd5cf

Browse files
Merge pull request #229697 from dknappettmsft/avd-agent-install-download-links
AVD Agent install download links
2 parents 1026929 + c96fe6a commit 9afd5cf

File tree

2 files changed

+36
-4
lines changed

2 files changed

+36
-4
lines changed

articles/virtual-desktop/add-session-hosts-host-pool.md

Lines changed: 31 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -182,7 +182,7 @@ Here's how to create session hosts and register them to a host pool using the Az
182182
183183
## Register session hosts to a host pool
184184

185-
If you created virtual machines using an alternative method outside of Azure Virtual Desktop, such as an automated pipeline, you'll need to register them separately as session hosts to a host pool. To register session hosts to a host pool, you need to install what is referred to as the Azure Virtual Desktop agent on each virtual machine and use the registration key you generated. You can register session hosts to a host pool using the agent installers' graphical user interface (GUI) or using `msiexec` from a command line. Once complete, four applications will be listed as installed applications:
185+
If you created virtual machines using an alternative method outside of Azure Virtual Desktop, such as an automated pipeline, you'll need to register them separately as session hosts to a host pool. To register session hosts to a host pool, you need to install the Azure Virtual Desktop Agent and the Azure Virtual Desktop Agent Bootloader on each virtual machine and use the registration key you generated. You can register session hosts to a host pool using the agent installers' graphical user interface (GUI) or using `msiexec` from a command line. Once complete, four applications will be listed as installed applications:
186186

187187
- Remote Desktop Agent Boot Loader.
188188
- Remote Desktop Services Infrastructure Agent.
@@ -199,6 +199,12 @@ Select the relevant tab for your scenario and follow the steps.
199199

200200
1. Sign in to your virtual machine as an administrator.
201201

202+
1. Download the Agent and the Agent Bootloader installation files using the following links You may need to unblock them; right-click each file and select **Properties**, then select **Unblock**, and finally select **OK**.
203+
204+
- [Azure Virtual Desktop Agent](https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RWrmXv)
205+
206+
- [Azure Virtual Desktop Agent Bootloader](https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RWrxrH)
207+
202208
1. Run the `Microsoft.RDInfra.RDAgent.Installer-x64-<version>.msi` file to install the Remote Desktop Services Infrastructure Agent.
203209

204210
1. Follow the prompts and when the installer prompts for the registration token, paste it into the text box, which will appear on a single line. Select **Next**, then complete the installation.
@@ -226,6 +232,30 @@ Using `msiexec` enables you to install the agent and boot loader from the comman
226232
Install-WindowsFeature -Name RDS-RD-Server -Restart
227233
```
228234

235+
1. Download the Agent and the Agent Bootloader installation files and unblock them by running the following commands:
236+
237+
```powershell
238+
$uris = @(
239+
"https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RWrmXv"
240+
"https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RWrxrH"
241+
)
242+
243+
$installers = @()
244+
foreach ($uri in $uris) {
245+
$download = Invoke-WebRequest -Uri $uri -Method GET
246+
247+
$fileName = ($download.Headers.'Content-Disposition').Split('=')[1].Replace('"','')
248+
$output = [System.IO.FileStream]::new("$pwd\$fileName", [System.IO.FileMode]::Create)
249+
$output.write($download.Content, 0, $download.RawContentLength)
250+
$output.close()
251+
$installers += $output.Name
252+
}
253+
254+
foreach ($installer in $installers) {
255+
Unblock-File -Path "$installer"
256+
}
257+
```
258+
229259
1. To install the Remote Desktop Services Infrastructure Agent, run the following command as an administrator:
230260

231261
```powershell

articles/virtual-desktop/troubleshoot-agent.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -349,8 +349,10 @@ You must generate a new registration key that is used to re-register your sessio
349349
By reinstalling the most updated version of the agent and boot loader, the side-by-side stack and Geneva monitoring agent automatically get installed as well. To reinstall the agent and boot loader:
350350

351351
1. Sign in to your session host VM as an administrator and run the agent installer and bootloader for your session host VM:
352-
- [Azure Virtual Desktop Agent](https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RWrmXv)
353-
- [Azure Virtual Desktop Agent Bootloader](https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RWrxrH)
352+
353+
- [Azure Virtual Desktop Agent](https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RWrmXv)
354+
355+
- [Azure Virtual Desktop Agent Bootloader](https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RWrxrH)
354356

355357
> [!TIP]
356358
> For each of the the agent and boot loader installers you downloaded, you may need to unblock them. Right-click each file and select **Properties**, then select **Unblock**, and finally select **OK**.
@@ -371,7 +373,7 @@ By reinstalling the most updated version of the agent and boot loader, the side-
371373
> [!div class="mx-imgBorder"]
372374
> ![Screenshot of available session host](media/hostpool-portal.png)
373375
374-
## Remove DisableRegistryTools
376+
## Remove DisableRegistryTools registry key
375377

376378
If you've performed all four steps but the agent still doesn't work, that may be because the DisableRegistryTools registry key is enabled in one of the following locations:
377379

0 commit comments

Comments
 (0)