If you are using Windows PowerShell, you must use quotes around the boot entry identifier, for example: «<49916baf-0e08-11db-9af4-000bdbd316a0>« or ««.

Use the command line help to view options

Use the command line help for BCDEdit to display information available for a specific version of Windows.

The following sections describe some common datatypes and their associated values.

Boot Settings

bootlog [ yes | no ]
Enables the system initialization log. This log is stored in the Ntbtlog.txt file in the %WINDIR% directory. It includes a list of loaded and unloaded drivers in text format.

bootmenupolicy [ Legacy | Standard ]
Defines the type of boot menu the system will use. ForWindowsВ 10, WindowsВ 8.1, WindowsВ 8 and WindowsВ RT the default is Standard. For Windows ServerВ 2012В R2, Windows ServerВ 2012, the default is Legacy. When Legacy is selected, the Advanced options menu (F8) is available. When Standard is selected, the boot menu appears but only under certain conditions: for example, if there is a startup failure, if you are booting up from a repair disk or installation media, if you have configured multiple boot entries, or if you manually configured the computer to use Advanced startup. When Standard is selected, the F8 key is ignored during boot. WindowsВ 8 PCs start up quickly so there isn’t enough time to press F8. For more information, see Windows Startup Settings (including safe mode).

The option is available starting with WindowsВ 8 and Windows ServerВ 2012. You can also use the onetimeadvancedoptions to use the Advanced options (F8) menu (Legacy) one time on the next boot.

bootstatuspolicy policy

Controls the boot status policy. The boot status policy can be one of the following:

quietboot [ on | off ]
Controls the display of a high-resolution bitmap in place of the Windows boot screen display and animation.

Do not use the quietboot option in WindowsВ 8 as it will prevent the display of bug check data in addition to all boot graphics.

sos [ on | off ]
Controls the display of the names of the drivers as they load during the boot process. Use sos on to display the names. Use sos off to suppress the display.

lastknowngood [ on | off ]
Enables boot to last known good configuration.

nocrashautoreboot [ on | off ]
Disables automatic restart on crash.

resumeobject (id)
Defines the identifier of the resume object that is associated with this operating system object.

safebootalternateshell [ on | off ]
Uses the alternate shell when booted into Safe mode.

winpe [ on | off ]
Enables the computer to boot to Windows PE.

onetimeadvancedoptions [ on | off ]
Controls whether the system boots to the legacy menu (F8 menu) on the next boot.

Display Settings

bootuxdisabled [ on | off ]
Disables boot graphics.

graphicsmodedisabled [ on | off ]
Indicates whether graphics mode is disabled and boot applications must use text mode display.

graphicsresolution
Defines the graphics resolution, 1024×768, 800×600,1024×600, etc.

highestmode [ on | off ]
Enables boot applications to use the highest graphical mode exposed by the firmware.

novga [ on | off ]
Disables the use of VGA modes entirely.

vga [ on | off ]
Forces the use of the VGA display driver.

Hardware Abstraction Layer (HAL) & KERNEL

hal file
Directs the operating system loader to load an alternate HAL file. The specified file must be located in the %SystemRoot%\system32 directory.

kernel file
Directs the operating system loader to load an alternate kernel. The specified file must be located in the %SystemRoot%\system32 directory.

Verification Settings

testsigning [ on | off ]
Controls whether WindowsВ 10, WindowsВ 8.1, WindowsВ 8, Windows 7, Windows Server 2008, or Windows Vista will load any type of test-signed kernel-mode code. This option is not set by default, which means test-signed kernel-mode drivers on 64-bit versions of WindowsВ 10, WindowsВ 8.1, WindowsВ 8, Windows 7, Windows Server 2008, and Windows Vista will not load by default. After you run the BCDEdit command, restart the computer so that the change takes effect. For more information, see Introduction to Test-Signing

nointegritychecks [ on | off ] Disables integrity checks. Cannot be set when secure boot is enabled. This value is ignored by Windows 7 and WindowsВ 8.

disableelamdrivers [ yes | no ]
Controls the loading of Early Launch Antimalware (ELAM) drivers. The OS loader removes this entry for security reasons. This option can only be triggered by using the F8 menu. Someone must be physically present (at the computer) to trigger this option.

This option should only be used for debugging.

nx [Optin |OptOut | AlwaysOn |AlwaysOff]
Enables, disables, and configures Data Execution Prevention (DEP), a set of hardware and software technologies designed to prevent harmful code from running in protected memory locations. For information about DEP settings, see Data Execution Prevention.

Processor Settings

groupsize maxsize
Sets the maximum number of logical processors in a single processor group, where maxsize is any power of 2 between 1 and 64 inclusive. By default, processor groups have a maximum size of 64 logical processors. You can use this boot configuration setting to override the size and makeup of a computer’s processor groups for testing purposes. Processor groups provide support for computers with greater than 64 logical processors. This boot option is available on 64-bit versions of Windows 7 and Windows Server 2008 R2 and later versions. This boot option has no effect on the 32-bit versions of Windows 7.

