Consider adding a way to programmatically retrieve if PreReqs are met

We use the Atomic Red Team & Invoke-AtomicRedTeam Projects within our CI pipeline in BLUESPAWN . This gives us at least some automated insight into the current coverage of BLUESPAWN and visibility into any possible regressions in detection logic.

Recently, we started having some of the tests fail and exit because the prerequisites were not met, ultimately failing the builds. For example, we run the following PowerShell command within our main test script which selectively runs ART tests for techniques we support.

Invoke-AtomicTest T1053.005 -ExecutionLogPath 'd:\a\BLUESPAWN\BLUESPAWN\AtomicTestsResults.csv'

Given this failure, I began investigating more into how Invoke-AtomicRedTeam handles checking pre-reqs. Based on my review of the code/testing, there does not seem to be an automated way to check if pre-reqs are met programmatically (?). Given that this project is meant to automate the running of these tests, I was wondering if you might consider adding a way to get this status.

I see a few possible ways this could be supported. First, prereqs could automatically be checked when a test is run by default. If the prereqs were not satisfied, the test would just be skipped (and/or an error printed). This would enable folks to keep using a command line (like the one above) having confidence that any prereq issues would be ignored or alerted on properly.

Alternatively, you could also add a function to return a boolean if prereqs are supported. That way developers could write something like the following code block:

If(Test-AtomicTestPrereqsMet T1053.005 -eq $true) {
Invoke-AtomicTest T1053.005 -ExecutionLogPath 'd:\a\BLUESPAWN\BLUESPAWN\AtomicTestsResults.csv'
} Else { ... }

Finally, a hybrid of the two options could be added such as an additional parameter called something like "-SkipIfPrereqsNotMet"

redcanaryco / invoke-atomicredteam

Consider adding a way to programmatically retrieve if PreReqs are met #57