kbupdate

1.5.5

library/PoshWSUS/2.3.1.6/Scripts/Remove-PSWSUSUpdate.ps1

function Remove-PSWSUSUpdate {
    <#
    .SYNOPSIS
        Removes an update on WSUS.
         
    .DESCRIPTION
        Removes an update on WSUS.
         
    .PARAMETER Update
        Name of update being removed.
               
    .NOTES
        Name: Remove-PSWSUSUpdate
        Author: Boe Prox
        DateCreated: 24SEPT2010
         
        To Do:
            Allow for better use of pipelining. ex: Get-PSWSUSUpdate -Update 986569 | Remove-PSWSUSUpdate
                
    .LINK
        https://learn-powershell.net
         
    .EXAMPLE
    Remove-PSWSUSUpdate -update "KB986569"
 
    Description
    -----------
    This command will remove all instances of KB986569 from WSUS.
            
    #> 
    [cmdletbinding(
        DefaultParameterSetName = 'update',
        ConfirmImpact = 'low',
        SupportsShouldProcess = $True
    )]
        Param(
            [Parameter(
                Mandatory = $True,
                Position = 0,
                ParameterSetName = 'update',
                ValueFromPipeline = $True)]
                [string]$Update                                          
                ) 
    Begin {
        if($wsus)
        {
            #Gather all updates from given information
            Write-Verbose "Searching for updates"
            $patches = $wsus.SearchUpdates($update)
        }#endif
        else
        {
            Write-Warning "Use Connect-PSWSUSServer to establish connection with your Windows Update Server"
            Break
        }
    }            
    Process {
        ForEach ($patch in $patches) {
            #Storing update guid
            $guid = ($patch.id).updateid              
            If ($pscmdlet.ShouldProcess($($patch.title))) {
                $wsus.DeleteUpdate($guid)
                "$($patch.title) has been deleted from WSUS"
            }         
        }
    }    
}