Use the groupsize option if you want to force multiple groups and the computer has 64 or fewer active logical processors. For more information about using this option, see Boot Parameters to Test Drivers for Multiple Processor Group Support.

groupaware [ on | off ]
Forces drivers to be aware of multiple groups in a multiple processor group environment. Use this option to help expose cross-group incompatibilities in drivers and components. Processor groups provide support for computers with greater than 64 logical processors. This boot option is available on 64-bit versions of Windows 7 and Windows Server 2008 R2 and later versions. This boot option has no effect on the 32-bit versions of Windows 7. You can use the groupaware option and the groupsize option to test driver compatibility to function with multiple groups when computer has 64 or fewer active logical processors.

The groupaware on setting ensures that processes are started in a group other than group 0. This increases the chances of cross-group interaction between drivers and components. The option also modifies the behavior of the legacy functions, KeSetTargetProcessorDpc, KeSetSystemAffinityThreadEx, and KeRevertToUserAffinityThreadEx, so that they always operate on the highest numbered group that contains active logical processors. Drivers that call any of these legacy functions should be changed to call their group-aware counterparts (KeSetTargetProcessorDpcEx, KeSetSystemGroupAffinityThread, and KeRevertToUserGroupAffinityThread).

maxgroup [ on | off ]
Maximizes the number of groups created in a processor group configuration. The maxgroup on setting assigns NUMA nodes to groups in a manner that maximizes the number of groups for a particular computer. The number of groups created is either the number of NUMA nodes the computer has, or the maximum number of groups supported by this version of Windows, whichever is smaller. The default behavior (maxgroup off) is to pack the NUMA nodes tightly into as few groups as possible.

Use the maxgroup option if you want to use multiple groups, the computer has 64 or fewer active logical processors, and the computer already has multiple NUMA nodes. This option can also be used to alter the default group configuration of a computer that has more than 64 logical processors.

Processor groups provide support for computers with greater than 64 logical processors. This option is available on 64-bit versions of Windows 7 and Windows Server 2008 R2 and later versions. This boot option has no effect on the 32-bit versions of Windows 7.

onecpu [ on | off ]
Forces only the boot CPU to be used in a computer that has more than one logical processor. For example, the following command configures the current operating system loader to use one processor.

Memory Related Settings

increaseuserva Megabytes
Specifies the amount of memory, in megabytes, for user-mode virtual address space.

On 32-bit editions of Windows, applications have 4 gigabyte (GB) of virtual address space available. The virtual address space is divided so that 2 GB is available to the application and the other 2 GB is available only to the system.

The 4-gigabyte tuning feature, enabled with the increaseuserva option, allows you to increase the virtual address space that is available to the application up to 3 GB, which reduces the amount available to the system to between 1 and 2 GB. The BCEdit /set increaseuserva Megabytes command can specify any value between 2048 (2 GB) and 3072 (3 GB) megabytes in decimal notation. Windows uses the remaining address space (4 GB minus the specified amount) as its kernel-mode address space.

See 4-Gigabyte Tuning (Windows) for additional information about this feature.

nolowmem [ on | off ] Controls the use of low memory. When nolowmem on is specified, this option loads the operating system, device drivers, and all applications into addresses above the 4 GB boundary, and directs Windows to allocate all memory pools at addresses above the 4 GB boundary. Note that the nolowmem option is ignored in WindowsВ 8, Windows ServerВ 2012, and later versions of Windows.

pae [ Default | ForceEnable | ForceDisable ]
Enables or disables Physical Address Extension (PAE). When PAE is enabled, the system loads the PAE version of the Windows kernel.

The pae parameter is valid only on boot entries for 32-bit versions of Windows that run on computers with x86-based and x64-based processors. On 32-bit versions of Windows (prior to WindowsВ 8) , PAE is disabled by default. However, Windows automatically enables PAE when the computer is configured for hot-add memory devices in memory ranges beyond the 4 GB region, as defined by the Static Resource Affinity Table (SRAT). Hot-add memory supports memory devices that you can add without rebooting or turning off the computer. In this case, because PAE must be enabled when the system starts, it is enabled automatically so that the system can immediately address extended memory that is added between restarts. Hot-add memory is supported only on Windows Server 2008, Datacenter Edition; Windows Server 2008 for Itanium-Based Systems; and on the datacenter and enterprise editions of all later versions of Windows Server. Moreover, for versions of Windows prior to Windows Server 2008, hot-add memory is supported only on computers with an ACPI BIOS, an x86 processor, and specialized hardware. For Windows Server 2008 and later versions of Windows Server, it is supported for all processor architectures.

On a computer that supports hardware-enabled Data Execution Prevention (DEP) and is running a 32-bit version of the Windows operating system that supports DEP, PAE is automatically enabled when DEP is enabled and, on all 32-bit versions of the Windows operating system, except Windows Server 2003 with SP1, PAE is disabled when you disable DEP. To enable PAE when DEP is disabled, you must enable PAE explicitly, by using /set nx AlwaysOff and /set pae ForceEnable. For more information about DEP, see Boot Parameters to Configure DEP and PAE.

