mirror of
https://github.com/MicrosoftDocs/windows-itpro-docs.git
synced 2025-05-12 13:27:23 +00:00
Merge pull request #10752 from paolomatarazzo/pm-20250408-unbranded-boot
Unbranded boot
This commit is contained in:
Ruchika Mittal
GitHub
commit
858687a7f8
14
includes/licensing/unbranded-boot.md
Normal file
14
includes/licensing/unbranded-boot.md
Normal file
@ -0,0 +1,14 @@
|
||||
---
|
||||
author: paolomatarazzo
|
||||
ms.author: paoloma
|
||||
ms.date: 04/09/2025
|
||||
ms.topic: include
|
||||
---
|
||||
|
||||
### Windows edition requirements
|
||||
|
||||
The following list contains the Windows editions that support Unbranded Boot:
|
||||
|
||||
✅ Enterprise / Enterprise LTSC\
|
||||
✅ Education\
|
||||
✅ IoT Enterprise / IoT Enterprise LTSC
|
||||
7
windows/configuration/images/icons/xml.svg
Normal file
7
windows/configuration/images/icons/xml.svg
Normal file
@ -0,0 +1,7 @@
|
||||
<svg width="18" height="18" viewBox="0 0 18 18" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||||
<path d="M3.46385 12.006L1.41972 14.0625L3.46272 16.11L2.66735 16.9054L0.224976 14.4596V13.6643L2.66622 11.2129L3.46385 12.006ZM9.79985 11.2185L9.01235 12.0161L11.0666 14.0625L9.00672 16.11L9.79985 16.9076L12.2625 14.463V13.6654L9.79985 11.2185ZM4.5281 17.2598L5.59685 17.6153L7.84685 10.8653L6.7781 10.5098L4.5281 17.2598Z" fill="#0883D9"/>
|
||||
<g opacity="0.75">
|
||||
<path d="M15.5858 4.66425L12.2108 1.28925L11.8125 1.125H2.8125L2.25 1.6875V10.125H3.375V2.25H11.25V5.625H14.625V15.75H12.5618L11.43 16.875H15.1875L15.75 16.3125V5.0625L15.5858 4.66425Z" fill="#0883D9"/>
|
||||
<path opacity="0.1" d="M15.1875 5.0625V16.3125H11.9959L13.3875 14.931V13.1985L10.125 10.125H2.8125V1.6875H11.8125L15.1875 5.0625Z" fill="#0883D9"/>
|
||||
</g>
|
||||
</svg>
|
||||
|
After Width: | Height: | Size: 820 B |
Binary file not shown.
|
Before Width: | Height: | Size: 15 KiB |
BIN
windows/configuration/unbranded-boot/images/boot.png
Normal file
BIN
windows/configuration/unbranded-boot/images/boot.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 9.1 KiB |
@ -1,113 +1,119 @@
|
||||
---
|
||||
title: Unbranded Boot
|
||||
description: Unbranded Boot
|
||||
ms.date: 09/10/2024
|
||||
ms.topic: overview
|
||||
description: Learn about Unbranded Boot, a feature that suppresses Windows elements that appear when Windows starts. Unbranded Boot can also suppress the crash screen when Windows encounters an error that it can't recover from.
|
||||
ms.date: 04/09/2025
|
||||
ms.topic: how-to
|
||||
---
|
||||
|
||||
# Unbranded Boot
|
||||
|
||||
You can suppress Windows elements that appear when Windows starts or resumes and can suppress the crash screen when Windows encounters an error that it can't recover from. This feature is known as Unbranded Boot.
|
||||
Unbranded Boot is a Windows feature that allows you to suppress Windows elements that appear when Windows starts. It can also suppress the crash screen when Windows encounters an error that it can't recover from. This feature is useful for devices that are used in public spaces, such as kiosks and digital signs, where a clean and professional appearance is important.
|
||||
|
||||
[!INCLUDE [unbranded-boot](../../../includes/licensing/unbranded-boot.md)]
|
||||
|
||||
## Enable Unbranded Boot
|
||||
|
||||
Unbranded Boot is an optional component and isn't enabled by default in Windows. To configure it, you must first enable it.
|
||||
|
||||
There are different ways to enable Unbranded Boot, select the method that best fits your needs to learn more.
|
||||
|
||||
#### [:::image type="icon" source="../images/icons/control-panel.svg"::: **Control Panel**](#tab/control-panel1)
|
||||
|
||||
To enable Unbranded Boot using the Control Panel, follow these steps:
|
||||
|
||||
1. Open **Control Panel** > **Programs** > **Turn Windows features on or off** or use the command `optionalfeatures.exe`
|
||||
1. Expand **Device Lockdown** and select **Unbranded Boot**
|
||||
1. Select **OK** to enable Unbranded Boot
|
||||
1. Restart your device to apply the changes
|
||||
|
||||
#### [:::image type="icon" source="../images/icons/powershell.svg"::: **PowerShell**](#tab/powershell1)
|
||||
|
||||
To enable Unbranded Boot using PowerShell, follow these steps:
|
||||
|
||||
1. Open a PowerShell window with administrator privileges
|
||||
1. Run the following command:
|
||||
```powershell
|
||||
Enable-WindowsOptionalFeature -FeatureName Client-DeviceLockdown,Client-EmbeddedBootExp -Online
|
||||
```
|
||||
1. Restart your device to apply the changes
|
||||
|
||||
---
|
||||
|
||||
> [!IMPORTANT]
|
||||
> The first user to sign in to the device must be an administrator. This ensures that the **RunOnce** registry settings correctly apply the settings. Also, when using auto sign-in, you must not configure auto sign-in on your device at design time. Instead, auto sign-in should be configured manually after first signing in as an administrator.
|
||||
|
||||
## Requirements
|
||||
## Configure Unbranded Boot
|
||||
|
||||
Unbranded Boot can be enabled on:
|
||||
The following instructions provide details about how to configure your devices. Select the option that best suits your needs.
|
||||
|
||||
- Windows 10 Enterprise
|
||||
- Windows 10 IoT Enterprise
|
||||
- Windows 10 Education
|
||||
- Windows 11 Enterprise
|
||||
- Windows 11 IoT Enterprise
|
||||
- Windows 11 Education
|
||||
#### [:::image type="icon" source="../images/icons/cmd.svg"::: **Command prompt**](#tab/cmd)
|
||||
|
||||
## Terminology
|
||||
You can use the `bcdedit.exe` command to configure Unbranded Boot settings at runtime.
|
||||
|
||||
- **Turn on, Enable:** To make the setting available to the device and optionally apply the settings to the device. Generally "turn on" is used in the user interface or control panel, whereas "enable" is used for command line.
|
||||
> [!NOTE]
|
||||
> `Bcdedit.exe` is a command-line tool for editing the Boot Configuration Data (BCD) of Windows. Administrator privileges are required to use BCDEdit to modify the BCD.
|
||||
|
||||
- **Configure:** To customize the setting or subsettings.
|
||||
|
||||
- **Embedded Boot Experience:** this feature is called "Embedded Boot Experience" in Windows 10, build 1511.
|
||||
|
||||
- **Custom Boot Experience:** this feature is called "Custom Boot Experience" in Windows 10, build 1607 and later.
|
||||
|
||||
## Turn on Unbranded Boot settings
|
||||
|
||||
Unbranded Boot is an optional component and isn't enabled by default in Windows. It must be enabled prior to configuring.
|
||||
|
||||
If Windows has already been installed, you can't apply a provisioning package to configure Unbranded Boot; instead you must use BDCEdit to configure Unbranded boot if Windows is installed.
|
||||
|
||||
BCDEdit is the primary tool for editing the Boot Configuration Database (BCD) of Windows and is included in Windows in the %WINDIR%\\System32 folder. Administrator privileges are required to use BCDEdit to modify the BCD.
|
||||
|
||||
### Turn on Unbranded Boot by using Control Panel
|
||||
|
||||
1. In the Windows search bar, type **Turn Windows features on or off** and either press **Enter** or tap or select **Turn Windows features on or off** to open the **Windows Features** window.
|
||||
1. In the **Windows Features** window, expand the **Device Lockdown** node, and select (to turn on) or clear (to turn off) the checkbox for **Unbranded Boot**.
|
||||
1. Select **OK**. The **Windows Features** window indicates that Windows is searching for required files and displays a progress bar. Once found, the window indicates that Windows is applying the changes. When completed, the window indicates the requested changes are completed.
|
||||
1. Restart your device to apply the changes.
|
||||
|
||||
## Configure Unbranded Boot settings at runtime using BCDEdit
|
||||
|
||||
1. Open a command prompt as an administrator.
|
||||
1. Run the following command to disable the F8 key during startup to prevent access to the **Advanced startup options** menu.
|
||||
1. Open a command prompt as an administrator
|
||||
1. Run the following command to disable the F8 key during startup to prevent access to the **Advanced startup options** menu
|
||||
|
||||
```cmd
|
||||
bcdedit.exe -set {globalsettings} advancedoptions false
|
||||
```
|
||||
|
||||
1. Run the following command to disable the F10 key during startup to prevent access to the **Advanced startup options** menu.
|
||||
1. Run the following command to disable the F10 key during startup to prevent access to the **Advanced startup options** menu
|
||||
|
||||
```cmd
|
||||
bcdedit.exe -set {globalsettings} optionsedit false
|
||||
```
|
||||
|
||||
1. Run the following command to suppress all Windows UI elements (logo, status indicator, and status message) during startup.
|
||||
1. Run the following command to suppress all Windows UI elements (logo, status indicator, and status message) during startup
|
||||
|
||||
```cmd
|
||||
bcdedit.exe -set {globalsettings} bootuxdisabled on
|
||||
```
|
||||
|
||||
1. Run the following command to suppress any error screens that are displayed during boot. If **noerrordisplay** is on and the boot manager hits a *WinLoad Error* or *Bad Disk Error*, the system displays a black screen.
|
||||
1. Run the following command to suppress any error screens that are displayed during boot. If **noerrordisplay** is on and the boot manager hits a *WinLoad Error* or *Bad Disk Error*, the system displays a black screen
|
||||
|
||||
```cmd
|
||||
bcdedit.exe -set {bootmgr} noerrordisplay on
|
||||
```
|
||||
|
||||
## Configure Unbranded Boot using Unattend
|
||||
#### [:::image type="icon" source="../images/icons/xml.svg"::: **Unattend**](#tab/unattend)
|
||||
|
||||
You can also configure the Unattend settings in the [Microsoft-Windows-Embedded-BootExp](/windows-hardware/customize/desktop/unattend/microsoft-windows-embedded-bootexp) component to add Unbranded Boot features to your image during the design or imaging phase. You can manually create an Unattend answer file or use Windows System Image Manager (Windows SIM) to add the appropriate settings to your answer file. For more information about the Unbranded Boot settings and XML examples, see the settings in Microsoft-Windows-Embedded-BootExp.
|
||||
You can configure the Unattend settings in the `Microsoft-Windows-Embedded-BootExp` component to add Unbranded Boot features to your image during the design or imaging phase. You can manually create an Unattend answer file or use Windows System Image Manager (Windows SIM) to add the appropriate settings to your answer file. For more information about the Unbranded Boot settings and XML examples, see the settings in [Microsoft-Windows-Embedded-BootExp](/windows-hardware/customize/desktop/unattend/microsoft-windows-embedded-bootexp).
|
||||
|
||||
### Unbranded Boot settings
|
||||
|
||||
The following table shows Unbranded Boot settings and their values.
|
||||
The following table lists Unbranded Boot settings and their values.
|
||||
|
||||
| Setting | Description | Value |
|
||||
|---------|-------------|-------|
|
||||
| DisableBootMenu | Contains an integer that disables the F8 and F10 keys during startup to prevent access to the Advanced startup options menu. | Set to 1 to disable the menu; otherwise; set to 0 (zero). The default value is 0. |
|
||||
| DisplayDisabled | Contains an integer that configures the device to display a blank screen when Windows encounters an error that it can't recover from. | Set to 1 to display a blank screen on error; otherwise; set to 0 (zero). The default value is 0. |
|
||||
| HideAllBootUI | Contains an integer that suppresses all Windows UI elements (logo, status indicator, and status message) during startup. | Set to 1 to suppress all Windows UI elements during startup; otherwise; set to 0 (zero). The default value is 0. |
|
||||
| HideBootLogo | Contains an integer that suppresses the default Windows logo that displays during the OS loading phase. | Set to 1 to suppress the default Windows logo; otherwise; set to 0 (zero). The default value is 0. |
|
||||
| HideBootStatusIndicator | Contains an integer that suppresses the status indicator that displays during the OS loading phase. | Set to 1 to suppress the status indicator; otherwise; set to 0 (zero). The default value is 0. |
|
||||
| HideBootStatusMessage | Contains an integer that suppresses the startup status text that displays during the OS loading phase. | Set to 1 to suppress the startup status text; otherwise; set to 0 (zero). The default value is 0. |
|
||||
| `DisableBootMenu` | Contains an integer that disables the F8 and F10 keys during startup to prevent access to the *Advanced startup options* menu. | - Set to `1` to disable the menu<br>- The default value is `0`|
|
||||
| `DisplayDisabled` | Contains an integer that configures the device to display a blank screen when Windows encounters an error that it can't recover from. | - Set to `1` to display a blank screen on error<br>- The default value is `0`|
|
||||
| `HideAllBootUI` | Contains an integer that suppresses all Windows UI elements (logo, status indicator, and status message) during startup. | - Set to `1` to suppress all Windows UI elements during startup<br>- The default value is `0`|
|
||||
| `HideBootLogo` | Contains an integer that suppresses the default Windows logo that displays during the OS loading phase. | - Set to `1` to suppress the default Windows logo<br>- The default value is `0`|
|
||||
| `HideBootStatusIndicator` | Contains an integer that suppresses the status indicator that displays during the OS loading phase. | - Set to `1` to suppress the status indicator<br>- The default value is `0`|
|
||||
| `HideBootStatusMessage` | Contains an integer that suppresses the startup status text that displays during the OS loading phase. | - Set to `1` to suppress the startup status text<br>- The default value is `0`|
|
||||
|
||||
## Customize the boot screen using Windows Configuration Designer and Deployment Image Servicing and Management (DISM)
|
||||
#### [:::image type="icon" source="../images/icons/provisioning-package.svg"::: **PPKG**](#tab/ppkg)
|
||||
|
||||
You must enable Unbranded boot on the installation media with DISM before you can apply settings for Unbranded boot using either Windows Configuration Designer or applying a provisioning package during setup.
|
||||
Customize the boot screen using Windows Configuration Designer and Deployment Image Servicing and Management (DISM).
|
||||
|
||||
1. Create a provisioning package or create a new Windows image in Windows Configuration Designer by following the instructions in [Create a provisioning package](/windows/configuration/provisioning-packages/provisioning-create-package).
|
||||
You must enable Unbranded Boot on the installation media with DISM before you can apply settings for Unbranded Boot using either Windows Configuration Designer or applying a provisioning package during setup.
|
||||
|
||||
1. In the Available customizations page, select **Runtime settings** > **SMISettings** and then set the value for the boot screen settings. The following values are just examples.
|
||||
If Windows is already installed, you can't apply a provisioning package to configure Unbranded Boot. You must use the command prompt to configure Unbranded Boot if Windows is installed.
|
||||
|
||||
- **HideAllBootUI**=FALSE
|
||||
- **HideBootLogo**=FALSE
|
||||
- **HideBootStatusIndicator**=TRUE
|
||||
- **HideBootStatusMessage**=TRUE
|
||||
- **CrashDumpEnabled**=Full dump
|
||||
[!INCLUDE [provisioning-package-1](../../../includes/configure/provisioning-package-1.md)]
|
||||
|
||||
> [!TIP]
|
||||
> For more information, see [SMISettings](/windows/configuration/wcd/wcd-smisettings) in the Windows Configuration Designer reference.
|
||||
|Path|Value|
|
||||
|---|---|
|
||||
|`Runtime settings/SMISettings/HideAllBootUI`| `TRUE` or `FALSE`|
|
||||
|`Runtime settings/SMISettings/HideBootLogo`| `TRUE` or `FALSE`|
|
||||
|`Runtime settings/SMISettings/HideBootStatusIndicator`| `TRUE` or `FALSE`|
|
||||
|`Runtime settings/SMISettings/HideBootStatusMessage`| `TRUE` or `FALSE`|
|
||||
|
||||
> [!TIP]
|
||||
> For more information, see [SMISettings](/windows/configuration/wcd/wcd-smisettings) in the Windows Configuration Designer reference.
|
||||
|
||||
1. Once you have finished configuring the settings and building the package or image, you use DISM to apply the settings.
|
||||
1. Open a command prompt with administrator privileges.
|
||||
@ -136,25 +142,16 @@ You must enable Unbranded boot on the installation media with DISM before you ca
|
||||
dism /unmount-wim /MountDir:c:\wim /Commit
|
||||
```
|
||||
|
||||
In the following image, the BootLogo is outlined in green, the BootStatusIndicator is outlined in red, and the BootStatusMessage is outlined in blue.
|
||||
---
|
||||
|
||||
|
||||
In the following image:
|
||||
|
||||
1. `BootLogo` is outlined in green, the
|
||||
1. `BootStatusIndicator` is outlined in red
|
||||
1. `BootStatusMessage` is outlined in blue
|
||||
|
||||
:::image type="content" source="images/boot.png" alt-text="Screenshot of the boot screen showing the areas that can be configured with Unbranded Boot." border="false":::
|
||||
|
||||
## Replace the startup logo
|
||||
|
||||
The only supported way to replace the startup logo with a custom logo is to modify the Boot Graphics Resource Table (BGRT) on a device that uses UEFI as the firmware interface. If your device uses the BGRT to include a custom logo, it's always displayed and you can't suppress the custom logo.
|
||||
|
||||
## Suppress Errors During Boot
|
||||
|
||||
Errors that occur during early Windows Boot are typically a sign of bad device configuration or failing hardware and require user intervention to recover. You can suppress all error screens during early boot by enabling the **noerrordisplay** BCD setting.
|
||||
|
||||
1. Open a command prompt as an administrator.
|
||||
1. Run the following command to suppress error screens during boot.
|
||||
|
||||
```cmd
|
||||
bcdedit.exe -set {bootmgr} noerrordisplay on
|
||||
```
|
||||
|
||||
## Related articles
|
||||
|
||||
- [Custom Logon](../custom-logon/index.md)
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user