Sequences

A sequence is a JSON list of steps executed in order by the TaskSequence engine, from disk partitioning through to post-install scripts.

Structure

{
  "name": "Windows 11 Pro — Standard domain workstation",
  "steps": [
    { "type": "FormatDisk",  "params": { "diskIndex": 0 } },
    { "type": "ApplyWIM",    "params": { "wimImage": "Win11-Pro-23H2.wim", "index": 1 } },
    { "type": "JoinDomain",  "params": { "domain": "corp.local" }, "reboot": true },
    { "type": "WindowsUpdate", "reboot": true, "continueOnError": true },
    { "type": "Software",    "params": { "apps": ["app-chrome", "app-sap-gui"] } },
    { "type": "Script",      "params": { "path": "\\\\SERVER\\Scripts\\Set-PrinterHR.ps1" } }
  ]
}

Common step properties

Property	Type	Description
type	string	Step type (FormatDisk, ApplyWIM, JoinDomain, WindowsUpdate, Software, Script, …)
params	object	Step-specific parameters
reboot	bool	If true, the machine reboots after this step and the sequence resumes automatically
continueOnError	bool	If true, a failure in this step doesn't stop the sequence

Step types

Type	Role
FormatDisk	Partitions and formats the target disk
ApplyWIM	Applies the WIM image to the formatted volume
JoinDomain	Joins the Active Directory domain
WindowsUpdate	Installs pending Windows updates
Software	Installs catalogue applications
Script	Runs an arbitrary PowerShell script

Reboot handling

Resuming after a reboot is done via a RunOnce registry key that relaunches Start-Deploy.ps1 -Resume on next boot. The anti-loop guard (WinPE.MaxReboots in PSWinDeploy.psd1) stops the sequence if the number of reboots exceeds the configured threshold.

Visual editor

A drag-and-drop editor is available in the web interface, on the "Sequences" page. It lets you:

• Reorder steps by dragging them
• Choose step types from a categorized palette (Infra / Network / Software / System)
• Edit parameters in a contextual properties panel
• See reboot (R) and continue-on-error (CE) indicators at a glance
• View the live JSON output
• Export the sequence as .json and save it via the API