Hello all,
I am looking for a way to start a multiple choice querry at the beginning of the installation.
For now I´ve only applied a solution with 3 possibilities using Show-ADTInstallationPrompt and Parameters Button-XXX-Text .
Now I got a request of 7 choices.
Depending in the choice of the users, a different cmd file would be copied:
ChatGPT presented the Parameter -DropDownList ( as shown below in the code ) but I cannot find the parameter in the PSADT v.4+ documentation.
I hope you could tell me how you would solve this. First I´ll show you how the PSADT script looks so far and then the last resulting error:
The part of interest start in line 243 ( ##=======Neuerungen in Version2=======)
So in the first version of this script I only had the check existing programs and install them (only) if needed. "(german)Neuerungen in Version2 - (english)New things in version 2" introduces the querry.
I changed the actual location names so location 1,2 etc :
<#
.SYNOPSIS
PSAppDeployToolkit - This script performs the installation or uninstallation of an application(s).
.DESCRIPTION
- The script is provided as a template to perform an install, uninstall, or repair of an application(s).
- The script either performs an "Install", "Uninstall", or "Repair" deployment type.
- The install deployment type is broken down into 3 main sections/phases: Pre-Install, Install, and Post-Install.
The script imports the PSAppDeployToolkit module which contains the logic and functions required to install or uninstall an application.
.PARAMETER DeploymentType
The type of deployment to perform.
.PARAMETER DeployMode
Specifies whether the installation should be run in Interactive (shows dialogs), Silent (no dialogs), NonInteractive (dialogs without prompts) mode, or Auto (shows dialogs if a user is logged on, device is not in the OOBE, and there's no running apps to close).
Silent mode is automatically set if it is detected that the process is not user interactive, no users are logged on, the device is in Autopilot mode, or there's specified processes to close that are currently running.
.PARAMETER SuppressRebootPassThru
Suppresses the 3010 return code (requires restart) from being passed back to the parent process (e.g. SCCM) if detected from an installation. If 3010 is passed back to SCCM, a reboot prompt will be triggered.
.PARAMETER TerminalServerMode
Changes to "user install mode" and back to "user execute mode" for installing/uninstalling applications for Remote Desktop Session Hosts/Citrix servers.
.PARAMETER DisableLogging
Disables logging to file for the script.
.EXAMPLE
powershell.exe -File Invoke-AppDeployToolkit.ps1
.EXAMPLE
powershell.exe -File Invoke-AppDeployToolkit.ps1 -DeployMode Silent
.EXAMPLE
powershell.exe -File Invoke-AppDeployToolkit.ps1 -DeploymentType Uninstall
.EXAMPLE
Invoke-AppDeployToolkit.exe -DeploymentType Install -DeployMode Silent
.INPUTS
None. You cannot pipe objects to this script.
.OUTPUTS
None. This script does not generate any output.
.NOTES
Toolkit Exit Code Ranges:
- 60000 - 68999: Reserved for built-in exit codes in Invoke-AppDeployToolkit.ps1, and Invoke-AppDeployToolkit.exe
- 69000 - 69999: Recommended for user customized exit codes in Invoke-AppDeployToolkit.ps1
- 70000 - 79999: Recommended for user customized exit codes in PSAppDeployToolkit.Extensions module.
.LINK
https://psappdeploytoolkit.com
#>
[CmdletBinding()]
param
(
# Default is 'Install'.
[Parameter(Mandatory = $false)]
[ValidateSet('Install', 'Uninstall', 'Repair')]
[System.String]$DeploymentType,
# Default is 'Auto'. Don't hard-code this unless required.
[Parameter(Mandatory = $false)]
[ValidateSet('Auto', 'Interactive', 'NonInteractive', 'Silent')]
[System.String]$DeployMode,
[Parameter(Mandatory = $false)]
[System.Management.Automation.SwitchParameter]$SuppressRebootPassThru,
[Parameter(Mandatory = $false)]
[System.Management.Automation.SwitchParameter]$TerminalServerMode,
[Parameter(Mandatory = $false)]
[System.Management.Automation.SwitchParameter]$DisableLogging
)
##================================================
## MARK: Variables
##================================================
# Zero-Config MSI support is provided when "AppName" is null or empty.
# By setting the "AppName" property, Zero-Config MSI will be disabled.
$adtSession = @{
# App variables.
AppVendor = 'Hexagon'
AppName = 'Hexagon_Fatool'
AppVersion = '2'
AppArch = ''
AppLang = 'EN'
AppRevision = '01'
AppSuccessExitCodes = @(0)
AppRebootExitCodes = @(1641, 3010)
AppProcessesToClose = @() # Example: @('excel', @{ Name = 'winword'; Description = 'Microsoft Word' })
AppScriptVersion = '1.0.0'
AppScriptDate = '2025-08-21'
AppScriptAuthor = 'xxxt'
RequireAdmin = $true
# Install Titles (Only set here to override defaults set by the toolkit).
InstallName = 'Hexagon_Fatool'
InstallTitle = 'Hexagon_Fatool'
# Script variables.
DeployAppScriptFriendlyName = $MyInvocation.MyCommand.Name
DeployAppScriptParameters = $PSBoundParameters
DeployAppScriptVersion = '4.1.3'
}
function Install-ADTDeployment
{
[CmdletBinding()]
param
(
)
##================================================
## MARK: Pre-Install
##================================================
<#
$adtSession.InstallPhase = "Pre-$($adtSession.DeploymentType)"
## Show Welcome Message, close processes if specified, allow up to 3 deferrals, verify there is enough disk space to complete the install, and persist the prompt.
$saiwParams = @{
AllowDefer = $true
DeferTimes = 3
CheckDiskSpace = $true
PersistPrompt = $true
}
if ($adtSession.AppProcessesToClose.Count -gt 0)
{
$saiwParams.Add('CloseProcesses', $adtSession.AppProcessesToClose)
}
Show-ADTInstallationWelcome @saiwParams
## Show Progress Message (with the default message).
Show-ADTInstallationProgress
## <Perform Pre-Installation tasks here>
#>
##================================================
## MARK: Install
##================================================
$adtSession.InstallPhase = $adtSession.DeploymentType
## Handle Zero-Config MSI installations.
if ($adtSession.UseDefaultMsi)
{
$ExecuteDefaultMSISplat = @{ Action = $adtSession.DeploymentType; FilePath = $adtSession.DefaultMsiFile }
if ($adtSession.DefaultMstFile)
{
$ExecuteDefaultMSISplat.Add('Transforms', $adtSession.DefaultMstFile)
}
Start-ADTMsiProcess @ExecuteDefaultMSISplat
if ($adtSession.DefaultMspFiles)
{
$adtSession.DefaultMspFiles | Start-ADTMsiProcess -Action Patch
}
}
## <Perform Installation tasks here>
#Start-AdtMsiProcess -Action 'Install' -FilePath 'FASYSInstaller2023.1.msi' -ArgumentList '/quiet /norestart'
#Nr.1-###############################################DOTNET####################################
# Definiere die minimale benötigte .NET-Version
$RequiredNetVersion = 528040 # .NET 4.8 entspricht Release 528040
# Prüfe die installierte .NET-Version aus der Registry
$InstalledNetVersion = (Get-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full" -ErrorAction SilentlyContinue).Release
if ($InstalledNetVersion -and $InstalledNetVersion -ge $RequiredNetVersion) {
Write-ADTLogEntry -Message ".NET Framework 4.8 oder neuer ist bereits installiert (Release: $InstalledNetVersion). Installation wird übersprungen." -Severity 1
}
else {
Write-ADTLogEntry -Message ".NET Framework 4.8 nicht gefunden oder ältere Version installiert (Release: $InstalledNetVersion). Installation wird gestartet..." -Severity 1
# Installation von .NET Framework 4.8 (Englisch)
Start-ADTProcess -FilePath "ndp48-x86-x64-allos-enu.exe" -ArgumentList "/passive /norestart" -WindowStyle Hidden
# Installation von .NET Framework 4.8 (Deutsch) – falls erforderlich
Start-ADTProcess -FilePath "ndp48-x86-x64-allos-deu.exe" -ArgumentList "/passive /norestart" -WindowStyle Hidden
}
#Nr.2-###############################################Microsoft Visual C++ Verison 2015-2022####################################
# Definiere die benötigte Visual C++ Redistributable-Version (2015-2022)
$VcVersion = "14.30" # Beispielversion für 2015-2022 (prüfe bei Bedarf die exakte Version)
$VcRegPath = "HKLM:\SOFTWARE\Microsoft\VisualStudio\14.0\VC\Runtimes\x64"
# Prüfe, ob Visual C++ Redistributable bereits installiert ist
$InstalledVcVersion = (Get-ItemProperty -Path $VcRegPath -ErrorAction SilentlyContinue).Version
if ($InstalledVcVersion -and $InstalledVcVersion -ge $VcVersion) {
Write-ADTLogEntry -Message "Microsoft Visual C++ 2015-2022 ($InstalledVcVersion) ist bereits installiert. Installation wird übersprungen." -Severity 1
}
else {
Write-ADTLogEntry -Message "Microsoft Visual C++ 2015-2022 nicht gefunden oder veraltete Version ($InstalledVcVersion). Installation wird gestartet..." -Severity 1
# Installation von Visual C++ Redistributable 2015-2022 (Silent Mode, kein Neustart)
Start-ADTProcess -FilePath "vc_redist.x64.exe" -ArgumentList "/passive /norestart" -WindowStyle Hidden
}
#Nr.3-###############################################Microsoft ODBC Driver 17 for SQL Server####################################
# Definiere den Namen des ODBC-Treibers
$OdbcDriverName = "Microsoft ODBC Driver 17 for SQL Server"
# Prüfe, ob eine Version 17 installiert ist
$InstalledVersion = (Get-ItemProperty -Path "HKLM:\SOFTWARE\ODBC\ODBCINST.INI\$OdbcDriverName" -ErrorAction SilentlyContinue).Version
if ($InstalledVersion -and $InstalledVersion -match "^17\.(\d+)\.(\d+)\.(\d+)$") {
Write-ADTLogEntry -Message "Gefundene installierte Version: $InstalledVersion" -Severity 1
}
else {
Write-ADTLogEntry -Message "Keine Version 17 gefunden oder keine Installation vorhanden." -Severity 1
$InstalledVersion = $null
}
# Falls KEINE 17.x-Version oder eine ältere 17.x-Version installiert ist, dann Installation durchführen
if (-not $InstalledVersion -or [version]$InstalledVersion -lt [version]"17.6.1.1") {
Write-ADTLogEntry -Message "Installiere Microsoft ODBC Driver 17 für SQL Server..." -Severity 1
Start-ADTMsiProcess -Action 'Install' -FilePath 'msodbcsql.msi' -ArgumentList 'IACCEPTMSODBCSQLLICENSETERMS=YES'
}
else {
Write-ADTLogEntry -Message "Eine aktuelle oder neuere Version ($InstalledVersion) von ODBC 17 ist bereits installiert. Installation wird übersprungen." -Severity 1
}
# Installiere FASYSSetup.exe (per EXE)
#Start-AdtProcess -FilePath 'FASYSSetup.exe' -ArgumentList '/silent /norestart'
##=======Neuerungen in Version2=======
## Standortauswahl und Copyjob der ausgewählten CMD . Anlegen desktopverknüpfung mit Icon
# Begrüßung und Standortauswahl
[string]$location = Show-ADTInstallationPrompt -Message 'Please choose your location' -Title 'Welcome to Hexagon Fatool Installer'
-DropDownList @('Location1', 'Location2', 'Location3', 'Location4', 'Location5', 'Location6', 'Location7') -Timeout 0
if ([string]::IsNullOrEmpty($location)) {
Show-ADTInstallationPrompt -Message 'No location selected, installation will be cancelled.' -ButtonRightText 'OK' -Icon Warning
Exit-Script -ExitCode 1
}
# Zielordner prüfen/erstellen
$targetFolder = 'C:\fawrk'
if (-not (Test-Path -Path $targetFolder)) {
New-Item -Path $targetFolder -ItemType Directory | Out-Null
}
# CMD-Datei je nach Auswahl zuordnen
switch ($location) {
'Location1' { $cmdFile = 'Location1.cmd' }
'Location2' { $cmdFile = 'Location2.cmd' }
'Location3' { $cmdFile = 'Location3.cmd' }
'Location4' { $cmdFile = 'Location4.cmd' }
'Location5' { $cmdFile = 'Location5.cmd' }
'Location6' { $cmdFile = 'Location6.cmd' }
'Location7' { $cmdFile = 'Location7.cmd' }
default {
Show-ADTInstallationPrompt -Message "Unknown location selected: $location" -ButtonRightText 'OK' -Icon Warning
Exit-Script -ExitCode 1
}
}
# CMD-Datei kopieren
$sourceCmdPath = Join-Path -Path $dirSupportFiles -ChildPath $cmdFile
$targetCmdPath = Join-Path -Path $targetFolder -ChildPath $cmdFile
Copy-Item -Path $sourceCmdPath -Destination $targetCmdPath -Force
# Desktop-Verknüpfung erstellen
$WScriptShell = New-Object -ComObject WScript.Shell
$desktopPath = [Environment]::GetFolderPath('Desktop')
$shortcutPath = Join-Path -Path $desktopPath -ChildPath 'Hexagon_FaTool.lnk'
$shortcut = $WScriptShell.CreateShortcut($shortcutPath)
$shortcut.TargetPath = $targetCmdPath
$shortcut.WorkingDirectory = $targetFolder
# Optional: Icon setzen (z.B. exe- oder ico-Datei im SupportFiles Ordner)
# Beispiel: Icon.ico im SupportFiles Ordner
$iconFile = Join-Path -Path $dirSupportFiles -ChildPath 'Hexago_FaTool.ico'
if (Test-Path -Path $iconFile) {
$shortcut.IconLocation = $iconFile
}
$shortcut.Save()
##================================================
## MARK: Post-Install
##================================================
$adtSession.InstallPhase = "Post-$($adtSession.DeploymentType)"
## <Perform Post-Installation tasks here>
Set-ADTRegistryKey -Key 'HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\OurCompany\ComputerManagement\Hexagon_Fatool' -Name 'Version' -Value '2.1' -Type String
## Display a message at the end of the install.
if (!$adtSession.UseDefaultMsi)
{
Show-ADTInstallationPrompt -Message 'You can customize text to appear at the end of an install or remove it completely for unattended installations.' -ButtonRightText 'OK' -Icon Information -NoWait
}
}
function Uninstall-ADTDeployment
{
[CmdletBinding()]
param
(
)
##================================================
## MARK: Pre-Uninstall
##================================================
$adtSession.InstallPhase = "Pre-$($adtSession.DeploymentType)"
## If there are processes to close, show Welcome Message with a 60 second countdown before automatically closing.
if ($adtSession.AppProcessesToClose.Count -gt 0)
{
Show-ADTInstallationWelcome -CloseProcesses $adtSession.AppProcessesToClose -CloseProcessesCountdown 60
}
## Show Progress Message (with the default message).
Show-ADTInstallationProgress
## <Perform Pre-Uninstallation tasks here>
##================================================
## MARK: Uninstall
##================================================
$adtSession.InstallPhase = $adtSession.DeploymentType
## Handle Zero-Config MSI uninstallations.
if ($adtSession.UseDefaultMsi)
{
$ExecuteDefaultMSISplat = @{ Action = $adtSession.DeploymentType; FilePath = $adtSession.DefaultMsiFile }
if ($adtSession.DefaultMstFile)
{
$ExecuteDefaultMSISplat.Add('Transforms', $adtSession.DefaultMstFile)
}
Start-ADTMsiProcess @ExecuteDefaultMSISplat
}
## <Perform Uninstallation tasks here>
Write-Log "Starte Deinstallation von Hexagon_Fatool..."
# Deinstalliere FASYSInstaller2023.1.msi
Write-Log "Deinstalliere FASYSInstaller2023.1.msi..."
Start-AdtMsiProcess -Action 'Uninstall' -FilePath "$dirFiles\FASYSInstaller2023.1.msi" -Parameters "/quiet /norestart"
# Deinstalliere FASYSSetup.exe (falls es eine Deinstallationsoption hat)
Write-Log "Deinstalliere FASYSSetup.exe..."
Start-AdtProcess -FilePath "$dirFiles\FASYSSetup.exe" -Parameters "/uninstall /quiet /norestart"
## Entferne installierte Abhängigkeiten nur, wenn sie durch diese App installiert wurden
Write-Log "Prüfe, ob installierte Komponenten durch diese App installiert wurden und deinstalliere sie falls notwendig..."
$Dependencies = @(
@{ Name = "ODBC Driver for SQL Server"; Path = "$dirFiles\msodbcsql.msi"; Type = "MSI" }
@{ Name = ".NET Framework 4.8"; Path = "$dirFiles\ndp48-x86-x64-allos-deu.exe"; Type = "EXE" }
@{ Name = "Microsoft Visual C++ 2015-2022 Redistributable"; Path = "$dirFiles\vc_redist.x64.exe"; Type = "EXE" }
)
foreach ($Dep in $Dependencies) {
$Installed = Get-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*" `
| Where-Object { $_.DisplayName -like "$($Dep.Name)*" }
if ($Installed -and $Installed.InstallLocation -match [regex]::Escape($dirFiles)) {
Write-Log "$($Dep.Name) wurde durch diese App installiert. Deinstalliere..."
if ($Dep.Type -eq "MSI") {
Start-AdtMsiProcess -Action 'Uninstall' -FilePath $Dep.Path -Parameters "/quiet /norestart"
} else {
Start-AdtProcess -FilePath $Dep.Path -Parameters "/uninstall /quiet /norestart"
}
} else {
Write-Log "$($Dep.Name) wurde nicht durch diese App installiert – keine Deinstallation."
}
}
Write-Log "Deinstallationsprüfung abgeschlossen."
## Registry Key entfernen
If (Test-Path 'HKLM:\SOFTWARE\WOW6432Node\OurCompany\ComputerManagement\Hexagon_Fatool') {
Remove-ADTRegistryKey -Key 'HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\OurCompany\ComputerManagement\Hexagon_Fatool' -Name 'Version'
}
Write-Log "Deinstallation abgeschlossen."
}
##================================================
## MARK: Post-Uninstallation
##================================================
$adtSession.InstallPhase = "Post-$($adtSession.DeploymentType)"
## <Perform Post-Uninstallation tasks here>
function Repair-ADTDeployment
{
[CmdletBinding()]
param
(
)
##================================================
## MARK: Pre-Repair
##================================================
$adtSession.InstallPhase = "Pre-$($adtSession.DeploymentType)"
## If there are processes to close, show Welcome Message with a 60 second countdown before automatically closing.
if ($adtSession.AppProcessesToClose.Count -gt 0)
{
Show-ADTInstallationWelcome -CloseProcesses $adtSession.AppProcessesToClose -CloseProcessesCountdown 60
}
## Show Progress Message (with the default message).
Show-ADTInstallationProgress
## <Perform Pre-Repair tasks here>
##================================================
## MARK: Repair
##================================================
$adtSession.InstallPhase = $adtSession.DeploymentType
## Handle Zero-Config MSI repairs.
if ($adtSession.UseDefaultMsi)
{
$ExecuteDefaultMSISplat = @{ Action = $adtSession.DeploymentType; FilePath = $adtSession.DefaultMsiFile }
if ($adtSession.DefaultMstFile)
{
$ExecuteDefaultMSISplat.Add('Transforms', $adtSession.DefaultMstFile)
}
Start-ADTMsiProcess @ExecuteDefaultMSISplat
}
## <Perform Repair tasks here>
##================================================
## MARK: Post-Repair
##================================================
$adtSession.InstallPhase = "Post-$($adtSession.DeploymentType)"
## <Perform Post-Repair tasks here>
}
##================================================
## MARK: Initialization
##================================================
# Set strict error handling across entire operation.
$ErrorActionPreference = [System.Management.Automation.ActionPreference]::Stop
$ProgressPreference = [System.Management.Automation.ActionPreference]::SilentlyContinue
Set-StrictMode -Version 1
# Import the module and instantiate a new session.
try
{
# Import the module locally if available, otherwise try to find it from PSModulePath.
if (Test-Path -LiteralPath "$PSScriptRoot\PSAppDeployToolkit\PSAppDeployToolkit.psd1" -PathType Leaf)
{
Get-ChildItem -LiteralPath "$PSScriptRoot\PSAppDeployToolkit" -Recurse -File | Unblock-File -ErrorAction Ignore
Import-Module -FullyQualifiedName @{ ModuleName = "$PSScriptRoot\PSAppDeployToolkit\PSAppDeployToolkit.psd1"; Guid = '8c3c366b-8606-4576-9f2d-4051144f7ca2'; ModuleVersion = '4.1.3' } -Force
}
else
{
Import-Module -FullyQualifiedName @{ ModuleName = 'PSAppDeployToolkit'; Guid = '8c3c366b-8606-4576-9f2d-4051144f7ca2'; ModuleVersion = '4.1.3' } -Force
}
# Open a new deployment session, replacing $adtSession with a DeploymentSession.
$iadtParams = Get-ADTBoundParametersAndDefaultValues -Invocation $MyInvocation
$adtSession = Remove-ADTHashtableNullOrEmptyValues -Hashtable $adtSession
$adtSession = Open-ADTSession @adtSession @iadtParams -PassThru
}
catch
{
$Host.UI.WriteErrorLine((Out-String -InputObject $_ -Width ([System.Int32]::MaxValue)))
exit 60008
}
##================================================
## MARK: Invocation
##================================================
# Commence the actual deployment operation.
try
{
# Import any found extensions before proceeding with the deployment.
Get-ChildItem -LiteralPath $PSScriptRoot -Directory | & {
process
{
if ($_.Name -match 'PSAppDeployToolkit\..+$')
{
Get-ChildItem -LiteralPath $_.FullName -Recurse -File | Unblock-File -ErrorAction Ignore
Import-Module -Name $_.FullName -Force
}
}
}
# Invoke the deployment and close out the session.
& "$($adtSession.DeploymentType)-ADTDeployment"
Close-ADTSession
}
catch
{
# An unhandled error has been caught.
$mainErrorMessage = "An unhandled error within [$($MyInvocation.MyCommand.Name)] has occurred.`n$(Resolve-ADTErrorRecord -ErrorRecord $_)"
Write-ADTLogEntry -Message $mainErrorMessage -Severity 3
## Error details hidden from the user by default. Show a simple dialog with full stack trace:
# Show-ADTDialogBox -Text $mainErrorMessage -Icon Stop -NoWait
## Or, a themed dialog with basic error message:
# Show-ADTInstallationPrompt -Message "$($adtSession.DeploymentType) failed at line $($_.InvocationInfo.ScriptLineNumber), char $($_.InvocationInfo.OffsetInLine):`n$($_.InvocationInfo.Line.Trim())`n`nMessage:`n$($_.Exception.Message)" -MessageAlignment Left -ButtonRightText OK -Icon Error -NoWait
Close-ADTSession -ExitCode 60001
}
