Edit

Share via


Disable-SbecBcd

Disables the event forwarding mode in BCD settings.

Syntax

Offline

Disable-SbecBcd
    -Path <String[]>
    [-Id <String>]
    [-DismLogPath <String>]
    [<CommonParameters>]

Online

Disable-SbecBcd
    -ComputerName <String[]>
    [-Credential <PSCredential>]
    [-Id <String>]
    [<CommonParameters>]

OnlineSession

Disable-SbecBcd
    -Session <PSSession[]>
    [-Id <String>]
    [<CommonParameters>]

Local

Disable-SbecBcd
    [-Local]
    [-BcdStore <String>]
    [-Id <String>]
    [<CommonParameters>]

Description

The Disable-SbecBcd cmdlet disables the Boot Configuration Data (BCD) /event flag. This operation has no effect on the current connections; you must reboot the computer for the settings to take effect.

You can apply these changes to the local computer, to a remote computer, or to an offline disk image.

To operate on a local computer, specify the Local parameter. Enabling forwarding on the computer that runs the Collector service makes sense only if it sends the data to a Collector on a different computer. Otherwise, the in-kernel module is not able to connect to the Collector. However, you can copy the PowerShell BootEventCollector module to the other computers, where you can use it for local configuration.

To operate on a remote computer, specify either the ComputerName or Session parameter. Windows PowerShell remoting is used to perform the remote operations.

To operate on an offline (WIM or VHD) image, use the Path parameter. WIM images do not normally contain the BCD files, and there is rarely a need to replace them there. Instead, Windows Setup creates the BCD settings when it extracts the image from WIM to the hard drive.

Examples

Example 1: Disable BCD

PS C:\> Disable-SbecBcd -Session $MyPSSession

This command disables the BCD settings on a remote session.

Parameters

-BcdStore

Specifies the full path of the BCD store.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Local
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ComputerName

Specifies the names of the computers on which you want to perform the operation. You can specify a fully qualified domain name (FQDN), a NetBIOS name, or an IP address for each computer. For more information, see Invoke-CimMethod on TechNet.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Online
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Credential

Specifies a user account that has permission to perform this action. The default is the current user.

Parameter properties

Type:PSCredential
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Online
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DismLogPath

Specifies the path of the file for the Deployment Image Servicing and Management (DISM) log when mounting images.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Offline
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Id

Specifies the ID of the entry to disable, without the curly braces.

The BCD settings may contain entries for multiple boot images (when a computer has multiple operating system versions installed). When the settings for an operating system other than the currently running one (or the default operating system in an offline image) must be modified, you can use this parameter to select the entry.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Local

Indicates that this operation occurs on the local computer. This mode also allows the extra control over the BCD store of where the settings are applied.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Local
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Path

Specifies the list of full paths to the offline Windows image files (WIM or VHD) to which to apply the settings. If a WIM file contains multiple images, all of them are modified.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Offline
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Session

Specifies the PSSession objects connected to the remote target computers. Enter a session object, such as the output of the Get-PSSession or New-PSSession cmdlet, or an array of these objects.

Parameter properties

Type:

PSSession[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

OnlineSession
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

None.

Outputs

None.