tests/general/Help.Example.Parameters.Tests.ps1

$excludeCommands = @(
    'Invoke-D365LogicAppMessage'
    , 'Invoke-D365SCDPBundleInstall'
    , 'Test-D365Command'
    , 'Test-PathExists'
)

$excludeParameters = @(
    'EnableException'
    , 'TrustedConnection'
    , 'Force'
    , 'Temporary'
    , 'OutputCommandOnly'
    , 'ShowOriginalProgress'
    , 'OutputAsHashtable'
    , 'LogPath'
)

$commandsRaw = Get-Command -Module d365fo.tools

if ($excludeCommands.Count -gt 0) {
    $commands = $commandsRaw | Select-String -Pattern $excludeCommands -SimpleMatch -NotMatch

}
else {
    $commands = $commandsRaw
}

foreach ( $commandName in $commands) {
    if ($commandName -notlike "*d365*") {
        continue
    }
    
    # command to be tested

    # get all examples from the help
    $examples = Get-Help $commandName -Examples

    $parameters = (Get-Help $commandName -Full).parameters

    # make a describe block that will contain tests for this
    Describe "Parameters without default vaules from $commandName" {
        
        foreach ($parm in $parameters.parameter) {
            if ($parm.defaultValue -ne "False") { continue }
            
            $parmName = $parm.name
            
            if ($parmName -in $excludeParameters) { continue }

            $res = $false

            foreach ($exampleObject in $examples.Examples.Example) {
                if ($res) { continue }

                $example = $exampleObject.Code -replace "`n.*" -replace "PS C:\\>"

                $res = $example -match "-$parmName( *|\:)"
            }

            It "$parmName is present in an example" {
                $res | Should -BeTrue
            }
        }
    }
}