> For the complete documentation index, see [llms.txt](https://www.osdeploy.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.osdeploy.com/powershell-modules/osdeploy/new-osdeploybootusb.md).

# New-OSDeployBootUSB

Creates a new bootable OSDeploy USB drive from an OSDeployCore BootImage build.

| Property | Value                                                                 |
| -------- | --------------------------------------------------------------------- |
| Module   | OSDeploy                                                              |
| Platform | Windows 11 (amd64 / arm64)                                            |
| Requires | Run as Administrator, a completed BootImage build, a USB drive ≥ 7 GB |

## Description

Prepares a USB drive for use as an OSDeploy bootable device. The function:

* Prompts for selection of a completed BootImage from `%ProgramData%\OSDeployCore\boot`
* Prompts for the specific bootmedia folder (`bootmedia` or `bootmedia_ca2023`)
* Selects a suitable USB disk (7 GB–2 TB) via an interactive picker
* Clears, partitions (MBR), and formats the selected disk:
  * 4 GB FAT32 active boot partition (labeled with `-BootLabel`)
  * NTFS remaining-space data partition (labeled with `-DataLabel`)
* Copies the selected BootMedia to the FAT32 partition

{% hint style="danger" %}
This function clears and repartitions the selected USB disk. All existing data on the disk will be destroyed. Use `Update-OSDeployBootUSB` to refresh an existing OSDeploy USB without reformatting.
{% endhint %}

## Syntax

```powershell
New-OSDeployBootUSB [-BootLabel <String>] [-DataLabel <String>]
```

## Parameters

| Parameter    | Type     | Required | Description                                                                        |
| ------------ | -------- | -------- | ---------------------------------------------------------------------------------- |
| `-BootLabel` | `String` | No       | Volume label for the FAT32 boot partition. Max 11 characters. Default: `OSDEPLOY`. |
| `-DataLabel` | `String` | No       | Volume label for the NTFS data partition. Max 32 characters. Default: `OSDCloud`.  |

## Examples

```powershell
# Create a new OSDeploy USB using default partition labels
New-OSDeployBootUSB
```

```powershell
# Create a new OSDeploy USB with custom partition labels
New-OSDeployBootUSB -BootLabel 'WinPE' -DataLabel 'WinPE-Data'
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://www.osdeploy.com/powershell-modules/osdeploy/new-osdeploybootusb.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.