NSP.Toolkit

0.1.1

Public/Start-NSPToolkit.ps1

function Start-NSPToolkit {
    <#
    .SYNOPSIS
        The single entry point: a menu of every NSP operator tool. Picking one installs its module
        from the PowerShell Gallery if needed, then starts it.
 
    .DESCRIPTION
        Relaunches elevated first (the tools change AD, NPS and the CA). Tools that apply to this
        machine - NPS on an NPS server, PKI on a CA - are marked. -Tool skips the menu.
        Needs NSP.Console and NSP.Bootstrap; they are loaded on first use.
 
    .PARAMETER Tool
        Start this tool directly (AD, NPS, PKI, FortiClient).
 
    .PARAMETER NoElevate
        Do not relaunch elevated.
 
    .EXAMPLE
        Start-NSPToolkit
 
    .EXAMPLE
        Start-NSPToolkit -Tool NPS
    #>
    [CmdletBinding()]
    param(
        [string]$Tool,
        [switch]$NoElevate
    )

    Import-NSPToolkitModule -Name NSP.Bootstrap -MinimumVersion 0.1.3
    Import-NSPToolkitModule -Name NSP.Console -MinimumVersion 0.1.2

    if (-not $NoElevate) {
        # By path, so a checkout or -ModuleRoot copy relaunches the same build, not an installed one.
        $manifest = (Join-Path $script:ModuleRoot 'NSP.Toolkit.psd1').Replace("'", "''")
        $relaunch = "Import-Module '$manifest'; Start-NSPToolkit"
        if ($Tool) { $relaunch += " -Tool '$($Tool.Replace("'", "''"))'" }
        if (Invoke-NSPElevated -Command $relaunch -NoExit) { return }
    }

    if ($Tool) {
        $null = Get-NSPToolDefinition -Tool $Tool
        Invoke-NSPToolkitTool -Tool $Tool
        return
    }

    while ($true) {
        Clear-NSPConsole
        $toolkitVersion = (Get-Module NSP.Toolkit | Sort-Object Version -Descending | Select-Object -First 1).Version
        Write-NSPConsoleHeader -Title 'NSP Toolkit' -Subtitle "$env:COMPUTERNAME v$toolkitVersion"
        Write-NSPConsoleLine ''
        $tools = @(Get-NSPToolkitTool)
        $choices = foreach ($t in $tools) {
            $status = if ($t.Installed) { "installed v$($t.Installed)" } else { 'not installed - picking it installs it' }
            $mark = if ($t.Applies) { " [applies here: $($t.DetectHint)]" } else { '' }
            [pscustomobject]@{ Label = $t.DisplayName + $mark; Value = $t.Name; Help = "$($t.Description) ($($t.ModuleName), $status)" }
        }
        $pick = Read-NSPMenu -Choices $choices -Prompt 'Start a tool' -CancelLabel 'Quit'
        if ($null -eq $pick) { return }
        try { Invoke-NSPToolkitTool -Tool $pick }
        catch {
            Write-NSPConsoleLine "Could not start ${pick}: $($_.Exception.Message)" -Role Error
            Read-Host 'Press Enter to return to the menu' | Out-Null
        }
    }
}