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.