Testimo - PowerShell Module

Testimo is a PowerShell Module to help with basic/more advanced testing of Active Directory and maybe in future other types of servers. Testimo is an alpha product and as such things do change. It's goal is to be fully automated solution where one can run the command and get results without executing 50 little functions.

If you're new to Testimo you should read this blog post!

Note: At present this module is not supported in PowerShell Core/PowerShell 7. This is because the Testimo module depends on other Microsoft moodules that are also not supported in PowerShell 7, including GroupPolicy and ServerManager. There is an issue tracking this compatibiity which you can follow: https://github.com/EvotecIT/Testimo/issues/110.

Things to know:

• [x] Configuration hash is not written in stone and can change rapidly as Testimo gets tested

• [x] Ideas are VERY welcome

• [x] There's a big mess in files/function names - I'm still testing things out creating some random names, will be cleaned up later on

• [x] There are lots of details missing for tests, and some things may not work as you want - please report issues or if you know how, fix them

• [x] I don't know EVERYTHING - I'm very open to help with making Testimo more robust, detailed and easy to use

• [x] This module works great in Windows PowerShell!

• Testimo - PowerShell Module

  • Execution
  • ChangeLog
    • Comments
    • Things to consider
  • Known Issues / By Design
  • To install
    • And to update
  • To use after installation
  • Changing default configuration
    • Straight to FILE/JSON
      • Straight to JSON
      • Output to Hashtable so you can edit it freely and keep in ps1
  • Using Invoke-Testimo with non-default configuration
    • Dependencies
    • Portability
    • Removal
      • Option 1
      • Option 2

Execution

