Private/1-FunctionTemplate.ps1

<#
.SYNOPSIS
Selects or keeps the lab's break-glass account.
 
.DESCRIPTION
Selects or keeps the lab's break-glass account. This account is excluded from all
attack scenarios and is not considered in any attack path or risk evaluation.
 
.COMPONENT
Category: Main Function
 
.FUNCTIONALITY
Selects or retains the configured break-glass account for exclusion from attack scenarios.
#>

function New-FunctionTemplate {

    $Info = Measure-FunctionRuntime -Begin
    Write-AS2GoOutput -Type Header -Message "Define a Break Glass Account"
    Write-AS2GoOutput -Type H1 -Message $((get-help (Get-FunctionName)).Functionality)

    #start main code
    $previousDN = Get-ASConfig -Setting "BreakGlassAccount"

    If ($previousDN -match 'OU=|CN=|DC=' ) {
        $previousCN = Convert-FromDNToCN -DistinguishedName $previousDN
        $HelpP = "Use the scope from previous selection/attack."
        $message = "Use current account ($previousCN) or select new:"
        Write-AS2GoOutput -Type TextMaker -Message "Current Break Glass Account:" -Tm $previousCN
    }
    else {
        $message = "Select new Break Glass Account:"
        $HelpP = $null
    }

    $Title = "Break Glass Account - Define Target Account"

    $Options = @(
        [pscustomobject] @{ Label = "&Previous Break Glass Account"; Help = $HelpP ; Value = "Previous" },
        [pscustomobject] @{ Label = "&New Break Glass Account"; Help = "Choose a dedicated Break Glass Account."; Value = "New" }
    )
    $Decision = Show-DecisionPrompt -Message $message  -Options $Options -Default 0 -Title $Title

    If ($Decision -eq "New") {
        $result = Select-ADObject -Title $Title -IncludeUsers -MarkTier0
        Set-ASConfig -Setting "BreakGlassAccount" -Value $result
        $result = Convert-FromDNToCN -DistinguishedName $result
        Write-AS2GoOutput -Type TextMaker -Message "New Break Glass Account:" -Tm $result
    }
    else {
        Write-AS2GoOutput -Type Info -message "Keep previous Break Glass Account!"    
    }   
    #end main code
    
    Measure-FunctionRuntime -End -Details $Info 
}