Summary

This script reports various useful OS and hardware info from a list of remote computers by polling them asynchronously.
It optionally outputs a log and a CSV file of the data.

This is an update of Get-Model primarily just to add the asynchronicity feature. This relies on the new -Parallel parameter of the ForEach-Object cmdlet, which makes this incompatible with PowerShell 5.1, a limitation not present in Get-Model. This new module also gathers quite a bit more information, including network adapter info.

Requirements

• Powershell 7+ due to use of ForEach-Object -Parallel

Usage

1. Download Get-MachineInfo.psm1 to the appropriate subdirectory of your PowerShell modules directory.
2. Run it using the examples and parameter documentation below.

Examples

Return info for single machine

Get-MachineInfo "espl-114-01"

Return info for multiple specific machines

Get-MachineInfo "espl-114-01","espl-114-02","tb-207-01"

Return info for multiple machines matching a wildcard query

Get-MachineInfo "espl-114-*"

Return info for multiple queries

Get-MachineInfo "espl-114-*","tb-207-01","tb-306-*"

Return info for all machines in a given OU

Get-MachineInfo -OUDN "OU=Instructional,OU=Desktops,OU=Engineering,OU=Urbana,DC=ad,DC=uillinois,DC=edu" -ComputerName "*"

Capture the info silently and return just the MACs of the machines:

$info = Get-MachineInfo "esb-apl-*" -NoConsoleOutput -PassThru
$info | Select Name,{$_.NetAdapters.Mac}

Parameters

-ComputerName [string[]]

Required string array.
The list of computer names and/or computer name query strings to poll.
Use an asterisk (*) as a wildcard.
The parameter name may be omitted if the value is given as the first or only parameter.

-SearchBase [string]

Optional string.
The distinguished name of the OU to limit the computername search to.

-PassThru

Optional switch.
If specified, the resulting info is returned in a PowerShell object.
If not specified, nothing is returned to the output stream, except logging (if any).
When specifying -PassThru, capture the info like so: $info = Get-MachineInfo ....

-ThrottleLimit [int]

Optional integer.
The maximum number of computers which will be asynchronously polled simultaneously.
Default is 50.

-Log [string]

Optional string.
The full path of a text file to log to.
If omitted, no log will be created.
If :TS: is given as part of the string, it will be replaced by a timestamp of when the script was started, with a format specified by -LogFileTimestampFormat.
Specify :ENGRIT: to use a default path (i.e. c:\engrit\logs\<Module-Name>_<timestamp>.log).

-Csv [string]

Optional string.
The full path of a CSV file to output resulting data to.
If omitted, no CSV will be created.
If :TS: is given as part of the string, it will be replaced by a timestamp of when the script was started, with a format specified by -LogFileTimestampFormat.
Specify :ENGRIT: to use a default path (i.e. c:\engrit\logs\<Module-Name>_<timestamp>.csv).

-NoConsoleOutput

Optional switch.
If specified, nothing is output to the console.
Has no effect on -PassThru.

-NoProgressOutput

Optional switch.
If specified, progress output is not logged to the console.
The resulting table is still output to the console.
Has no effect on -PassThru.

-Indent [string]

Optional string.
The string used as an indent, when indenting log entries.
Default is four space characters.

-LogFileTimestampFormat [string]

Optional string.
The format of the timestamp used in filenames which include :TS:.
Default is yyyy-MM-dd_HH-mm-ss.

-LogLineTimestampFormat [string]

Optional string.
The format of the timestamp which prepends each log line.
Default is [HH:mm:ss:ffff]⎵.

-Verbosity [int]

Optional integer.
The level of verbosity to include in output logged to the console and logfile.
Specifying 1 outputs some additional logs per machine polled.
Default is 0.

-DisablePsVersionCheck

Optional switch.
When specified the module will attempt to run regardless of the current version of PowerShell.
Normally, the module refuses to run if the major current version of PowerShell is less than 7.

Notes

• Machines for which data could not be retrieved will have an Error value of TRUE and will have null data otherwise.
• Machines for which data was retrieved will have a null Error value.
• By mseng3. See my other projects here: https://github.com/mmseng/code-compendium.