Windows PE (WinPE)

Windows PE (WinPE) for Windows 10 is a small operating system used to install, deploy, and repair Windows 10 for desktop editions (Home, Pro, Enterprise, and Education), Windows Server 2016, and other Windows operating systems. From Windows PE, you can:

  • Set up your hard drive before installing Windows.
  • Install Windows by using apps or scripts from a network or a local drive.
  • Capture and apply Windows images.
  • Modify the Windows operating system while it's not running.
  • Set up automatic recovery tools.
  • Recover data from unbootable devices.
  • Add your own custom shell or GUI to automate these kinds of tasks.

windows pe command-line

Where do I download it?

To get Windows PE, use the installer built into the Windows Assessment and Deployment Kit (Windows ADK). For more info, see WinPE: Create USB Bootable drive, WinPE: Create a Boot CD, DVD, ISO, or VHD, or see the Demo: Installing Windows PE on a USB Drive.

Support for many Windows features

Windows PE runs the Windows command line environment, and supports these Windows features:

  • Batch files and scripts, including support for Windows Script Host (WSH), and ActiveX Data Objects (ADO), and optional support for PowerShell.
  • Applications, including Win32 application programming interfaces (APIs) and optional support for HTML Applications (HTA).
  • Drivers, including a generic set of drivers that can run networking, graphics, and mass storage devices.
  • Image capturing and servicing, including Deployment Image Servicing and Management (DISM).
  • Networking, including connecting to file servers using TCP/IP and NetBIOS over TCP/IP via LAN.
  • Storage, including NTFS, DiskPart, and BCDBoot.
  • Security tools, including optional support for BitLocker and the Trusted Platform Module (TPM), Secure Boot, and other tools.
  • Hyper-V, including VHD files, mouse integration, mass storage and network drivers that allow Windows PE to run in a hypervisor.

Hardware requirements

Windows PE has the same requirements as Windows with these exceptions:

  • No hard drive is required. You can run Windows PE entirely from memory.
  • The base version requires only 512MB of memory. (If you add drivers, packages, or apps, you'll need more memory.)
  • In order to boot Windows PE directly from memory (also known as RAM disk boot), a contiguous portion of physical memory (RAM) which can hold the entire Windows PE (WIM) image must be available. To optimize memory use, manufacturers should ensure that their firmware reserves memory locations either at the beginning or at the end of the physical memory address space.

The 32-bit version of Windows PE can boot 32-bit UEFI and BIOS PCs, and 64-bit BIOS PCs.

The 64-bit version of Windows PE can boot 64-bit UEFI and BIOS PCs.

Limitations

Windows PE is not a general-purpose operating system. It may not be used for any purpose other than deployment and recovery. It should not be used as a thin client or an embedded operating system. There are other Microsoft products, such as Windows Embedded CE, which may be used for these purposes.

To prevent its use as a production operating system, Windows PE automatically stops running the shell and restarts after 72 hours of continuous use. This period is not configurable.

When Windows PE reboots, all changes are lost, including changes to drivers, drive letters, and the Windows PE registry. To make lasting changes, see WinPE: Mount and Customize.

The default Windows PE installation uses the FAT32 file format, which poses its own limitations, including a maximum 4GB file size and maximum 32GB drive size. To learn more, see WinPE: Use a single USB key for WinPE and a WIM file (.wim).

Windows PE does not support any of the following:

  • File server or Terminal Server use.
  • Joining to a network domain.
  • Connecting to an IPv4 network from Windows PE on an IPv6 network.
  • Remote Desktop.
  • .MSI installation files.
  • Booting from a path that contains non-English characters.
  • Running 64-bit apps on the 32-bit version of Windows PE.
  • Adding bundled app packages through DISM (.appxbundle packages).

Note In general, use the latest version of WinPE to deploy Windows. If you are using customized WinPE for Windows 10 images, you may prefer to continue using your existing Windows PE image and run the latest version of DISM from a network location. To learn more, see Copy DISM to Another Computer.

Notes on running Windows Setup in Windows PE:

  • You can use the 32-bit versions of Windows PE and Windows Setup to install 64-bit versions of Windows. For more information, see Windows Setup Supported Platforms and Cross-Platform Deployments.
  • Although Windows PE supports dynamic disks, Windows Setup does not. If you install Windows to a dynamic disk created in Windows PE, the dynamic disks won't be available in Windows.
  • For UEFI-based PCs that support both UEFI and legacy BIOS modes, Windows PE needs to be booted in the correct mode in order to correctly install Windows. For more info, see WinPE: Boot in UEFI or legacy BIOS mode.

See also

Content type References

Product evaluation

What's New in Windows PE

Deployment

WinPE: Create USB Bootable drive | Demo: Installing Windows PE on a USB Drive | WinPE: Create a Boot CD, DVD, ISO, or VHD | WinPE: Install on a Hard Drive (Flat Boot or Non-RAM) | WinPE: Boot in UEFI or legacy BIOS mode | Boot to UEFI Mode or Legacy BIOS mode | WinPE: Use a single USB key for WinPE and a WIM file (.wim)

Operations

WinPE: Mount and Customize | WinPE: Add drivers | WinPE: Storage Area Network (SAN) Policy | WinPE: Create Apps | WinPE: Optimize and shrink the image

Troubleshooting

WinPE Network Drivers: Initializing and adding drivers | WinPE: Debug Apps |

Tools and settings

Copype Command-Line Options | Drvload Command-Line Options | Makewinpemedia Command-Line Options | Wpeinit and Startnet.cmd: Using WinPE Startup Scripts | WinPE: Identify drive letters with a script | Wpeutil Command-Line Options | WinPE: Add packages (Optional Components Reference)

Technologies based on Windows PE

Windows Setup | Windows Recovery Environment | Diagnostic and Recovery Toolset