XOAP PSADT Package Wizard is a Windows desktop application that guides you through creating PSAppDeployToolkit (PSADT) v4 deployment packages. Instead of manually editing PowerShell scripts, you use a step-by-step wizard to configure application metadata, write deployment logic, upload installer files, and export a ready-to-deploy .zip package.

What you get

Each exported package is a standard PSADT v4 folder containing:

• Invoke-AppDeployToolkit.ps1 — The main deployment script (generated by the wizard)
• Invoke-AppDeployToolkit.exe — PSADT executable stub
• PSAppDeployToolkit/ — The PSADT module
• Files/ — Your installer files (MSI, EXE, configuration files, etc.)
• Supporting folders (Config/, Strings/, SupportFiles/, Assets/)

These packages can be deployed with SCCM/MECM, Intune, or any deployment tool that runs PowerShell scripts.

The post Introduction appeared first on XOAP.

Einrichtung

System requirements

• Windows 10 (version 1809+) or Windows 11
• x64 processor
• Internet connection (only for first-time .NET runtime download and optional PSADT download)

Install steps

1. ausführen. PackageWizard-Setup-{version}.exe
2. If .NET 9 is not installed, the installer will automatically download and install the required runtimes from Microsoft (Microsoft.WindowsDesktop.App und Microsoft.AspNetCore.App). This may take a few minutes on first install.
3. Choose the installation folder (default: C:\Program Files\XOAP PSADT Package Wizard)
4. Optionally create a desktop shortcut
5. Klicken Sie auf Installieren Sie

Deinstallieren

Verwenden Sie Windows Settings → Apps → XOAP PSADT Package Wizard → Uninstall, or run the uninstaller from the Start Menu.

Your packages and settings in %AppData%\XOAP\PackageWizard\ are preserved after uninstall. Delete that folder manually if you want a completely clean removal.

First launch

Start XOAP PSADT Paket-Assistent from the Start Menu or desktop shortcut.

On first launch, the application:

1. Starts a local backend server on a random free port (runs entirely on your machine)
2. Opens the wizard interface in an embedded browser window (WebView2)
3. If older data exists in %AppData%\PackageWizard\, it is migrated to %AppData%\XOAP\PackageWizard\ automatisch

You will land on the Packages Workspace — your dashboard for all saved packages.

Recommended first-time setup

1. Öffnen Einstellungen (gear icon, bottom-left)
2. Auf der PSADT Toolkit tab, verify that an active toolkit is detected. Click Neueste PSADT herunterladen to fetch the newest release from GitHub if you want the latest version (this persists to %AppData%\XOAP\PackageWizard\Toolkit\{tag}\)
3. Auf der Allgemein tab, set your Standard-Skriptautor (pre-fills new packages) and Standard-Ausgabeordner (where exports are saved)
4. Verwenden Sie die Dark/Light theme toggle in the sidebar footer to pick your preferred theme

The post Installation & first launch appeared first on XOAP.

The main window

The main window has a left sidebar (navigation), a top header (breadcrumbs and the active wizard step bar when a package is open), and a main panel (the current view).

Sidebar: Top section

Sidebar: Wizard steps

Once a package is active, the sidebar shows the seven wizard steps. Steps you haven’t reached yet are enabled only if prerequisites are met; completed steps show a check mark.

1. Dateien
2. Session Config
3. Parameter
4. Install Phase
5. Uninstall Phase
6. Repair Phase
7. Vorschau

Sidebar: Bottom section

• Einstellungen — application preferences, toolkit management, package configuration
• Tags — manage the color-coded tag library
• Dark/Light Mode toggle — persists across restarts
• About — version, platform info, license, xoap.io link

Wizard header strip

When a package is active, a strip below the breadcrumb shows:

• An “Active” badge with the package name
• Exit — returns to the dashboard
• Speichern Sie — persists any unsaved in-memory changes (also auto-saves every 2 seconds)

Wizard footer

At the bottom of every wizard step: Back, Step N of 7, und Weiter / Oberfläche. Die Weiter button is disabled when the current step has validation errors; hover it to see the reason as a tooltip.

Packages workspace (dashboard)

The dashboard is your central workspace for managing packages.

Header

• Package Usage Widget — Shows {used} | {max} Packages used with a progress bar and percentage. The free edition is limited to 10 packages; the widget turns red and the Neues Paket starten button becomes disabled at the cap.
• Neues Paket starten — Creates a blank package and opens the first wizard step
• Lokal importieren — Opens a drawer to drop/select one or more existing PSADT .zip packages to import into the workspace

Toolbar

