Enable-Sbec
Boot
Image
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.
Required Parameters
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Optional Parameters
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Indicates that this operation does not automatically add the default set of logger sessions.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
None.
Outputs
None.