Merge pull request #10768 from paolomatarazzo/pm-20250411

[Unbranded Boot] minor fixes for consistency
This commit is contained in:
Padma Jayaraman 2025-04-11 17:40:07 +05:30 committed by GitHub
commit f5f364b75e
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -1,7 +1,7 @@
--- ---
title: Unbranded Boot title: Unbranded Boot
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. 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.date: 04/11/2025
ms.topic: how-to ms.topic: how-to
--- ---
@ -46,6 +46,9 @@ To enable Unbranded Boot using PowerShell, follow these steps:
The following instructions provide details about how to configure your devices. Select the option that best suits your needs. The following instructions provide details about how to configure your devices. Select the option that best suits your needs.
> [!NOTE]
> If Windows is already installed, you can't apply a provisioning package to configure Unbranded Boot. Instead, you must use the command prompt to configure Unbranded Boot.
#### [:::image type="icon" source="../images/icons/cmd.svg"::: **Command prompt**](#tab/cmd) #### [:::image type="icon" source="../images/icons/cmd.svg"::: **Command prompt**](#tab/cmd)
You can use the `bcdedit.exe` command to configure Unbranded Boot settings at runtime. You can use the `bcdedit.exe` command to configure Unbranded Boot settings at runtime.
@ -72,7 +75,7 @@ You can use the `bcdedit.exe` command to configure Unbranded Boot settings at ru
bcdedit.exe -set {globalsettings} bootuxdisabled on 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 set to `on` and the boot manager hits a *WinLoad Error* or *Bad Disk Error*, the system displays a black screen
```cmd ```cmd
bcdedit.exe -set {bootmgr} noerrordisplay on bcdedit.exe -set {bootmgr} noerrordisplay on
@ -80,7 +83,7 @@ You can use the `bcdedit.exe` command to configure Unbranded Boot settings at ru
#### [:::image type="icon" source="../images/icons/xml.svg"::: **Unattend**](#tab/unattend) #### [:::image type="icon" source="../images/icons/xml.svg"::: **Unattend**](#tab/unattend)
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). 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.
### Unbranded Boot settings ### Unbranded Boot settings
@ -95,14 +98,14 @@ The following table lists Unbranded Boot settings and their values.
| `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`| | `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`| | `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`|
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).
#### [:::image type="icon" source="../images/icons/provisioning-package.svg"::: **PPKG**](#tab/ppkg) #### [:::image type="icon" source="../images/icons/provisioning-package.svg"::: **PPKG**](#tab/ppkg)
Customize the boot screen using Windows Configuration Designer and Deployment Image Servicing and Management (DISM). Customize the boot screen using Windows Configuration Designer and Deployment Image Servicing and Management (DISM).
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. 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.
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.
[!INCLUDE [provisioning-package-1](../../../includes/configure/provisioning-package-1.md)] [!INCLUDE [provisioning-package-1](../../../includes/configure/provisioning-package-1.md)]
|Path|Value| |Path|Value|
@ -115,38 +118,33 @@ If Windows is already installed, you can't apply a provisioning package to confi
> [!TIP] > [!TIP]
> For more information, see [SMISettings](/windows/configuration/wcd/wcd-smisettings) in the Windows Configuration Designer reference. > 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. Once you finish to configure the settings and building the package or image, use DISM to apply the settings:
1. Open a command prompt with administrator privileges.
1. Copy install.wim to a temporary folder on hard drive (in the following steps, it assumes it's called c:\\wim).
1. Create a new directory.
```cmd 1. Open a command prompt with administrator privileges
md c:\wim 1. Copy `install.wim` to a temporary folder on the hard drive (for example, `c:\wim`)
``` 1. Create a new directory to mount the image:
1. Mount the image. ```cmd
md c:\wim
```cmd ```
dism /mount-wim /wimfile:c:\bootmedia\sources\install.wim /index:1 /MountDir:c:\wim 1. Mount the image:
``` ```cmd
dism /mount-wim /wimfile:c:\bootmedia\sources\install.wim /index:1 /MountDir:c:\wim
1. Enable the feature. ```
1. Enable the feature:
```cmd ```cmd
dism /image:c:\wim /enable-feature /featureName:Client-EmbeddedBootExp dism /image:c:\wim /enable-feature /featureName:Client-EmbeddedBootExp
``` ```
1. Commit the change:
1. Commit the change. ```cmd
dism /unmount-wim /MountDir:c:\wim /Commit
```cmd ```
dism /unmount-wim /MountDir:c:\wim /Commit
```
--- ---
In the following image: In the following image:
1. `BootLogo` is outlined in green, the 1. `BootLogo` is outlined in green
1. `BootStatusIndicator` is outlined in red 1. `BootStatusIndicator` is outlined in red
1. `BootStatusMessage` is outlined in blue 1. `BootStatusMessage` is outlined in blue