For more information about using the pae parameter and the other parameters that affect PAE configuration, see Boot Parameters to Configure DEP and PAE.

removememory Megabytes
Removes memory from the total available memory that the operating system can use.

For example, the following command removes 256 MB of memory from the total available to the operating system associated with the specified boot entry.

truncatememory address Limits the amount of physical memory available to Windows. When you use this option, Windows ignores all memory at or above the specified physical address. Specify the address in bytes.

For example, the following command sets the physical address limit at 1 GB. You can specify the address in decimal (1073741824) or hexadecimal (0x40000000).

Additional Settings

disabledynamictick [ yes | no ]
Enables and disables dynamic timer tick feature.

This option should only be used for debugging.

forcelegacyplatform [ yes | no ]
Forces the OS to assume the presence of legacy PC devices like CMOS and keyboard controllers.

This option should only be used for debugging.

pciexpress [ default | forcedisable]
Enables or disables PCI Express functionality. If the computer platform supports the PCI Express features and the ACPI _OSC method grants control of the features to the operating system, Windows enables the advanced features through the PCI Express Native Control feature (this is the default). Use the forcedisable option to override the advanced PCI Express features and use legacy PCI Express behavior. For more information, see Enabling PCI Express Native Control in Windows.

tpmbootentropy [ default | ForceEnable | ForceDisable]
Determines whether entropy is gathered from the trusted platform module (TPM) to help seed the random number generator in the operating system.

tscsyncpolicy [ Default | Legacy | Enhanced ]
Controls the times stamp counter synchronization policy. This option should only be used for debugging.

usefirmwarepcisettings [ yes | no ]
Enables or disables the use of BIOS-configured peripheral component interconnect (PCI) resources.

useplatformclock [ yes | no ]
Forces the use of the platform clock as the system’s performance counter.

This option should only be used for debugging.

uselegacyapicmode [ yes | no ]
Used to force legacy APIC mode, even if the processors and chipset support extended APIC mode.

useplatformtick [ yes | no ]
Forces the clock to be backed by a platform source, no synthetic timers are allowed. The option is available starting in WindowsВ 8 and Windows ServerВ 2012.

This option should only be used for debugging.

xsavedisable [ 0 | 1 ]
When set to a value other than zero (0), disables XSAVE processor functionality in the kernel.

x2apicpolicy [ enable | disable ]
Enables or disables the use of extended APIC mode, if supported. The system defaults to using extended APIC mode if it is available.

Debugger Settings

To work with the debugger settings, use the following commands.

Hypervisor Debugger Settings

Use the BCDEdit / hypervisorsettings option to set or display the hypervisor debugger settings for the system. For more information, see BCDEdit /hypervisorsettings.

hypervisordebug [ On | Off ]
Controls whether the hypervisor debugger is enabled.

Hypervisor Settings

hypervisoriommupolicy [ default | enable | disable]
Controls whether the hypervisor uses an Input Output Memory Management Unit (IOMMU).

hypervisorlaunchtype [ Off | Auto ]
Controls the hypervisor launch options. If you are setting up a debugger to debug Hyper-V on a target computer, set this option to Auto on the target computer. For more information, see Create a Virtual Machine with Hyper-V.

hypervisorloadoptions NOFORCESNOOP [ Yes | No ]
Specifies whether the hypervisor should enforce snoop control on system IOMMUs.

hypervisornumproc number
Specifies the total number of logical processors that can be started in the hypervisor.

hypervisorrootproc number
Specifies the maximum number of virtual processors in the root partition and limits the number of post-split Non-Uniform Memory Architecture (NUMA) nodes which can have logical processors started in the hypervisor.

hypervisorrootprocpernode number
Specifies the total number of virtual processors in the root partition that can be started within a pre-split Non-Uniform Memory Architecture (NUMA) node.

hypervisoruselargevtlb [ yes | no]
Increases virtual Translation Lookaside Buffer (TLB) size.

Emergency Management Services

The BCDEdit /ems option enables or disables Emergency Management Services (EMS) for the specified operating system boot entry. For more information, see BCDEdit /ems.

The BCDEdit /emssettings option sets the global Emergency Management Services (EMS) settings for the computer. For more information, see For more information, see BCDEdit /emssettings.

Event Logging

The BCDEdit /event command enables or disables the remote event logging for the specified boot entry. For more information, see BCDEdit /event.

Comments

For more information about specific BCD elements and boot options, you can use the commands BCDEdit /? OSLOADER and BCDEdit /? TYPES OSLOADER.

To view the current boot entries and their settings, use the bcdedit /enum command. This command displays the active boot entries and their associated globally unique identifiers (GUID). Use the identifiers with the /set command to configure options for a specific boot entry.

To delete a boot option value that you have set, use the /deletevalue option. The syntax for the command is as follows:

bcdedit /deletevalue [ ] datatatype