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.

Create an Boot USB

Create a two-partition OSDCloud USB drive from completed OSDeploy Boot media.

Use New-OSDeployBootUSB to prepare a USB disk from a completed OSDeploy Boot build. The function clears the selected disk, creates boot and data partitions, copies the selected WinPE media, and adds local OSDCloud content when it is available and fits.

Use Update-OSDeployBootUSB when an existing OSDeploy USB drive only needs refreshed boot media or OSDCloud content and its partition layout does not need to change.

Create the USB Drive

1

Confirm the Requirements

Run the function on a workstation that meets these requirements:

  • Windows 11 25H2 build 26200 or later

  • PowerShell 7.6 or later installed from the MSI package

  • Current OSDeploy module

  • Administrator rights

  • curl.exe available in PATH

  • Out-GridView for selecting the build and media folder

  • A completed OSDeploy Boot build under C:\ProgramData\OSDeployCore\boot

  • An online USB disk larger than 7 GB and smaller than 2000 GB

2

Create the Partitions and Copy the Media

Open an elevated PowerShell 7.6 session and run:

New-OSDeployBootUSB

Select an eligible USB disk by number, choose a completed build, and select its bootmedia or bootmedia_ca2023 directory. The default command uses this layout:

Setting
Default

Partition style

MBR

Boot partition

4 GB, FAT32, active

Boot label

OSDEPLOY

Data partition

Remaining space, NTFS

Data label

OSDCloud

Boot media

Interactive selection

Local OSDCloud content

Copy when present and space permits

The 4 GB FAT32 boot partition is fixed. Store larger local operating-system content on the NTFS data partition rather than expanding the boot partition.

The function lists eligible USB disks and prompts for a disk number. It then sets the machine-wide Explorer NoDriveTypeAutorun policy to 0xFF, opens selectors for the completed build and bootmedia or bootmedia_ca2023, clears and converts the disk to MBR, creates both partitions, and copies the selected media. Local content under C:\ProgramData\OSDeployCore\OSDCloud is copied to the NTFS partition when it exists and available space is sufficient.

For labels, selection rules, copy behavior, WhatIf, and returned objects, see New-OSDeployBootUSB. To refresh prepared media without repartitioning, see Update-OSDeployBootUSB. For compact syntax, see the New-OSDeployBootUSB command reference and Update-OSDeployBootUSB command reference.

Last updated

Was this helpful?