Public/Server/New-KrServer.ps1
|
<# .SYNOPSIS Creates a new Kestrun server instance. .DESCRIPTION This function initializes a new Kestrun server instance with the specified name and logger. .PARAMETER Name The name of the Kestrun server instance to create. .PARAMETER Logger An optional Serilog logger instance to use for logging. It's mutually exclusive with the LoggerName parameter. If not specified, the default logger will be used. .PARAMETER LoggerName An optional name of a registered logger to use for logging. It's mutually exclusive with the Logger parameter. If specified, the logger with this name will be used instead of the default logger. .PARAMETER PassThru If specified, the cmdlet will return the created server instance. .PARAMETER Force If specified, the cmdlet will overwrite any existing server instance with the same name. .EXAMPLE New-KrServer -Name "MyKestrunServer" Creates a new Kestrun server instance with the specified name. .NOTES This function is designed to be used in the context of a Kestrun server setup. #> function New-KrServer { [KestrunRuntimeApi('Definition')] [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseShouldProcessForStateChangingFunctions', '')] [CmdletBinding(DefaultParameterSetName = 'Logger')] [OutputType([Kestrun.Hosting.KestrunHost])] param( [Parameter(Mandatory = $true, ValueFromPipeline = $true)] [string]$Name, [Parameter(Mandatory = $false, ParameterSetName = 'Logger')] [Serilog.ILogger]$Logger, [Parameter(Mandatory = $true, ParameterSetName = 'LoggerName')] [string]$LoggerName, [Parameter()] [switch]$PassThru, [Parameter()] [switch]$Force ) process { $loadedModules = Get-KrUserImportedModule $modulePaths = @($loadedModules | ForEach-Object { $_.Path }) if ([Kestrun.KestrunHostManager]::Contains($Name) ) { if ($Force) { if ([Kestrun.KestrunHostManager]::IsRunning($Name)) { [Kestrun.KestrunHostManager]::Stop($Name) } [Kestrun.KestrunHostManager]::Destroy($Name) } else { $confirm = Read-Host "Server '$Name' is running. Do you want to stop and destroy the previous instance? (Y/N)" if ($confirm -notin @('Y', 'y')) { Write-Warning 'Operation cancelled by user.' exit 1 } if ([Kestrun.KestrunHostManager]::IsRunning($Name)) { [Kestrun.KestrunHostManager]::Stop($Name) } [Kestrun.KestrunHostManager]::Destroy($Name) } } # If Logger is not provided, use the default logger or the named logger if ($Null -eq $Logger) { if ([string]::IsNullOrEmpty($LoggerName)) { $Logger = [Serilog.Log]::Logger } else { # If LoggerName is specified, get the logger with that name $Logger = [Kestrun.Logging.LoggerManager]::Get($LoggerName) } } $server = [Kestrun.KestrunHostManager]::Create($Name, $Logger, [string[]] $modulePaths) if ($PassThru.IsPresent) { # if the PassThru switch is specified, return the server instance # Return the modified server instance return $Server } } } |