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

function Get-PSWSUSClientPerUpdate {
    <#
    .SYNOPSIS
        Gets collection of clients for specified update based on groupname or defined computer scope
         
    .DESCRIPTION
        Gets collection of clients for specified update based on groupname or defined computer scope
         
    .PARAMETER Update
        Name of the update to collect data on.
         
    .PARAMETER GroupName
        Name of the group to perform query against. Will default to all groups if not used.
     
    .PARAMETER IncludeChildGroup
        Includes child groups if using GroupName parameter
     
    .PARAMETER ComputerScope
        Collection of computers that can be used for query
         
    .NOTES
        Name: Get-PSWSUSClientPerUpdate
        Author: Boe Prox
        DateCreated: 23NOV2011
                
    .LINK
        https://learn-powershell.net
         
    .EXAMPLE
        Get-PSWSUSClientPerUpdate -GroupName Servers -Update 935490
 
        Computername TargetGroup UpdateKB UpdateTitle UpdateInstallationSt
                                                                                                           ate
        ------------ ----------- -------- ----------- --------------------
        Server.domain.com 935490 Update Rollup 2 for Exchange Server 2... Unknown
        Server.domain.com 935490 Update Rollup 2 for Exchange Server 2... Unknown
        Server.domain.com 935490 Update Rollup 2 for Exchange Server 2... Unknown
 
        Description
        -----------
        Gets the Installation State of all members of the Servers group for update 935490
     
    .EXAMPLE
        $scope = New-PSWSUSComputerScope -NameIncludes "V" -FromLastSyncTime (Get-Date).AddDays(-14)
        Get-PSWSUSClientPerUpdate -ComputerScope $scope -Update 935490
 
        Computername TargetGroup UpdateKB UpdateTitle UpdateInstallationSt
                                                                                                           ate
        ------------ ----------- -------- ----------- --------------------
        Server.domain.com 935490 Update Rollup 2 for Exchange Server 2... Unknown
        Server.domain.com 935490 Update Rollup 2 for Exchange Server 2... Unknown
        Server.domain.com 935490 Update Rollup 2 for Exchange Server 2... Unknown
 
        Description
        -----------
        Gets the Installation State of all members of the Servers group for update 935490
    #>
 
    [cmdletbinding(
        ConfirmImpact = 'low',
        DefaultParameterSetName = 'ComputerScope'
    )]
    Param(
        [Parameter(Position = 0, ParameterSetName = '',ValueFromPipeLine = $True)]
        [Object]$Update,
        [Parameter(Position = 1, ParameterSetName = 'ComputerScope')]
        [Microsoft.UpdateServices.Administration.ComputerTargetScope]$ComputerScope,        
        [Parameter(Position = 1, ParameterSetName = 'Group')]
        [string]$GroupName,
        [Parameter(Position = 2, ParameterSetName = 'Group')]   
        [Switch]$IncludeChildGroup                                                                                                 
    )
    Begin {                
        $ErrorActionPreference = 'stop'
        $hash = @{}
    }
    Process {
        If ($PSBoundParameters['Update'] -is [string] -OR $PSBoundParameters['Update'] -is [int]) {
            Write-Verbose "Getting update object from string"
            $hash['UpdateObject'] = Get-PSWSUSUpdate -Update $Update
        } ElseIf ($PSBoundParameters['Update'] -is [Microsoft.UpdateServices.Internal.BaseApi.Update]) {
            Write-Verbose "Getting update object from object"
            $hash['UpdateObject'] = $Update
        } Else {
            Write-Warning "No update specified!"
            Break
        }
        If ($PSBoundParameters['GroupName']) {
            Write-Verbose "Gathering data from specified group"
            $hash['GroupObject'] = Get-PSWSUSGroup -Name $GroupName
            ForEach ($Object in $hash['UpdateObject']) {
                Try {
                    If ($PSBoundParameters['IncludeChildGroup']) {
                        $Object.GetUpdateInstallationInfoPerComputerTarget($hash['GroupObject'],$True)
                    } Else {
                        $Object.GetUpdateInstallationInfoPerComputerTarget($hash['GroupObject'],$False)
                    }
                } Catch {
                    Write-Warning ("{0}" -f $_.Exception.Message)
                }
            }
        } ElseIf ($PSBoundParameters['ComputerScope']) {
            Write-Verbose "Gathering data from all clients"
            ForEach ($Object in $hash['UpdateObject']) {
                Try {            
                    $Object.GetUpdateInstallationInfoPerComputerTarget($ComputerScope)
                } Catch {
                    Write-Warning ("{0}" -f $_.Exception.Message)
                } 
            }           
            
        } Else {
            Write-Warning "No Group or ComputerScope object specified!"
        }
    }  
    End {
        $ErrorActionPreference = 'continue'    
    } 
}