library/PoshWSUS/2.3.1.6/Scripts/Get-PSWSUSUpdatePerClient.ps1

function Get-PSWSUSUpdatePerClient {
    <#
    .SYNOPSIS
        Gets the summary of all updates for a client
         
    .DESCRIPTION
       Gets the summary of all updates for a client
         
    .PARAMETER ComputerName
        Name of the client to query
     
    .PARAMETER ComputerObject
        Collection of computers to query
         
    .PARAMETER UpdateScope
        Specified scope of updates to perform query against
         
    .NOTES
        Name: Get-PSWSUSUpdatePerComputer
        Author: Boe Prox
        DateCreated: 23NOV2011
                
    .LINK
        https://learn-powershell.net
         
    .EXAMPLE
    Get-PSWSUSUpdatePerClient -UpdateScope (New-PSWSUSUpdateScope -IncludedInstallationStates Failed)
     
    Computername TargetGroup UpdateKB UpdateTitle UpdateInstallationSt UpdateApprovalA
                                                                                                       ate ction
    ------------ ----------- -------- ----------- -------------------- ---------------
    TEST1 Servers - Test 979909 Microsoft .NET Framework 3.5 SP1 and ... Failed Install
    TEST2 Servers - Test 983583 Security Update for .NET Framework 2.... Failed Install
    TEST2 Servers - Test 2418241 Security Update for Microsoft .NET Fr... Failed Install
    TEST3 Servers - Test 2446704 Security Update for .NET Framework 2.... Failed Install
    TEST5 Servers - Test 2478658 Security Update for .NET Framework 2.... Failed Install
    ...
         
    Descripton
    ----------
    This example will gather all failed updates from all of the clients on the WSUS server using the UpdateScope.
     
    .EXAMPLE
    Get-PSWSUSUpdatePerClient -Computername Test1 -UpdateScope (New-PSWSUSUpdateScope -IsWsusInfrastructureUpdate)
     
    Computername TargetGroup UpdateKB UpdateTitle UpdateInstallationSt UpdateApprovalA
                                                                                                       ate ction
    ------------ ----------- -------- ----------- -------------------- ---------------
    TEST1 Servers - Test 842773 Update for Background Intelligent Tra... NotApplicable Install
    TEST1 Servers - Test 898461 Update for Windows XP (KB898461) NotApplicable Install
    TEST1 Servers - Test 938759 Update for Windows Server 2003 (KB938... Installed Install
    TEST1 Servers - Test 938759 Update for Windows Server 2003 for It... NotApplicable Install
    TEST1 Servers - Test 938759 Update for Windows Server 2003 x64 Ed... NotApplicable Install
     
    Description
    -----------
    This example gets all updates from TEST1 that are WSUS infrastructure related updates.
     
    #>
 
    [cmdletbinding(
        ConfirmImpact = 'low',
        DefaultParameterSetName = 'ComputerName'
    )]
    Param(
        [Parameter(Position = 0, ParameterSetName = 'ComputerName')]
        [string]$ComputerName, 
        [Parameter(Position = 0, ParameterSetName = 'ComputerObject',ValueFromPipeline = $True)]
        [Microsoft.UpdateServices.Internal.BaseApi.ComputerTarget]$ComputerObject,
        [Parameter(Position = 1, ParameterSetName = '')]
        [Microsoft.UpdateServices.Administration.UpdateScope]$UpdateScope                                                                                          
    )
    Begin {                
        $ErrorActionPreference = 'stop'
        $hash = @{}
    }
    Process {
        If ($PSBoundParameters['ComputerName']) {
            $hash['ComputerObject'] = Get-PSWSUSClient -Computername $Computername
        } ElseIf ($PSBoundParameters['ComputerObject']) {
            $hash['ComputerObject'] = $ComputerObject
        } Else {
            $hash['ComputerObject'] = Get-PSWSUSClient
        }
        ForEach ($object in $hash['ComputerObject']) {
            Try {
                If ($PSBoundParameters['UpdateScope']) {
                    $object.GetUpdateInstallationInfoPerUpdate($UpdateScope)
                } Else {
                    $object.GetUpdateInstallationInfoPerUpdate()
                }
            } Catch {
                Write-Warning ("{0}" -f $_.Exception.Message)
            }
        }        
    }  
    End {
        $ErrorActionPreference = 'continue'    
    } 
}