functions/core/Start-Logger.ps1
|
function Start-Logger { <# .SYNOPSIS Starts logging .DESCRIPTION Creates new instance of logger, that writes to configured sinks. .PARAMETER LoggerConfig Instance of LoggerConfiguration that is already setup. .PARAMETER MinimumLevel Configures the minimum level at which events will be passed to sinks. All messages with levels beneath this level will be ignored. .PARAMETER Console Setups Console sink. All messages will be writen to console host. .PARAMETER PowerShell Setups PowerShell console sink. All messages will be writen to powershell host. .PARAMETER FilePath Setups File sink at given path. All messages will be written to given file path. .PARAMETER FileRollingInterval The interval at which logging will roll over to a new file. .PARAMETER SetAsDefault Assigns created logger into static static property [Serilog.Log]::Logger that can be used globally. Works only together with PassThru parameter. .PARAMETER PassThru Outputs instance of Serilog.Logger into pipeline .INPUTS Instance of LoggerConfiguration .OUTPUTS None .EXAMPLE PS> New-Logger | Add-SinkConsole | Start-Logger .EXAMPLE PS> Start-Logger .EXAMPLE PS> Start-Logger -MinimumLevel Verbose -Console -FilePath 'C:\Data\test.log' -FileRollingInterval Day #> [Cmdletbinding()] param( [Parameter(Mandatory = $true, ValueFromPipeline = $true, ParameterSetName = 'Full')] [Serilog.LoggerConfiguration]$LoggerConfig, [Parameter(Mandatory = $false, ParameterSetName = 'Short')] [Serilog.Events.LogEventLevel]$MinimumLevel = [Serilog.Events.LogEventLevel]::Information, [Parameter(Mandatory = $false, ParameterSetName = 'Short')] [switch]$Console, [Parameter(Mandatory = $false, ParameterSetName = 'Short')] [switch]$PowerShell, [Parameter(Mandatory = $false, ParameterSetName = 'Short')] [string]$FilePath, [Parameter(Mandatory = $false, ParameterSetName = 'Short')] [Serilog.RollingInterval]$FileRollingInterval = [Serilog.RollingInterval]::Infinite, [Parameter(Mandatory = $false)] [switch]$SetAsDefault, [Parameter(Mandatory = $false)] [switch]$PassThru ) process{ switch ($PsCmdlet.ParameterSetName) { 'Short' { $LoggerConfig = New-Logger | Set-MinimumLevel -Value $MinimumLevel # If file path was not passed we setup default console sink if($PowerShell -or -not $PSBoundParameters.ContainsKey('FilePath')){ $LoggerConfig = $LoggerConfig | Add-SinkPowerShell } if($PSBoundParameters.ContainsKey('Console')){ $LoggerConfig = $LoggerConfig | Add-SinkConsole } if($PSBoundParameters.ContainsKey('FilePath')){ $LoggerConfig = $LoggerConfig | Add-SinkFile -Path $FilePath -RollingInterval $FileRollingInterval } } } $logger = $LoggerConfig.CreateLogger() if($PassThru){ if($SetAsDefault){ [Serilog.Log]::Logger = $logger } $logger } else{ [Serilog.Log]::Logger = $logger } } } |