Table of Contents
Purpose of the Script
- Automatically download and install the latest version of RealVNC Server.
- Uses Microsoft’s Winget GitHub. repository to locate the official installer.
- Performs a silent installation for all users.
# Define the GitHub API URL for the app manifests in winget-pkgs.
$apiUrl = "https://api.github.com/repos/microsoft/winget-pkgs/contents/manifests/r/RealVNC/VNCServer"
# Fetch version folders then filter only version folders.
$header = @{ "User-Agent" = "Mozilla/5.0 (Windows NT 10.0; Win64; x64)" }
$versions = Invoke-RestMethod -Uri $apiUrl -Headers $header
$versionFolders = $versions | Where-Object { $_.type -eq "dir" }
# Extract and sort version numbers to get the latest version.
$sortedVersions = $versionFolders | ForEach-Object { $_.name } | Sort-Object {[version]$_} -Descending -ErrorAction SilentlyContinue
$latestVersion = $sortedVersions[0]
Write-Host "Latest VNCServer version: $latestVersion."
# Get contents of the latest version folder to find the .installer.yaml file.
$latestApiUrl = "$apiUrl/$latestVersion"
$latestFiles = Invoke-RestMethod -Uri $latestApiUrl -Headers $header
$installerFile = $latestFiles | Where-Object { $_.Name -like "*.installer.yaml" }
# Download and parse YAML content to get the Url of the latest installer file.
$yamlUrl = $installerFile.download_url
$yamlContent = Invoke-RestMethod -Uri $yamlUrl -Headers $header
$yamlString = $yamlContent -join "`n"
$installerUrls = [regex]::Matches($yamlString, "InstallerUrl:\s+(http[^\s]+)") | ForEach-Object { $_.Groups[1].Value }
$installerUrl = $installerUrls[1]
Write-Host "Downloading installer from: $installerUrl"
# Download the latest installer to the temp folder.
$webClient = [System.Net.WebClient]::new()
$webClient.DownloadFile($installerUrl, "$env:TEMP\VNCServer-latest.zip")
Expand-Archive -Path "$env:TEMP\VNCServer-latest.zip" -DestinationPath "$env:TEMP\VNCServer" -Force
# Start the install process.
Set-Location -Path $env:TEMP\VNCServer
msiexec.exe /i $((Get-ChildItem -Path $env:TEMP\VNCServer -Filter *64bit*).Name) /qn
# Delete the downloaded installer file.
Remove-Item -Path "$env:TEMP\VNCServer-latest.zip" -Force -ErrorAction SilentlyContinue
Remove-Item -Path "$env:TEMP\VNCServer" -Recurse -Force -ErrorAction SilentlyContinue
Write-Host "VNCServer installation completed."
Step-by-Step Explanation
Below is a detailed explanation of what each part of the PowerShell script does. The script is designed to automatically install or update RealVNC Server on Windows computers.
1. Define the API URL
$apiUrl = "https://api.github.com/repos/microsoft/winget-pkgs/contents/manifests/r/RealVNC/VNCServer"
- Points to the RealVNC Server manifest folder in the winget-pkgs GitHub repository.
- This folder contains subfolders for each version.
2. Get the list of available versions
$header = @{ "User-Agent" = "Mozilla/5.0 (Windows NT 10.0; Win64; x64)" }
$versions = Invoke-RestMethod -Uri $apiUrl -Headers $header
$versionFolders = $versions | Where-Object { $_.type -eq "dir" }
- Fetches all items in the folder (both files and folders).
- Filters to only include directories, because each directory represents a RealVNC Server version.
# Output
PS C:\> $versionFolders
name : 6.11.0.47988
path : manifests/r/RealVNC/VNCServer/6.11.0.47988
sha : 19676f983e69042c7b807f4e25acc0f11b3a2d48
size : 0
url : https://api.github.com/repos/microsoft/winget-pkgs/contents/manifests/r/RealVNC/VNCServer/6.11.0.47988?r
ef=master
html_url : https://github.com/microsoft/winget-pkgs/tree/master/manifests/r/RealVNC/VNCServer/6.11.0.47988
git_url : https://api.github.com/repos/microsoft/winget-pkgs/git/trees/19676f983e69042c7b807f4e25acc0f11b3a2d48
download_url :
type : dir
_links : @{self=https://api.github.com/repos/microsoft/winget-pkgs/contents/manifests/r/RealVNC/VNCServer/6.11.0.
47988?ref=master; git=https://api.github.com/repos/microsoft/winget-pkgs/git/trees/19676f983e69042c7b807
f4e25acc0f11b3a2d48;
html=https://github.com/microsoft/winget-pkgs/tree/master/manifests/r/RealVNC/VNCServer/6.11.0.47988}
...
3. Extract and sort versions
$sortedVersions = $versionFolders | ForEach-Object { $_.name } | Sort-Object {[version]$_} -Descending -ErrorAction SilentlyContinue
$latestVersion = $sortedVersions[0]
- Extracts folder names (version numbers).
- Sorts them as version objects (not strings) in descending order.
- Picks the latest version (first in the sorted list).
# Output
PS C:\> $sortedVersions
7.14.0.5
7.13.1.57
7.13.0.45
7.12.0.14
7.11.1.26
7.11.0.18
7.8.0
7.6.0.50657
7.5.1.50075
7.1.0.49525
7.0.1.49073
6.11.0.47988
6.9.0.46599
4. Get the .installer.yaml file for the latest version
$latestApiUrl = "$apiUrl/$latestVersion"
$latestFiles = Invoke-RestMethod -Uri $latestApiUrl -Headers $header
$installerFile = $latestFiles | Where-Object { $_.Name -like "*.installer.yaml" }
- Looks inside the latest version folder.
- Finds the *.installer.yaml file, which contains metadata about the installer (URLs, architecture, etc.).
# Output
PS C:\> $installerFile
name : RealVNC.VNCServer.installer.yaml
path : manifests/r/RealVNC/VNCServer/7.14.0.5/RealVNC.VNCServer.installer.yaml
sha : 4854b3a9dd2ec0ce46ef0038547ab10b9f098f86
size : 1422
url : https://api.github.com/repos/microsoft/winget-pkgs/contents/manifests/r/RealVNC/VNCServer/7.14.0.5/RealV
NC.VNCServer.installer.yaml?ref=master
html_url : https://github.com/microsoft/winget-pkgs/blob/master/manifests/r/RealVNC/VNCServer/7.14.0.5/RealVNC.VNCS
erver.installer.yaml
git_url : https://api.github.com/repos/microsoft/winget-pkgs/git/blobs/4854b3a9dd2ec0ce46ef0038547ab10b9f098f86
download_url : https://raw.githubusercontent.com/microsoft/winget-pkgs/master/manifests/r/RealVNC/VNCServer/7.14.0.5/Re
alVNC.VNCServer.installer.yaml
type : file
_links : @{self=https://api.github.com/repos/microsoft/winget-pkgs/contents/manifests/r/RealVNC/VNCServer/7.14.0.
5/RealVNC.VNCServer.installer.yaml?ref=master; git=https://api.github.com/repos/microsoft/winget-pkgs/gi
t/blobs/4854b3a9dd2ec0ce46ef0038547ab10b9f098f86; html=https://github.com/microsoft/winget-pkgs/blob/mas
ter/manifests/r/RealVNC/VNCServer/7.14.0.5/RealVNC.VNCServer.installer.yaml}
5. Extract installer URLs from YAML to find the URL of the latest version
$yamlUrl = $installerFile.download_url
$yamlContent = Invoke-RestMethod -Uri $yamlUrl -Headers $header
$yamlString = $yamlContent -join "`n"
$installerUrls = [regex]::Matches($yamlString, "InstallerUrl:\s+(http[^\s]+)") | ForEach-Object { $_.Groups[1].Value }
$installerUrl = $installerUrls[1]
- Downloads the YAML file as raw text.
- Extracts all InstallerUrl entries using regular expressions.
- Picks the URL using an index number.
# Output
PS C:\> $installerUrl
https://downloads.realvnc.com/download/file/vnc.files/VNC-Server-7.14.0-Windows-msi.zip
6. Download the installer
$webClient = [System.Net.WebClient]::new()
$webClient.DownloadFile($installerUrl, "$env:TEMP\VNCServer-latest.zip")
Expand-Archive -Path "$env:TEMP\VNCServer-latest.zip" -DestinationPath "$env:TEMP\VNCServer" -Force
- Downloads the installer to the Windows temp folder ($Env:Temp)
7. Install RealVNC Server silently
Set-Location -Path $env:TEMP\VNCServer
msiexec.exe /i $((Get-ChildItem -Path $env:TEMP\VNCServer -Filter *64bit*).Name) /qn
- Runs the installer in silent mode, no user interaction.
8. Clean up the installer and notify to user
Remove-Item -Path "$env:TEMP\VNCServer-latest.zip" -Force -ErrorAction SilentlyContinue
Remove-Item -Path "$env:TEMP\VNCServer" -Recurse -Force -ErrorAction SilentlyContinue
Write-Host "VNCServer installation completed."
- Deletes the installer after installation to keep the system clean.
- Outputs a message to confirm the installation status.
How to install using PowerShell
To install the app, simply open PowerShell as an administrator, copy the code snippets below, paste them into the PowerShell window, and press .
# Define the GitHub API URL for the app manifests in winget-pkgs.
$apiUrl = "https://api.github.com/repos/microsoft/winget-pkgs/contents/manifests/r/RealVNC/VNCServer"
# Fetch version folders then filter only version folders.
$header = @{ "User-Agent" = "Mozilla/5.0 (Windows NT 10.0; Win64; x64)" }
$versions = Invoke-RestMethod -Uri $apiUrl -Headers $header
$versionFolders = $versions | Where-Object { $_.type -eq "dir" }
# Extract and sort version numbers to get the latest version.
$sortedVersions = $versionFolders | ForEach-Object { $_.name } | Sort-Object {[version]$_} -Descending -ErrorAction SilentlyContinue
$latestVersion = $sortedVersions[0]
Write-Host "Latest VNCServer version: $latestVersion."
# Get contents of the latest version folder to find the .installer.yaml file.
$latestApiUrl = "$apiUrl/$latestVersion"
$latestFiles = Invoke-RestMethod -Uri $latestApiUrl -Headers $header
$installerFile = $latestFiles | Where-Object { $_.Name -like "*.installer.yaml" }
# Download and parse YAML content to get the Url of the latest installer file.
$yamlUrl = $installerFile.download_url
$yamlContent = Invoke-RestMethod -Uri $yamlUrl -Headers $header
$yamlString = $yamlContent -join "`n"
$installerUrls = [regex]::Matches($yamlString, "InstallerUrl:\s+(http[^\s]+)") | ForEach-Object { $_.Groups[1].Value }
$installerUrl = $installerUrls[1]
Write-Host "Downloading installer from: $installerUrl"
# Download the latest installer to the temp folder.
$webClient = [System.Net.WebClient]::new()
$webClient.DownloadFile($installerUrl, "$env:TEMP\VNCServer-latest.zip")
Expand-Archive -Path "$env:TEMP\VNCServer-latest.zip" -DestinationPath "$env:TEMP\VNCServer" -Force
# Start the install process.
Set-Location -Path $env:TEMP\VNCServer
msiexec.exe /i $((Get-ChildItem -Path $env:TEMP\VNCServer -Filter *64bit*).Name) /qn
# Delete the downloaded installer file.
Remove-Item -Path "$env:TEMP\VNCServer-latest.zip" -Force -ErrorAction SilentlyContinue
Remove-Item -Path "$env:TEMP\VNCServer" -Recurse -Force -ErrorAction SilentlyContinue
Write-Host "VNCServer installation completed."
Installing using a PowerShell script
Alternatively, you can create a PowerShell script using the code snippet above. For instance, I’ve created and save a script at “C:\Scripts\install.ps1″.
Next, open PowerShell (or Terminal) as an administrator and execute the PowerShell script using either the call operator or dot notation.
& "C:\Scripts\install.ps1"
# Output
PS C:\> & "C:\Scripts\install.ps1"
Latest VNCServer version: 7.14.0.5.
Downloading installer from: https://downloads.realvnc.com/download/file/vnc.files/VNC-Server-7.14.0-Windows-msi.zip
VNCServer installation completed.
PowerShell execution policy
Root cause: The Windows PowerShell execution policy is designed to block untrusted scripts from impacting your Windows client environment. These policies act as security settings that define the trust level for scripts executed in PowerShell. On client operating systems, the default execution policy is set to Restricted, which stops Windows PowerShell commands and scripts from running.
To fix the issue, adjust the execution policy by running the following command:
Set-ExecutionPolicy RemoteSigned
PS C:\> Set-ExecutionPolicy RemoteSigned
Execution Policy Change
The execution policy helps protect you from scripts that you do not trust. Changing the execution policy
might expose you to the security risks described in the about_Execution_Policies help topic at
https:/go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy?
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"): A
PS C:\>
PS C:\> Get-ExecutionPolicy
RemoteSigned
Use Cases
- Automated software deployment
- Scheduled automatic updates
- Silent install for non-technical users
- Alternative to winget or manual downloads