Winter Scripting Games 2013 - Practice Event 2

This post was published in 2013 and may be outdated.

Just a quick post on the script I submit for the second practice event of the Winter Scripting Games 2013 (last week).

Practice Event 2 -Covering Your Assets

Your organization is preparing to renew maintenance contracts on all of your server computers. You need to provide management with a report that details each inventory information for each server. Most of the servers do not have Windows PowerShell installed. None of the servers a separated from your client computer by a firewall. Computer names may be specified by a variety of means; your function must accept any collection of strings as computer names.

Minimum Requirements

Optional Criteria

• Display optional verbose output showing the computer name being contacted
• Prompt for computer names if none are specified when the function is run
• Accept computer names as strings from the pipeline

Desired Output

• ComputerName Model Manufacturer LogicalProcs PhysicalRAM BIOSSerial

My Script

# NAME  : Get-ComputerInventory
# AUTHOR: Francois-Xavier Cat
# DATE  : 2013/02/10

Function Get-ComputerInventory {
        <#
        .SYNOPSIS
        The Get-ComputerInventory function gets information about a local or
        Remote machine(s) specified by the parameter ComputerName.

        .DESCRIPTION
        The Get-ComputerInventory function gets information about a local or
        Remote machine(s) specified by the parameter ComputerName.

        .PARAMETER ComputerName
         Specifies the target computer for the management operation. The value can
        be a fully qualified domain name, a NetBIOS name, or an IP address. To
        specify the local computer, use the local computer name, use localhost, or
        use a dot (.)

        .INPUTS
        System.String

        .OUTPUTS
        System.Management.Automation.PSObject

        .EXAMPLE
         Get-ComputerInventory -ComputerName PC01

        This command gets inventory information about the Computer PC01.

        .EXAMPLE
         "SERVER01","SERVER02" | Get-ComputerInventory

        This command gets inventory information about SERVER01 and SERVER02.
        Get-ComputerInventory accepts Input from the pipeline.

        .NOTES
        NAME  : Get-ComputerInventory
        AUTHOR: Francois-Xavier Cat
        DATE  : 2013/02/10

        .LINK
        http://lazywinadmin.com
        #>

    [CmdletBinding()]
    param(
        [Parameter(ValueFromPipeline=$True,Mandatory=$true)]
        [string[]]$ComputerName
    )
    BEGIN {# Setup
        }
    PROCESS {
        Foreach ($Computer in $ComputerName) {
            Write-Verbose -Message "$Computer"

            try {

                # Gather Win32_ComputerSystem information for the current $Computer
                $WMIComputerSystem = Get-WmiObject -Class Win32_Computersystem -ComputerName $Computer -ErrorAction 'Stop'

                # Gather Win32_BIOS information for the current $Computer
                $WMIBios = Get-WmiObject -Class win32_bios -ComputerName $Computer -ErrorAction 'Stop'

                $TryIsOK = $True

            }#Try

            Catch {
                # Send the Errors in the Errors.txt file.
                "$Computer" | Out-File -Append -FilePath Errors.txt
                $TryIsOK = $False

            }#Catch

            if ($TryIsOK) {

                $output =    @{'ComputerName'=$Computer;
                            'Model'=$WMIComputerSystem.model;
                            'Manufacturer'=$WMIComputerSystem.Manufacturer;
                            'LogicalProcs'=$WMIComputerSystem.NumberOfLogicalProcessors;
                            'PhysicalRam'=("{0:N0}" -f($WMIComputerSystem.TotalPhysicalMemory/1GB));
                            'BIOSSerial'= $WMIBios.SerialNumber}

                # Create a new PowerShell object for the output
                $object = New-Object -TypeName PSObject -Property $output
                $object.PSObject.TypeNames.Insert(0,'Report.ComputerInventory')

                # Show the Output
                Write-Output -InputObject $object

            }#if ($TryIsOK)

        }#Foreach ($Computer in $ComputerName)

    }#PROCESS

    END {# Cleanup
        }

}#Function Get-ComputerInventory