PublicFunctions/Get-ProcInfoOnPipeline.ps1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
Function Get-ProcInfoOnPipeline
{
    <#
        .Synopsis
            Adds ProcInfo (Physical) Columns to an object
        .DESCRIPTION
            This typically takes an imported csv file with a ComputerName Column as an input object
            but just about any collection of objects that exposes .ComputerName should work. Alternately,
            A simple list of stings can be converted to the appropriate object with the
            Get-ServerObjectCollection cmdlet.

            The output is the same type of object as the input so that it can be piped to the next
            function to add another column. The output can also filtered and selected using Where-Object
            and Select-Object. Out-GridView also makes a very useful output.

            Makes a call to WMI and requires the an input object with Boolean Ping and WMI properties.
            Will only try to get value if both are true or if the -NoErrorCheck switch is used.

            Columns returned are a subset of WMI Win32_Processor
        .EXAMPLE
            Get-ServerCollection |
                Test-ServerConnectionOnPipeline |
                Get-OSCaptionOnPipeline |
                Get-TimeZoneOnPipeline |
                Get-TotalMemoryOnPipeline |
                Get-MachineModelOnPipeline |
                Get-ProcInfoOnPipeline |
                Select-Object ComputerName,BootTime,OSVersion,TimeZone,TotalMemory,MachineModel,TotalProcs,ProcName,Cores,DataWidth |
                Format-Table
    #>


    [CmdletBinding()]

    Param (
        [parameter(
        Mandatory=$true,
        ValueFromPipeline= $true)]
        $ComputerProperties,

        [switch]
        $NoErrorCheck
        )

    Process {
        $NoErrorCheck | Out-Null
        $ComputerProperties | Select-Object *, TotalProcs, ProcName, Cores, DataWidth | ForEach-Object {
            If (($NoErrorCheck) -or (($PSItem.Ping) -and ($PSItem.WMI))) {
                # Note forcing $Proc to an array solves the problem of
                # only one processor returns a single object and not an
                # array with a single element
                $Proc = @(Get-CimInstance -computername $PSItem.ComputerName -ClassName win32_Processor)
                $PSItem.TotalProcs = $Proc.count
                $PSItem.ProcName = $Proc[0].Name
                $PSItem.Cores = $Proc[0].NumberOfCores
                $PSItem.DataWidth = $Proc[0].DataWidth
            }
            Else {
                $PSItem.TotalProcs = 'No Try'
                $PSItem.ProcName = 'No Try'
                $PSItem.Cores = 'No Try'
                $PSItem.DataWidth = 'No Try'
            }
            $PSItem
        }
    }
}