• Tag filter (left) — Filter packages by assigned tag (or “All tags”)
• Suche — Filter by package name
• Select All Packages — Batch checkbox
• Tags zuweisen — Opens a drawer to assign/remove tags on the selected packages
• Export (download icon) — Exports every selected package; in the desktop app each zip is written to the Default Output Folder (or Downloads fallback). In a browser the zips download one-by-one
• Löschen (trash icon) — Deletes selected packages (with a confirmation prompt)

Package card

Each package card shows:

• Package name (auto-set from AppName once filled in)
• Application metadata (vendor, name, version, architecture)
• Assigned tags (color-coded badges; limit 5 tags per package)
• Creation date
• Per-card actions: Öffnen (enter wizard), Export, Edit Tags, Löschen

Multi-select

Click the card checkbox (or Select All) to queue packages for batch export / delete / tag assignment.

The post UI overview appeared first on XOAP.

Klicken Sie auf Neues Paket starten on the dashboard. The wizard guides you through seven steps. You can navigate freely between steps using the sidebar or the Previous/Next footer buttons. Every change is auto-saved to the active package roughly every 2 seconds, or immediately when you click Speichern Sie in the header strip.

Step 1: Files manager

Upload the installer files that your deployment script will reference.

How to upload:

• Drag and drop files or folders onto the upload area, or
• Klicken Sie auf the upload area to open the file browser

Features:

• Folder structure is preserved (useful for complex installers)
• Maximum upload size: 5 GB per request
• Automatic metadata detection: When you upload an MSI or EXE, the wizard reads its embedded ProductName, ProductVersion, and architecture and offers to pre-fill Session Configuration

File Tree:

• View all uploaded files in a tree structure
• Delete individual files or folders
• Clear all files for the active package

Uploaded files are stored per-package in %AppData%\XOAP\PackageWizard\workspace\Files\{packageId}\ and are bundled into Files/ inside the exported zip.

Step 2: Session configuration

Configure the application metadata that PSADT uses for logging, UI display, and detection. Every field here is written into the $adtSession = @{ ... } block of the generated script.

Application information

Script metadata

Deployment settings

Display settings

Schritt 3: Parameter

Add custom PowerShell parameters to your deployment script. These are appended to the param() block alongside the default PSADT parameters.

Default parameters (always present, read-only):

• Bereitstellungstyp — Installieren Sie / Deinstallieren / Reparatur
• Bereitstellungsmodus — Auto / Interactive / NonInteractive / Silent
• SuppressRebootPassThru (switch)
• TerminalServerMode (switch)
• DisableLogging (switch)

For each custom parameter you can set:

Example use case: Add Umwelt mit ValidateSet = Dev,Staging,Production to control which configuration file a caller deploys.

Step 4: Install phase

Write the PowerShell code that runs when DeploymentType = Install. The phase is split into three Monaco code editors:

Editor features:

• Full PowerShell syntax highlighting (Monaco Editor)
• Cmdlet-Vervollständigung — start typing any PSADT v4 cmdlet name and the editor suggests it, including a snippet with required parameters. Type - after a known cmdlet to get parameter suggestions with their types, required flag, description, and valid values.
• Funktions-Builder button — opens a modal to pick a cmdlet, fill in its parameters via form fields (with a file picker populated from your uploaded files), and insert the generated code at the cursor. See Function Builder & Cmdlet Autocomplete.
• Maximize — each editor has a full-screen toggle
• Clear — wipe the section’s content

Example installation code:

## Install the MSI
Start-ADTMsiProcess -FilePath 'MyApp.msi' -Action Install

## Copy configuration file
Copy-ADTFile -Path "$($adtSession.DirFiles)\config.xml" -Destination "$envProgramFiles\MyApp\"

Step 5: Uninstall phase

Same three-section structure (Pre, Main, Post) as the Install Phase. Runs when DeploymentType = Uninstall.

Beispiel:

## Remove the MSI
Uninstall-ADTApplication -Name 'MyApp' -FilterScript { $_.Publisher -eq 'Contoso' }

## Clean up leftover files
Remove-Item -Path "$envProgramFiles\MyApp\config.xml" -Force -ErrorAction SilentlyContinue

Step 6: Repair phase

Same three-section structure. Runs when DeploymentType = Repair. Many packages leave the repair phase empty — that’s fine; PSADT simply runs an empty function.

Step 7: Script preview & test run

Displays the complete generated script in a read-only Monaco editor with PowerShell highlighting. This is exactly what Invoke-AppDeployToolkit.ps1 will contain in your exported package.

Actions on this page:

Test Run uses the same PSADT module and Files/ directory that would ship in the exported zip. It has a 120-second timeout.

Export is available from the Packages Workspace toolbar (not from this page) — see below.

