Enable-SbecBootImage
Enables AutoLogger settings in offline WinPE Setup images.
Syntax
Enable-SbecBootImage
[-Path] <String[]>
[[-Logger] <String[]>]
[[-PermLogger] <String[]>]
[-NoDefaultLoggers]
[[-DismLogPath] <String>]
[<CommonParameters>] Description
The Enable-SbecBootImage cmdlet enables the AutoLogger settings and creates the Winpeshl.ini files in offline WinPE Setup images to forward events to the Setup and Boot Event Collector.
The default event log sessions that are configured for sending events to the Boot Event Collector are NT Kernel Logger, EventLog-System, and SetupPlatform. You can configure other loggers with the parameters Logger and PermLogger. Loggers are always switched to real-time mode, regardless of whether they previously wrote to a file.
The AutoLogger settings enable event forwarding during the first stage of Setup when it boots from the WinPE image. The Winpeshl.ini files facilitate the configuration of events on the HDD image through Unattend.xml.
Examples
Example 1: Enable Boot Event Collector in a WIM image
PS C:\> Enable-SbecBootImage -Path "C:\Images\Boot.wim"This command enables the Boot Event Collector for the Boot.wim image.
Parameters
-DismLogPath
Specifies the path of the Deployment Image Servicing and Management (DISM) log file to use when mounting images.
| Type: | String |
| Position: | 3 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Logger
Specifies the AutoLogger sessions for which to enable forwarding. The forwarding on these sessions auto-disables after the operating system starts. Specifying a session explicitly in Logger or PermLogger overrides the defaults for it.
| Type: | String[] |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoDefaultLoggers
Indicates that this operation does not automatically add the default set of logger sessions.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Specifies an array of full paths to the offline Windows image (WIM or VHD) files to which to apply the settings. If a WIM file contains multiple images, all of them are modified.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PermLogger
Specifies the AutoLogger sessions for which to enable forwarding. The forwarding on these sessions remains enabled after the operating system starts. Specifying a session explicitly in Logger or PermLogger overrides the defaults for it.
| Type: | String[] |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
None.
Outputs
None.