| | | 1 | | <# |
| | | 2 | | .SYNOPSIS |
| | | 3 | | Reads a Service.psd1 descriptor file. |
| | | 4 | | .DESCRIPTION |
| | | 5 | | Reads Service.psd1 and returns a normalized object with FormatVersion, Name, Description, Version, EntryPoint, Servi |
| | | 6 | | .PARAMETER Path |
| | | 7 | | Descriptor path. Accepts either a descriptor file path or a directory path. |
| | | 8 | | When a directory path is provided, Service.psd1 is appended automatically. |
| | | 9 | | .EXAMPLE |
| | | 10 | | Get-KrServiceDescriptor |
| | | 11 | | #> |
| | | 12 | | function Get-KrServiceDescriptor { |
| | | 13 | | [KestrunRuntimeApi('Everywhere')] |
| | | 14 | | [CmdletBinding()] |
| | | 15 | | [OutputType([pscustomobject])] |
| | | 16 | | param( |
| | | 17 | | [Parameter()] |
| | | 18 | | [ValidateNotNullOrEmpty()] |
| | | 19 | | [string]$Path = 'Service.psd1' |
| | | 20 | | ) |
| | | 21 | | |
| | 1 | 22 | | $fullPath = [System.IO.Path]::GetFullPath($Path) |
| | 1 | 23 | | if (Test-Path -LiteralPath $fullPath -PathType Container) { |
| | 1 | 24 | | $fullPath = Join-Path -Path $fullPath -ChildPath 'Service.psd1' |
| | | 25 | | } |
| | | 26 | | |
| | 2 | 27 | | if (-not (Test-Path -LiteralPath $fullPath -PathType Leaf)) { |
| | 0 | 28 | | throw "Descriptor file not found: $fullPath" |
| | | 29 | | } |
| | 1 | 30 | | $descriptor = Import-PowerShellDataFile -LiteralPath $fullPath |
| | 2 | 31 | | if (-not $descriptor -or -not ($descriptor -is [hashtable])) { |
| | 0 | 32 | | throw "Descriptor file '$fullPath' is not a valid hashtable." |
| | | 33 | | } |
| | 2 | 34 | | $normalizedDescriptor = Test-KrServiceDescriptorData -Descriptor $descriptor -DescriptorPath $fullPath -PackageRoot |
| | 1 | 35 | | if (-not $normalizedDescriptor) { |
| | 0 | 36 | | throw "Descriptor file '$fullPath' failed validation." |
| | | 37 | | } |
| | | 38 | | |
| | 1 | 39 | | $preservePaths = @() |
| | 1 | 40 | | if ($normalizedDescriptor.PSObject.Properties.Match('PreservePaths').Count -gt 0 -and $null -ne $normalizedDescripto |
| | 2 | 41 | | $preservePaths = @($normalizedDescriptor.PreservePaths) |
| | | 42 | | } |
| | | 43 | | |
| | 1 | 44 | | $applicationDataFolders = @() |
| | 1 | 45 | | if ($normalizedDescriptor.PSObject.Properties.Match('ApplicationDataFolders').Count -gt 0 -and $null -ne $normalized |
| | 2 | 46 | | $applicationDataFolders = @($normalizedDescriptor.ApplicationDataFolders) |
| | | 47 | | } |
| | | 48 | | |
| | 1 | 49 | | $props = $normalizedDescriptor.PSObject.Properties |
| | | 50 | | |
| | 2 | 51 | | [pscustomobject]([ordered]@{ |
| | 1 | 52 | | FormatVersion = [string]$normalizedDescriptor.FormatVersion |
| | 1 | 53 | | Path = $fullPath |
| | 1 | 54 | | Name = [string]$normalizedDescriptor.Name |
| | 3 | 55 | | Description = if ($props['Description']) { [string]$normalizedDescriptor.Description } else { $null } |
| | 1 | 56 | | Version = if ($props['Version'] -and -not [string]::IsNullOrWhiteSpace($normalizedDescriptor.Version)) { |
| | 1 | 57 | | [string]$normalizedDescriptor.Version |
| | | 58 | | } else { |
| | 1 | 59 | | $null |
| | | 60 | | } |
| | 3 | 61 | | EntryPoint = if ($props['EntryPoint']) { [string]$normalizedDescriptor.EntryPoint } else { $null } |
| | 3 | 62 | | ServiceLogPath = if ($props['ServiceLogPath']) { [string]$normalizedDescriptor.ServiceLogPath } else { $null |
| | 1 | 63 | | PreservePaths = $preservePaths |
| | 1 | 64 | | ApplicationDataFolders = $applicationDataFolders |
| | | 65 | | }) |
| | | 66 | | } |