public/Install-AVD-Agent.ps1 at main · avdpunks/public · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
#################################################################################
#
# The sample scripts are not supported under any Microsoft standard support
# program or service. The sample scripts are provided AS IS without warranty
# of any kind. Microsoft further disclaims all implied warranties including, without
# limitation, any implied warranties of merchantability or of fitness for a particular
# purpose. The entire risk arising out of the use or performance of the sample scripts
# and documentation remains with you. In no event shall Microsoft, its authors, or
# anyone else involved in the creation, production, or delivery of the scripts be liable
# for any damages whatsoever (including, without limitation, damages for loss of business
# profits, business interruption, loss of business information, or other pecuniary loss)
# arising out of the use of or inability to use the sample scripts or documentation,
# even if Microsoft has been advised of the possibility of such damages.
#
#################################################################################

<#
.SYNOPSIS
    Installs the Azure Virtual Desktop (AVD) Agent and Bootloader on a Windows machine using a provided registration token.

.DESCRIPTION
    This script automates the installation of the AVD Agent and its Bootloader component. It requires a valid RegToken parameter to register the machine with the AVD host pool.

.NOTES
    Author: Daniel Weppeler
    Date: 07/28/2025
    Version: 1.0
#>

param (
    [Parameter(Mandatory=$true)]
    [string]$AVDRegistrationToken
)

$LogPath = "C:\Windows\Temp\InstallAVDAgent.log"

function Write-Log {
    param([string]$Message)
    Write-Output $Message
}

try {
    Start-Transcript -Path $LogPath -ErrorAction Stop
    Write-Log "Transcript started. Log file: $LogPath"

    Write-Log "Starting AVD Agent installation..."
    $TempPath = "$env:WINDIR\Temp"
    $AgentInstaller = Join-Path $TempPath "AVDAgentInstaller.msi"
    $BootloaderInstaller = Join-Path $TempPath "AVDAgentBootloaderInstaller.msi"

    Write-Log "Downloading AVD Agent installer..."
    Invoke-WebRequest -Uri 'https://go.microsoft.com/fwlink/?linkid=2310011' -OutFile $AgentInstaller -UseBasicParsing
    Start-Sleep -Seconds 10
    Write-Log "Installing AVD Agent..."
    Unblock-File $AgentInstaller
    Start-Process -FilePath 'msiexec.exe' -ArgumentList "/i `"$AgentInstaller`" /quiet REGISTRATIONTOKEN=$AVDRegistrationToken" -Wait
    Write-Log "Successfully installed AVD Agent."

    Write-Log "Downloading AVD Agent Bootloader installer..."
    Invoke-WebRequest -Uri 'https://go.microsoft.com/fwlink/?linkid=2311028' -OutFile $BootloaderInstaller -UseBasicParsing
    Start-Sleep -Seconds 10
    Write-Log "Installing AVD Agent Bootloader..."
    Unblock-File $BootloaderInstaller
    Start-Process -FilePath 'msiexec.exe' -ArgumentList "/i `"$BootloaderInstaller`" /quiet" -Wait
    Write-Log "Successfully installed AVD Agent Bootloader."

    Stop-Transcript
    Write-Log "Transcript stopped."
    exit 0
} catch {
    Write-Error "An error occurred: $_"
    Stop-Transcript
    exit 1
}