The post Creating a package appeared first on XOAP.

There are three ways to export:

1. Per-package export — from the dashboard, click Export on a package card
2. Batch export — select multiple packages and click the Export toolbar icon
3. HTTP download — when running in a browser (not the desktop app), exports download as {AppVendor}_{AppName}_{Version}_{Arch}.zip through the browser

In the desktop app, exports are written directly to the Standard-Ausgabeordner set in Settings. If that path is empty or invalid, the app falls back to your Downloads folder.

The exported .zip contains everything needed to deploy:

Contoso_MyApp_1.0.0_x64.zip
  Invoke-AppDeployToolkit.ps1     <- Your generated script
  Invoke-AppDeployToolkit.exe     <- PSADT executable stub
  PSAppDeployToolkit/             <- PSADT module
  PSAppDeployToolkit.Extensions/  <- Extensions (if present in toolkit)
  Config/                         <- Configuration
  Strings/                        <- Localization
  SupportFiles/                   <- Support files
  Assets/                         <- Icons
  Files/                          <- Your uploaded files
    MyApp.msi
    config.xml

Free vs Paid: In the paid edition, enabling Include README.md on the Settings → General tab causes a README.md with package metadata, parameters, and phase documentation to be generated and added to the exported zip. The toggle is visible but locked in the free edition.

The post Exporting packages appeared first on XOAP.

Sie können vorhandene PSADT-Pakete (v3 oder v4) importieren aus .zip Dateien.

1. Vom Armaturenbrett, klicke Lokal importieren
2. Eine Schublade öffnet sich; lege einen oder mehrere hinein .zip Dateien (oder zum Durchsuchen klicken)
3. Der Zauberer verarbeitet jeden Reißverschluss und meldet den Status

Für jede Postleitzahl wird der Assistent:

