OSDeploy PSModule and site pages are currently in preview until mid-September
For the complete documentation index, see llms.txt. This page is also available as Markdown.

PC Requirements

Prepare a Windows 11 PC with the software required to build OSDeploy boot media.

Prepare a Windows 11 workstation with PowerShell 7, Hyper-V, and the modules required to create and test OSDeploy boot media.

Complete the Setup

1

Confirm the Requirements

Use a PC with:

  • Windows 11 25H2, build 26200 or later

  • amd64 architecture

  • Local administrative rights

  • At least 50 GB of free space on the system volume

  • Internet access

Windows 11 on arm64 can potentially be used, but it is not fully tested. Other Windows client versions and Windows Server are unsupported.

2

Update Windows and Enable Hyper-V

Open Windows PowerShell as an administrator, open Windows Update, and install all available cumulative updates:

Start-Process 'ms-settings:windowsupdate'

On a physical Windows 11 Pro, Enterprise, or Education PC with hardware virtualization enabled, enable Hyper-V:

Enable-WindowsOptionalFeature -Online -FeatureName 'Microsoft-Hyper-V-All' -All -NoRestart

Restart Windows before continuing.

3

Install PowerShell 7

Download the latest stable amd64 or arm64 .msi from PowerShell releases. Run the MSI and enable the recommended installation options, including adding PowerShell to PATH and enabling Microsoft Update.

Open PowerShell 7 as an administrator by running pwsh. Confirm that the session uses PowerShell Core 7.6 or later and that $PSHOME is under $env:ProgramFiles\PowerShell\7:

$PSVersionTable | Select-Object PSEdition, PSVersion
$PSHOME
4

Install the Required Modules

Install OSDeploy and OSDCloud from the elevated PowerShell 7 session:

Install-Module -Name OSDeploy -Force -SkipPublisherCheck
Install-Module -Name OSDCloud -Force -SkipPublisherCheck

Install OSD only when a workflow requires legacy OSD or OSDCloud v1 commands.

5

Register the OSDeploy PC

Complete Community Registration and confirm that Show-OSDeployLicense returns a valid Recast Software Community License. Registration is required while the OSDeploy module is in preview.

See the detailed instructions for Windows 11, PowerShell 7, and PowerShell modules.

Last updated

Was this helpful?