COMMAND EVERYTHING.

Enable-SbecWdsBcd

Enables the BCD settings in the offline boot images imported into the WDS server.

PowerShell · Risk: High · Documentation Verified

Last verified: 2026-10-26

Microsoft BootEventCollector reference: Enables the BCD settings in the offline boot images imported into the WDS server. The syntax and selected example below are adapted from the pinned Windows Server 2025 reference. Module availability, target configuration and delegated permissions determine whether it can run in your environment. Documentation and parameter text: Microsoft, CC BY 4.0; formatting adapted by Cmdlet World. No execution testing is claimed.

Enable-SbecWdsBcd -BcdPath <String[]> -CollectorIp <String> -CollectorPort <UInt32> -Key <String>
 [-BusParameters <String>] [-WdsRoot <String>] [-SkipNotifyWds] [<CommonParameters>]

Copied 0 times

Required permissions

Use an account with the target resource permissions documented for Enable-SbecWdsBcd. Modifying administrative cmdlets may require elevation or delegated administration. This catalog does not assert that ordinary users can execute the command.

Supported environments

Windows / BootEventCollector · Windows Server 2025 documentation; feature/module prerequisites apply

Parameters

-BcdPath (required): Specifies the explicit path of the per-image BCD file(s).
-BusParameters: Specifies the bus parameters to use to select the NIC of the target computer for communication. This value overrides the default choice of the first supported adapter. This value applies to all the computers that use this image; it can be used only if the hardware of these computers is sufficiently homogeneous. To find the value of bus parameters for a specific NIC on a machine, open Device Manager, and in Network Adapters select the desired device. Right-click the device, select Properties, select the Details tab, and then select Location information. It will display a string of the form PCI bus X, device Y, function Z. The bus parameter to specify in this example is "X,Y,Z".
-CollectorIp (required): Specifies the IPv4 address of the host on which the Boot Event Collector is located.
-CollectorPort (required): Specifies the port number (common for the target and collector).
-Image: Specifies the Windows Deployment Services (WDS) Boot Image object(s) obtained from Get-WdsBootImage. You can also specify a manually constructed hash table instead of an object if it contains the Architecture and FileName properties.
-Key (required): Specifies the encryption key for the communication. This value must match the key specified in the collector configuration for this target.
-SkipNotifyWds: Indicates that this operation does not notify the WDS service about the changed files.
-WdsRoot: Specifies the root of the WDS directory tree. By default, this value is obtained from the path of the exported SMB share REMINST.

Prerequisites

Windows with the BootEventCollector module and the Windows feature or management tools that provide it. Confirm target connectivity and version compatibility using the linked Microsoft reference.

Security considerations

This cmdlet changes system state. Review every target and parameter in the official reference, test outside production, and prepare an appropriate backup or rollback. Do not execute the example automatically.

Examples

Example 2: Update a BCD file

Enable-SbecWdsBcd -BcdPath "c:\tmp\boot.wim.bcd" -CollectorIp "192.168.1.1" -CollectorPort 50000 -Key "a.b.c.d" -SkipNotifyWds

This command updates the settings on a BCD file copied from WDS. Source: Microsoft, CC BY 4.0; transcript prompt/output removed. This example was not executed.

Sources

https://github.com/MicrosoftDocs/windows-powershell-docs/blob/b7645dd8c687139b28e845119da30ec670526507/docset/winserver2025-ps/BootEventCollector/Enable-SbecWdsBcd.md

https://learn.microsoft.com/powershell/module/booteventcollector/enable-sbecwdsbcd?view=windowsserver2025-ps

Personal collections

Explain or customize this command with AI

Related commands