> 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/command-reference/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 at least 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>] [-WhatIf] [-Confirm]
```

## 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`.  |
| `-WhatIf`    | `Switch` | No       | Preview the destructive disk-preparation operation after interactive selections.   |
| `-Confirm`   | `Switch` | No       | Confirm the destructive disk-preparation operation.                                |

## 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, and the optional `goal` query parameter:

```
GET https://www.osdeploy.com/command-reference/osdeploy/new-osdeploybootusb.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.