• Erkenne, ob es sich um eine v3 handeltBereitstellen-Anwendung.ps1) oder v4 (Invoke-AppDeployToolkit.ps1Paket
• Parsen Sie das Skript, um Konfigurationswerte für Sitzungen zu extrahieren
• Phaseninhalt extrahieren (Vorher/Haupt/Nach für jeden Bereitstellungstyp)
• Benutzerdefinierte Parameter extrahieren
• Kopieren Dateien/* in das Arbeitsverzeichnis des Pakets
• Füge ein neues Paket zu deinem Arbeitsbereich hinzu (halte dich an das 10-Pakete-Limit)

Für v3-Pakete werden Befehlsnamen und Variablen mithilfe desselben Übersetzungsservices, der auch von den /api/übersetzen Endpunkt.

Nach dem Import können Sie jedes Paket über die normalen Assistentenschritte überprüfen und bearbeiten.

The post Importing existing packages appeared first on XOAP.

Installierte Apps

Die Installierte Apps Seite (/installierte-appsermöglicht Ihnen das Durchsuchen von auf Ihrem Windows-Computer installierter Anwendungen.

Steuerungen

Die Registrierung wird abgefragt von:

• HKLM\Software\Microsoft\Windows\CurrentVersion\Uninstall\ (64-Bit)
• HKLM\Software\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\ (32-Bit)
• HKCU\Software\Microsoft\Windows\CurrentVersion\Uninstall\ (pro Benutzer)

Schnappschuss-Workflow

1. Klicken Sie auf Momentaufnahme machen bevor Sie Ihre Bereitstellung ausführen
2. Führen Sie Ihr PSADT-Paket aus (per Testlauf oder tatsächliche Bereitstellung)
3. Klicken Sie auf Vergleichen um zu sehen, welche Anwendungen installiert, entfernt oder geändert wurden
4. Die Ergebnisse zeigen den Status für jede App und können Ihnen helfen zu überprüfen, ob Ihre Deinstallationsphase alles bereinigt, was Ihre Installationsphase hinzugefügt hat.

The post Installed apps appeared first on XOAP.

Die Protokolle Seite (/protokolle) zeigt die Protokolldateien des API-Servers an.

• Sitzungsauswahl — jedes Mal, wenn die API startet, öffnet sie eine neue Protokolldatei mit dem Namen api-{JJJJ-MM-TT-HHMMSS}.log. Die Dropdown-Liste zeigt alle noch auf der Festplatte vorhandenen Sitzungen an (14 Tage Aufbewahrung).
• Monaco-Betrachter — das ausgewählte Protokoll wird in einem Code-Editor schreibgeschützt dargestellt
• Suche — Zeilen im aktuellen Log filtern
• Automatische Aktualisierung — die aktuelle Sitzungsprotokollierung wird alle 5 Sekunden aktualisiert, sodass Sie die Anforderungen live mitverfolgen können

Dateien werden gespeichert in %AppData%\XOAP\PackageWizard\logs\. Jeder Sitzungsprotokoll hat eine Größenbeschränkung von 10 MB; Dateien, die älter als 14 Tage sind, werden beim Start gelöscht. Ein paralleles Protokoll für die Desktop-Shell (Schreibtisch-{yyyy-MM-dd}.log) existiert im selben Ordner, wird aber in dieser Ansicht nicht angezeigt.

The post Logs appeared first on XOAP.

Tags helfen dir, Pakete im Dashboard zu organisieren. Öffnen Tags aus der Fußzeile der Seitenleiste.

Tags verwalten

• Erstellen Ein Tag mit einem Namen (max. 40 Zeichen), einer Beschreibung (max. 160 Zeichen) und einer Farbe
• Verfügbare Farben: cyan, rosa, Orange, grün, Lila, Indigo
• bearbeiten oder Löschen Tags zu jedem Zeitpunkt. Das Löschen eines Tags entfernt es automatisch aus allen Paketen.

Tags zuweisen

• Klicken Sie vom Dashboard aus auf das Tag-Symbol auf einer Paketkarte oder
• Mehrere Pakete auswählen und klicken Tags zuweisen in der Werkzeugleiste

Jedes Paket kann bis zu 5 Schlagwörter in der kostenlosen Edition. Tags erscheinen als farbige Abzeichen auf Paketkarten und in der Tag-Filterauswahlliste.

The post Tags appeared first on XOAP.

Öffnen Einstellungen aus der Fußzeile der Seitenleiste. Sie ist in drei Seitenreiter unterteilt.

Allgemein

Standardpaketwerte

Dokumentationsoptionen — in der kostenlosen Version gesperrt

Paketspeicherung — gesperrt in der kostenlosen Version

Die Einstellungen speichern Die Schaltfläche oben auf der Seite speichert die Werte des Reiters "Allgemein" und alle ausstehenden Bearbeitungen der Paketkonfiguration in einer einzigen Aktion.

PSADT-Toolkit-Tab

Aktiver Werkzeugkasten für den Export

Zeigt an, welches Toolkit für die Skripterstellung und den Export verwendet wird:

• Quellenangabe — Zoll, Gebündelt, oder Kein Toolkit verfügbar
• Modulversion – erkannt von PSAppDeployToolkit/PSAppDeployToolkit.psd1
• Benutzerdefinierte Erweiterungen enthalten — Abzeichen angezeigt, wenn PSAppDeployToolkit.Erweiterungen ist anwesend
• Aktualisieren — fragt den Server erneut ab

Unterhalb der Statuskarte:

• Automatische Überprüfung von Toolkit-Updates beim Start – schaltet die GitHub-Versionsprüfung beim Start um

Auflösungsreihenfolge (Top-Gewinner):

1. Benutzerdefinierter Tool-Pfad (falls gesetzt und gültig) – kostenpflichtiges Feature (siehe unten)
2. Heruntergeladenes Toolkit in %AppData%\XOAP\PackageWizard\Toolkit\{tag}\
3. Mit dem Installer ausgelieferte Paket-Vorlage

Neueste von GitHub herunterladen

• Groß Neueste PSADT herunterladen Schaltfläche – ruft die neueste Version von ab github.com/PSAppDeployToolkit/PSAppDeployToolkit, extrahiert es (Zip-Slip-geschützt) und legt es als aktives Toolkit fest
• Zeigt das neueste Release-Tag und ein “Update verfügbar”-Badge an, wenn zutreffend

Benutzerdefiniertes Toolkit – in kostenloser Edition gesperrt

In der kostenlosen Version gesperrt. Sowohl die Texteingabe als auch der Button werden angezeigt, sind aber deaktiviert.

Paketkonfigurationstab

Liest Config/config.psd1 aus dem aktiven Toolkit und stellt jeden Abschnitt als Karte dar.

Für jedes Feld zeigt die Benutzeroberfläche:

• Das Feld-Schlüssel (z. B. MSI_LogPfad)
• Jegenslicher Kommentar/Beschreibung, der aus dem .psd1
• Ein Formularsteuerelement, das für den Typ geeignet ist (Texteingabe, Zahleneingabe oder Wahr/Falsch-Schalter)

Ein Feld bearbeiten und klicken Einstellungen speichern (Oben auf der Seite) schreibt die Änderungen zurück config.psd1 (mit Zipslip- / Pfadübergreifender-Schutz). Der Signaturblock wird, falls vorhanden, beim Speichern entfernt.

The post Settings appeared first on XOAP.