Generate all tests and show HTML report (I'm currently thinking on making -ShowReport obsolete and adding -HideReport instead)

Invoke-Testimo -ShowReport

Generate all tests but display content only in PowerShell

Invoke-Testimo

Please keep in mind that there is currently known issue that running all tests while works correctly generated HTML is very very slow when switching Tabs.

ChangeLog

• 0.0.62

  • [x] Tests
    • [x] Fixed DCDNSResolveExternal reported in #122

• 0.0.61 - 2021.03.17

  • [x] Tests
    • [x] Improved ForestTrusts
    • [x] Improved ForestRoles
  • [x] General
    • [ ] Improvement of HTML

• 0.0.60 - 2021.03.17

  • [x] Tests
    • [x] Improved ForestSubnets
    • [x] Improved ForestSites
    • [x] Improved ForestOptionalFeatures
    • [x] Improved ForestBackup
    • [x] Improved ForestTombstoneLifetime
    • [x] Improved DomainDomainControllers
    • [x] Improved DomainLDAP
    • [x] Improved DomainOrphanedSecurityPrincipals
  • [x] General
    • [x] Added AlwaysShowSteps
    • [x] Improved support for new PSWriteHTML

• 0.0.59 - 2021.03.01

  • [x] General
    • [x] Misspelled word in report (Extream -> Extreme) #120 - tnx mojomojoman

• 0.0.58 - 2021.02.25

  • [x] Tests
    • [x] Added ForestSubnets
    • [x] Improved DomainDomainControllers
    • [x] Improved DomainLDAP
    • [x] Improved ForestBackup
    • [x] Improved ForestOrphanedAdmins
    • [x] Improved ForestConfigurationPartitionOwners
    • [x] Improved DomainDuplicateObjects
    • [x] Improved ForestSites
  • [x] General
    • [x] Improved reporting
    • [x] Improved reporting status (assesment)

• 0.0.57 - 2021.02.21

  • [x] Tests
    • [x] Added DomainLDAP - takes over DCLDAP
    • [x] Disabled DCLDAP by default. Still there just not used.
    • [x] Improved ForestOrphanedAdmins
    • [x] Improved ForestConfigurationPartitionOwners
    • [x] Improved DomainDuplicateObjects
    • [x] Improved DomainDomainControllers
  • [x] General
    • [x] Renamed Parameter ReturnResults to PassThru (left as an alias)
    • [x] Fixed loading configuration from JSON/File/HashTable - Configuration changed so much rebuild will be required
    • [x] Fixed saving configuration to JSON/File/HashTable - Configuration changed so much rebuild will be required
    • [x] Parameter for Invoke-Testimo ShowReport is deprecated and doesn't do anything
    • [x] Parameter for Invoke-Testimo HideHTML was added and prevents auto-opening of HTML
    • [x] Parameter for Invoke-Testimo HideSteps/HideSolution was added to hide solution/steps in case it's not needed
    • [x] Added additional information about HTML report generating where the file was saved (useful if no FilePath was provided)
    • [x] Parameter ReportPath was renamed to FilePath, ReportPath is still an alias - to get it the same as GPOZaurr
  • [x] Reporting
    • [x] Solution/Steps added to Report when available for display
    • [x] Reporting is still getting more and more changes

• 0.0.56 - 2021.02.07

  • [x] Tests
    • [x] Improved ForestOrphanedAdmins
    • [x] Added ForestConfigurationPartitionOwners
    • [x] Improved DomainDuplicateObjects
    • [x] Improved DomainDomainControllers
    • [x] Improved DCTimeSynchronizationExternal
  • [x] Reporting
    • [x] HTML report updated with new format, still not final
    • [x] Added Importance/Category visibility in HTML -> if only those were updated in all tests 🤣
    • [x] Added Description visibility in HTML -> if only those were updated in all tests 🤣
    • [x] Added Resources visibility in HTML -> if only those were updated in all tests 🤣

• 0.0.55 - 2021.02.02

  • [x] Improvement to report (domain section)
  • [x] Improvement to DomainDuplicateObjects
  • [x] Improvement to OrphanedForeignSecurityPrincipals
  • [x] Removed ForestDuplicateObjects - duplicate of DomainDuplicateObjects

• 0.0.54 - 2021.01.29

  • [x] Fixes report to work with IE 11 (not great, not bad either)

• 0.0.53 - 2021.01.28

  • [x] Improved DomainDomainControllers

• 0.0.52 - 2021.01.27

  • [x] Improved DCUNCHardenedPaths to check for multiple values

• 0.0.51 - 2021.01.26

  • [x] Fix for Invoke-Testimo crashing on dead/non-responding/no-access DC #117

• 0.0.50 - 2021.01.25

  • [x] Fix for Invoke-Testimo returning more than one line of error which would stop Testimo #116

• 0.0.49 - 2021.01.25

  • [x] Fix for Invoke-Testimo not working correctly with some tests #116
  • [x] Improved some tests
  • [x] Reporting
    • [x] HTML report improved a bit for Domain based checks

• 0.0.48 - 2021.01.21

  • [x] Fix for Invoke-Testimo not working when no tests are defined
  • [x] Tests
    • [x] Added DomainDomainControllers - covers DC ACL owner, DC Manager, DC Password Last Set, DC Last Logon, Enabled

• 0.0.47 - 2021.01.19

  • [x] Improvements
    • [x] Added warning & errors to HTML
    • [x] Removed dependency on PSWinDocumentation.AD temporary (no tests for now)
  • [x] Tests
    • [x] Removed DomainGroupPolicyPermissionUnknown
    • [x] Removed GroupPolicyMissingPermissions
    • [x] Added DomainGroupPolicyPermissions - covers unknown, adminitrative, authenticated users and system (both removed + some)
    • [x] Removed DomainGroupPolicyEmptyUnlinked
    • [x] Added DomainGroupPolicyAssesment - covers empty, unlinked, disabled, with problem, optimized, no apply permission
    • [x] Added DomainNetLogonOwner
    • [x] Improved ForestSiteLinksConnections #92
    • [x] Improved ForestTombstoneLifetime - support for forest

• 0.0.46 - 2020.10.29

  • [x] Improvement to HTML
    • [x] DataStore is now set to JavaStore which allows handling of more data within single HTML file
    • [x] Should have less errors on tab switching
    • [ ] Known issue: with lots of tables/charts switching between tabs can take time, be patient
  • [x] Improvement to DomainSecurityKRBGT
  • [x] Improvement to DCWindowsUpdates
  • [x] Removed DomainKerberosAccountAge as it's identical to DomainSecurityKRBGT
  • [x] Removed DomainTrusts as it wasn't really working great
  • [x] Added ForestTrusts with improvements
  • [x] ForestObjectsWithConflict renamed to ForestDuplicateObjects
  • [x] ForestDuplicateObjects disabled by default (same thing as DomainDuplicateObjects just done forest wide)
  • [x] DomainDuplicateObjects enabled by default (same thing as forest just done per domain)
  • [x] DCTimeSettings updated with proper NTP recommendation #65 - tnx SolidKnight, SUBnet192, itpro-tips

• 0.0.45 - 2020.10.20

  • [x] Reversed on HTML change due to issues

• 0.0.44 - 2020.10.19

  • HTML
    • [x] HTML report should now be much faster to work with even with larger datasets
  • Tests
    • [x] DomainWellKnownFolders - removed duplicate code
    • [x] Added some additional descriptions to tests, still long way to go
    • [x] Small name fix for DomainGroupPolicySysvol
    • [x] DomainGroupPolicyEmptyUnlinked - added new test
    • [x] Silent GitHub version check
    • [x] Fixes working with lowercase source names
    • [x] Fixes issue Service Status fails on value "Auto" #106 due to change in PSSharedGoods

• 0.0.43 - 2020.06.17

  • Tests
    • [x] Small name update to OrganizationalUnitsEmpty and OrganizationalUnitsProtected fixing #103

• 0.0.42 - 2020.06.08

  • Tests
    • [x] Fix for DCNetSessionEnumeration not run against target #102
  • Engine
    • [x] Better Sources handling during typing

• 0.0.41 - 2020.06.06

  • Engine
    • [x] Renamed MustExists to ExpectedOutput for Parameters in Tests for unified experience
    • [x] Added ExpectedResult for Parameters in Tests
      • [ ] This works in a way where if we use WhereObject filtering on Array you can check if output is given or not and fail/pass right away
      • [ ] This brings 3 ways to test ExpectedCount, ExpectedValue or ExpectedResult
      • [ ] ExpectedResult ignores all other settings in parameters except for WhereObject
  • Tests
    • [x] Added DomainGroupPolicyPermissionConsistency (requires GPOZaurr PowerShell module)
    • [x] Added DomainGroupPolicyOwner (requires GPOZaurr PowerShell module)
      • [x] Test for: GPO: Owner Consistent
      • [x] Test for: GPO: Owner Administrative
    • [x] Added DomainGroupPolicyPermissionUnknown (requires GPOZaurr PowerShell module)
    • [x] Added DomainGroupPolicySysvol (requires GPOZaurr PowerShell module)
    • [x] Renamed DCGroupPolicySYSVOL to DCGroupPolicySYSVOLDC to prevent conflict with per Domain checks
    • [x] Replaced DomainGroupPolicyADM with GPOZaurr command

• 0.0.40 - 2020.05.09

  • Engine
    • [x] ExpectedOutput is now required for Source
  • Tests
    • [x] ExpectedOutput (true/false/null) added for all tests
    • [x] Fix regression ForestReplicationStatus if multiple DC
    • [x] Fix regression ForestReplication if multiple DC
    • [x] Added DomainDuplicateObjects test - finds CNF objects

• 0.0.39 - 2020.04.11

  • Engine
    • [x] Add requirements (IsInternalForest = $true) for tests that do not support external forest (such as repadmin)
    • [x] Fixed ExpectedCount not working correctly for some values (no sure why it worked at all)
  • Reporting
    • [x] Improved output to not include empty tabs
  • Tests
    • [x] Improved ForestReplicationStatus if only 1 DC, disabled if asking for external forest
    • [x] Improved ForestReplication if only 1 DC
    • [x] Renamed DomainEmptyOrganizationalUnits to DomainOrganizationalUnitsEmpty
    • [x] Added DomainOrganizationalUnitsProtected
    • [x] Improved DCServices for non-existing spooler service
    • [x] Changed DomainPasswordComplexity Lockout Treshold changed to 5+
    • [x] Renamed DCNetSessionEnumaration to DCNetSessionEnumeration - tnx subnet192 #99
    • [x] Added DCDNSForwarders - DNS: More than one forwarding server should be configured
    • [x] Added DomainExchangeUsers - Exchange Users: Missing MailNickName monitors for issue described on blog
    • [x] Improved DNSScavengingForPrimaryDNSServer
  • Other
    • Fix typos - tnx subnet192 #99

• 0.0.38 - 2020.03.14

  • Added GroupPolicy and ActiveDirectory to RequiredModules and ExternalModuleDependencies preventing error reported in #91

• 0.0.37 - 2020.03.13

  • Engine
    • [x] Update to DomainSecurityUsers to exclude DomainGuests
    • [x] Fix for ExpectedOutput $false
  • Tests
    • [x] Fix for DomainSecurityUsers - tnx itpro-tips #89
    • [x] Added DomainSecurityKRBGT
    • [x] Improved DCNetworkSettings - DNS: DNS servers on Ethernet should include the loopback address, but not as the first entry - #90 - tnx itpro-tips
    • [x] Improved DCNetworkSettings - DNS: Ethernet should have static IPv4 settings (disabled by default) - #90 - tnx itpro-tips
    • [x] Improved DCLanManServer - ADV200005 | Microsoft Guidance for Disabling SMBv3 Compression - Disabled by default, as patch is available

• 0.0.36 - 2020.03.04

  • Engine
    • [x] Fix for broken tests

• 0.0.35 - 2020.03.04

  • Engine
    • [x] Added MustExists (True/False) for Parameters
    • [x] Fixes for In/NotIn
    • [x] Fixes for Inclusion/Exclusion DC/Domain
    • [x] Fixes for ExpectedCount 0 not working
  • Tests
    • [x] DCServices Improvement with XBOX Service
    • [x] Added DCSMBSharesPermissions
    • [x] Added DomainSecurityUsers
    • [x] Added DCUNCHardenedPaths - read potential issues of implementing UNC Hardened Paths. If you enable and things go south GPOs won't work.

• 0.0.34 - 2020.01.29

  • Tests
    • [x] Modify repadmin (ForestReplicationStatus) for non-english OS #86 - tnx Fiyorden

• 0.0.33 - 2020.01.28

  • Tests
    • [x] Fixing legacy ADM files check - #84 - tnx PMORMR

• 0.0.32 - 2020.01.27

  • Tests
    • [x] Fix for DCGroupPolicySYSVOL - #83 - tnx PMORMR

• 0.0.31 - 2020.01.23

  • Engine
    • [x] Fix for loading configuration

• 0.0.30 - 2020.01.19

  • Engine
    • [x] Fix for version checks

• 0.0.29 - 2020.01.19

  • Engine
    • [x] Added IncludeDomain, IncludeDomainControllers (when used skips Exclusions)
      • [ ] This requires heavy improvements - soon enough
    • [x] Fixes issue when first running single source and then running all tests (it would use the "old source" instead of using defaults)
  • Tests
    • [x] Fix for Windows Roles and Feature for other language (non-english) #79 - tnx Fiyorden
    • [x] Added LDAPInsecureBindings

• 0.0.28 - 2019.12.29

  • Engine
    • [x] Fix for not running tests for DC if no Forest/Domain tests are present
    • [x] Added -SkipRODC parameter to skip DCs that are RODC

• 0.0.27 - 2019.12.26

  • Engine
    • [x] Better support for Portable Testimo

• 0.0.26 - 2019.12.26

  • Engine
    • [x] Improvments to some error handling
    • [x] Added Version/Date Published (#72)
    • [x] Do not run Tests for Domain/DomainControllers if not enabled
  • Updated modules
    • [x] ADEssentials to 0.0.27 (Get-WinADDFSHealth fixed)
    • [x] Other dependencies also updated
  • Tests
    • [x] Fix for DNSForwaders
    • [x] Added DomainComputersUnsupported (older than 2008)
    • [x] Added DomainComputersUnsupportedMainstream (2008 computers with support from Microsoft)

• 0.0.25 - 2019.11.18

  • Engine
    • Small configuration saving fixes
    • Added version
  • Tests
    • [x] ForestObjectsWithConflict - Added
    • [x] DCRDPSecurity - Added
      • [x] Minimum Encryption Level
    • [x] DCServiceWINRM - Added
      • [x] DisableRunAS
    • [x] DCSMBProtocols - added BPA findings - Added
      • [x] AutoDisconnectTimeout
      • [x] CachedOpenLimit
      • [x] DurableHandleV2TimeoutInSeconds
      • [x] EnableSMB1Protocol
      • [x] EnableSMB2Protocol
      • [x] MaxThreadsPerQueue
      • [x] Smb2CreditsMin
      • [x] Smb2CreditsMax
      • [x] RequireSecuritySignature
    • [x] DCNetSessionEnumeration (Net Cease) - Added
      • [x] Hardening Net Session Enumeration
    • [x] DCLanManServer - Added
      • [x] Microsoft network server: Digitally sign communications (if client agrees)
      • [x] Microsoft network server: Digitally sign communications (always)
      • [x] Users are not forcibly disconnected when logon hours expire.

• 0.0.23 - 2019.10.08

  • Tests
    • [x] DCDiagnostics - Added
      • [x] Basically wrapper over DcDiag
        • [x] Checks Connectivity
        • [x] Checks Advertising
        • [x] Checks CheckSecurityError
        • [x] Checks CutoffServers
        • [x] Checks FrsEvent
        • [x] Checks DFSREvent
        • [x] Checks SysVolCheck
        • [x] Checks FrsSysVol
        • [x] Checks KccEvent
        • [x] Checks KnowsOfRoleHolders
        • [x] Checks MachineAccount
        • [x] Checks NCSecDesc
        • [x] Checks NetLogons
        • [x] Checks ObjectsReplicated
        • [x] Checks Replications
        • [x] Checks RidManager
        • [x] Checks Services
        • [x] Checks SystemLog
        • [x] Checks Topology
        • [x] Checks VerifyEnterpriseReferences
        • [x] Checks VerifyReferences
        • [x] Checks VerifyReplicas
        • [x] Checks DNS
        • [x] Checks ForestDnsZonesCheckSDRefDom
        • [x] Checks ForestDnsZonesCrossRefValidation
        • [x] Checks DomainDnsZonesCheckSDRefDom
        • [x] Checks DomainDnsZonesCrossRefValidation
        • [x] Checks SchemaCheckSDRefDom
        • [x] Checks SchemaCrossRefValidation
        • [x] Checks ConfigurationCheckSDRefDom
        • [x] Checks ConfigurationCrossRefValidation
        • [x] Checks NetbiosCheckSDRefDom
        • [x] Checks NetbiosCrossRefValidation
        • [x] Checks DNSDomain
        • [x] Checks LocatorCheck
        • [x] Checks FsmoCheck
        • [x] Checks Intersite
    • [x] DCEventLog - Added
      • [x] Check for Application Log - LogMode/LogFull
      • [x] Check for System Log - LogMode/LogFull
      • [x] Check for PowerShell Log - LogMode/LogFull
      • [x] Check for Security Log - Size/SizeMax/LogMode/LogFull
      • [x] Check for Security Log - Default Security Permissions
    • [x] DCTimeSynchronizationExternal
      • [x] Supports parameters #41 - tnx James Rudd
    • [x] DCDFS - Added
      • [x] DFS should be Healthy
      • [x] Central Repository for GPO for Domain should be available
      • [x] Central Repository for GPO for DC should be available
      • [x] GPO Count should match folder count
      • [x] MemberReference should return TRUE
      • [x] DFSErrors should be 0
      • [x] DFSLocalSetting should be TRUE
      • [x] DomainSystemVolume should be TRUE
      • [x] SYSVOLSubscription should be TRUE
      • [x] DFSR AutoRecovery should be enabled (not stopped)
    • [x] DCDFSRAutoRecovery - DELETED
      • [x] Moved to DCDFS
    • [x] DomainDHCPAuthorized - Added but DISABLED
      • [x] Check added, by default disabled.
    • [x] DCTimeSettings
      • [x] Fix for Incorrect NTP Interval #42 - tnx Jakob West
      • [x] Added test for checking NTP Incorrect Interval #42 - tnx Jakob West
      • [x] Should properly read settings via Policy (GPO) - change in PSSharedGoods #41 - tnx James Rudd
    • [x] DomainGroupPolicyADM - Added
      • [x] Added check for legacy ADM files
    • [x] DCGroupPolicySYSVOL - Added
      • [x] Added check if all GPO's have their folder on SYSVOL
    • [x] DCLanManagerSettings - Added
      • [x] Added checks for Lan Manager Settings
    • [x] DCTimeSynchronizationInternal
      • [x] Added check for LastBootUpTime be less than X (60) days
  • Engine
    • Added checks for potential NULL after Where-Object (fails tests now, while before it would ignore it)
    • Added parameters for SourceParameters for use within Sources #41 - tnx James Rudd
    • Changed export / import configuration to support SourceParameters/ExpectedOutput. #41 - tnx James Rudd
    • Support for Requirements/CommandAvailable

• 0.0.22 - 2019.09.10

  • Tests
    • [x] DCPorts - typo fix OPEN vs CLOSED

• 0.0.21 - 2019.09.10

  • Tests
    • [x] DCPorts - Checking for port 139 - Require PORT CLOSED (#29 - tnx SP3269)
    • [x] DCNetworkSettings - Netbios TCPIP settings on network card - Require DISABLED (#29 - tnx SP3269)
    • [x] DCWindowsFirewall - was renamed to DCNetworkSettings
    • [x] DomainEmptyOrganizationalUnits - fix for lacking Contacts (#32 - tnx JasonCook599)
    • [x] DNSScavengingForPrimaryDNSServer - fix LT should be GT (#33 - tnx JasonCook599)
    • [x] DomainDNSZonesForest0ADEL - Added new test
    • [x] DomainDNSZonesDomain0ADEL - Added new test
  • Engine
    • [x] Support for match/notmatch/notcontains

• 0.0.20 - 2019.09.09

  • [x] Fix for configuration loading from JSON file (#30 - tnx Alex)

• 0.0.19 - 2019.09.08

  • [x] First public release - More information in blog post!

Comments

Keep in mind not all tests apply to each environment. I'm adding those to be flexible and be able to test things as needed. Each of those tests will need additional description and recommendation, most likely with links and steps to fix. Some of the tests are very basic and will need feedback, work on making it a robust test. Nothing is written in stone for now. Things can change day by day.

Things to consider

• Criticality of Tests - some tests are critical, some are less critical, some are informative only
• Recommended, Default, Sane - not all tests are equal or make sense in all conditions

Tests are based on:

• Active Directory CheckList
• AD Health & Checkup
• Some tests I've defined myself
• Feel free to submit your own ideas either via Issues or direct PR.

Known Issues / By Design

• Requirements for Sources work differently then for Tests
  • For Sources when Requirements are not met Testimo skips it totally from output
  • For Tests when Requirements are not met Testimo marks it as skipped

To install

Install-Module -Name Testimo -AllowClobber -Force

Force and AllowClobber aren't really nessecary but they do skip errors in case some appear.

And to update

Update-Module -Name Testimo

That's it. Whenever there's new version you simply run the command and you can enjoy it. Remember, that you may need to close, reopen PowerShell session if you have already used module before updating it.

The important thing is if something works for you on production, keep using it till you test the new version on a test computer. I do changes that may not be big, but big enough that auto-update will break your code. For example, small rename to a parameter and your code stops working! Be responsible!

To use after installation

With output to screen only

Invoke-Testimo

With option to be able to process output - for example to email

Invoke-Testimo -ReturnResults

Changing default configuration

Testimo comes with preset rules that may not apply to your environment. You may want to change some things like disabling some tests or changing some values (to an extent). There are 3 ways to do it. Depending on how you want to save/edit/pass configuration to TestIMO - I leave it up to you.

Straight to FILE/JSON

Get-TestimoConfiguration -FilePath $PSScriptRoot\Configuration\TestimoConfiguration.json

Straight to JSON

Get-TestimoConfiguration -AsJson

Output to Hashtable so you can edit it freely and keep in ps1

$OutputOrderedDictionary = Get-TestimoConfiguration
$OutputOrderedDictionary.ForestOptionalFeatures.Tests.RecycleBinEnabled.Enable = $false
$OutputOrderedDictionary.ForestOptionalFeatures.Tests.LapsAvailable.Enable = $true
$OutputOrderedDictionary.ForestOptionalFeatures.Tests.LapsAvailable.Parameters.ExpectedValue = $false

Using Invoke-Testimo with non-default configuration

Following configuration allows you to:

• Edit default TestImo configuration with some other values
• Exclude one of the domains
• Return Results for future processing
• Limit sources to only 4 types (you could also limit that via Hashtable but this way is quicker for Adhoc enabling/disabling)

Import-Module Testimo

$OutputOrderedDictionary = Get-TestimoConfiguration
$OutputOrderedDictionary.ForestOptionalFeatures.Tests.RecycleBinEnabled.Enable = $false
$OutputOrderedDictionary.ForestOptionalFeatures.Tests.LapsAvailable.Enable = $true
$OutputOrderedDictionary.ForestOptionalFeatures.Tests.LapsAvailable.Parameters.ExpectedValue = $false

$Sources = @(
    'ForestFSMORoles'
    'ForestOptionalFeatures'
    'ForestBackup'
    'ForestOrphanedAdmins'
    'DomainPasswordComplexity'
    'DomainKerberosAccountAge'
    'DomainDNSScavengingForPrimaryDNSServer'
    'DCWindowsUpdates'
)

$TestResults = Invoke-Testimo -PassThru -ExcludeDomains 'ad.evotec.pl' -Sources $Sources -Configuration $OutputOrderedDictionary
$TestResults | Format-Table -AutoSize *

Be sure to checkout Examples section for more How-To.

Dependencies

• [x] PowerShell 5.1 - I know, bummer right?
• [x] RSAT if run externally from Windows 10 machine

When you use the Install-Module option what happens in the backgrouns is that Windows will use PowershellGallery (hosted by Microsoft) to download Testimo and any dependencies this module needs. As it stands all dependencies except one (DSInternals) are my other PowerShell Modules. Why I am using it this way? Because I don't want to write multiple times the same code over and over.

• [x] Testimo - this module
  • [x] PSWinDocumentation.AD - PowerShell Module that's main purpose is deliver formmated/compressive Active Directory data for documentation purposes. It's read only.
    • [x] DSInternals - Directory Services Internals PowerShell Module and Framework by Michael Grafnetter - it's main purpose is to verify Active Directory Passwords
  • [x] PSWinDocumentation.DNS - PowerShell Module that's main purpose is deliver formmated/compressive DNS data for documentation purposes (it's a bit unfinished product but it works as far Testimo is concerned). It's read only.
  • [x] ADEssentials - PowerShell Module that's supposed to hold a bunch of useful Get/Set tools for Active Directory.
  • [x] PSSharedGoods - PowerShell Module with lots of different, helpfull functions that I have gathered over the years
    • [x] PSWriteColor - PowerShell Module responsible for Console Colors
    • [x] Connectimo - PowerShell Module responsible for Connecting to O365 - while it's not in use in this project PSSharedGoods depends on it, so it's here. No function is used from it.
  • [x] PSWriteHTML - PowerShell Module that creates nice looking reports. Responsible for visual HTML reporting.
  • [x] Emailimo - PowerShell Module that creates nice looking emails. Responsible for emails in Testimo.

In Testimo I'm using internal functions from some of the modules without any real documentation.

Portability

There are times where you may want to use Testimo in Portable way. Following function when executed will download all modules to given path and load them for you. Following blog post shows the way. It was written specifically for Testimo.

Initialize-ModulePortable -Name 'Testimo' -Path "$PSScriptRoot\TestimoPortable" -Download

After that,, you can use Invoke-Testimo as you normally would. You can also skip Download parameter if you already downloaded all the modules before. This function is also available as part of PSSharedGoods module.

Removal

In case you decide that Testimo is not for you, you can easily clean it up. Unfortunetly since Testimo uses all those dependencies as mentioned above you will have to remove all those modules one by one. Additionally if you have been using Testimo and you update it using Update-Module command and other modules got updated as well, it's possible there will be more then 1 version of said modules. Keep in mind that if you already use some of my modules some of the stuff may be already there and needed for different modules. Be careful when removing PowerShellModules.

Option 1

• [x] Finding where modules are stored (Get-Module -ListAvailable Testimo).ModuleBase
• [x] Manually deleting all folders Testimo, and other dependant modules

Option 2

• [x] Run Uninstall-Module

$Modules = @('Testimo', 'PSWinDocumentation.AD','PSWinDocumentation.DNS','ADEssentials', 'PSSharedGoods','PSWriteColor', 'Connectimo', 'DSInternals','Emailimo','PSWriteHTML' )
foreach ($Module in $Modules) {
    Uninstall-Module $Module -Force -AllVersions
}

Due to multiple versions per each module you may need to rerun this couple of times to remove all those mdoules in case there are some problems.