mirror of https://github.com/rbalsleyMSFT/FFU.git synced 2026-06-14 02:09:35 -06:00

Files

T

rbalsleyMSFT c135ad0fba Captures FFU directly from host-mounted VHDX

By optimizing and mounting the VHDX directly on the host for image capture, the build process no longer needs to boot the VM into WinPE, create SMB network shares, generate temporary local accounts, or rely on complex Hyper-V switch IP configurations. This streamlines the workflow and eliminates multiple networking and permission-related points of failure.

This change also removes the need to generate and attach WinPE capture media. All related parameters (`ShareName`, `Username`, `VMHostIPAddress`, `CreateCaptureMedia`, `CleanupCaptureISO`), UI controls, capture scripts, and documentation references have been removed or updated to reflect the simplified architecture.

2026-03-26 22:31:08 -07:00

2.0 KiB

Raw Permalink Blame History

title, nav_order, prev_url, prev_label, next_url, next_label, parent

title	nav_order	prev_url	prev_label	next_url	next_label	parent
Create PE Media	1	/helper_scripts.html	Helper Scripts	/usb_imaging_tool_creator.html	USB Imaging Tool Creator	Helper Scripts

Create PE Media

Create-PEMedia.ps1 is a standalone helper script that creates WinPE deployment ISO files outside the main build flow.

This is useful when admins need to quickly generate a deploy ISO for a share (or local staging folder) that technicians will use with USBImagingToolCreator.ps1.

Common use case

If your staging location does not already have a deployment ISO, run Create-PEMedia.ps1 to generate one, then copy that ISO to the staging folder used by your technicians.

Prerequisites

Run from an elevated PowerShell session.
Windows ADK + WinPE add-on must be installed (default path: C:\Program Files (x86)\Windows Kits\10\).
Script should be run from the FFUDevelopment folder (or provide explicit paths via parameters).

Quick start (deploy ISO)

From FFUDevelopment, this creates a deploy ISO by default:

.\Create-PEMedia.ps1

Default output file:

.\WinPE_FFU_Deploy_x64.iso

Useful commands

Create deploy ISO for x64:

.\Create-PEMedia.ps1 -WindowsArch 'x64'

Create deploy ISO for ARM64:

.\Create-PEMedia.ps1 -WindowsArch 'arm64' -DeployISO "$PSScriptRoot\WinPE_FFU_Deploy_arm64.iso"

Create deploy ISO and include PE drivers from .\PEDrivers:

.\Create-PEMedia.ps1 -CopyPEDrivers $true

Stage output for USB imaging

After creating the deploy ISO, place it in the same staging root used for USB media creation.

Example:

\\Server\FFUStaging\
  WinPE_FFU_Deploy_x64.iso
  FFU\
    <image files>.ffu
  Drivers\
    <optional driver content>

Then technicians can run:

.\USBImagingToolCreator.ps1 -DeployISOPath "\\Server\FFUStaging\WinPE_FFU_Deploy_x64.iso" -DisableAutoPlay

Logging

Create-PEMedia.ps1 writes log output to:

.\Create-PEMedia.log (or custom path via -LogFile)

{% include page_nav.html %}

2.0 KiB Raw Permalink Blame History