Write-KrVerboseLog

SYNOPSIS

Writes Verbose log message

SYNTAX

MsgTemp (Default)

Write-KrVerboseLog [-Message] <String> [-Name <String>] [-Exception <Exception>] [-Values <Object[]>]
 [-PassThru] [<CommonParameters>]

ErrRec

Write-KrVerboseLog [[-Message] <String>] [-Name <String>] [-Exception <Exception>] -ErrorRecord <ErrorRecord>
 [-Values <Object[]>] [-PassThru] [<CommonParameters>]

DESCRIPTION

Write a log event with the Verbose level.

EXAMPLES

EXAMPLE 1

Write-KrVerboseLog 'Verbose log message' -Values 'value1', 'value2'
This example logs a verbose message with two property values.

EXAMPLE 2

Write-KrVerboseLog -Message 'Processed {@Position} in {Elapsed:000} ms.' -Values $position, $elapsedMs
This example logs a verbose message with formatted properties.

EXAMPLE 3

Write-KrVerboseLog 'Error occurred' -Exception ([System.Exception]::new('Some exception'))
This example logs a verbose message with an exception.

PARAMETERS

-Message

Message template describing the event.

Type: String
Parameter Sets: MsgTemp
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

Type: String
Parameter Sets: ErrRec
Aliases:

Required: False
Position: 1
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Name

Name of the logger to use. If not specified, the default logger is used.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Exception

Exception related to the event.

Type: Exception
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ErrorRecord

ErrorRecord related to the event.

Type: ErrorRecord
Parameter Sets: ErrRec
Aliases: ER

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Values

Objects positionally formatted into the message template.

Type: Object[]
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PassThru

Outputs Message populated with Values into pipeline.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

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

INPUTS

Message - Message template describing the event.

OUTPUTS

None or Message populated with Values into pipeline if PassThru specified.

NOTES

This function is part of the Kestrun logging framework and is used to log verbose messages. It can be used in scripts and modules that utilize Kestrun for logging.

RELATED LINKS