Public/Remove-RSJob.ps1

Function Remove-RSJob {
    <#
        .SYNOPSIS
            Deletes a Windows PowerShell runspace job.
 
        .DESCRIPTION
            Deletes a Windows PowerShell background job that has been started using Start-RSJob
 
        .PARAMETER Job
            The job object to remove.
 
        .PARAMETER Name
            The name of the jobs to remove..
 
        .PARAMETER ID
            The ID of the jobs to remove.
 
        .PARAMETER InstanceID
            The GUID of the jobs to remove.
 
        .PARAMETER Batch
            Name of the set of jobs to remove.
 
        .PARAMETER Force
            Force a running job to stop prior to being removed.
 
        .NOTES
            Name: Remove-RSJob
            Author: Boe Prox/Max Kozlov
 
        .EXAMPLE
            Get-RSJob -State Completed | Remove-RSJob
 
            Description
            -----------
            Deletes all jobs with a State of Completed.
 
            .EXAMPLE
            Remove-RSJob -ID 1,5,78
 
            Description
            -----------
            Removes jobs with IDs 1,5,78.
    #>

    [cmdletbinding(
        DefaultParameterSetName='Job',
        SupportsShouldProcess = $True
    )]
    Param (
        [parameter(ValueFromPipeline=$True,ValueFromPipelineByPropertyName=$True,
        ParameterSetName='Job', Position=0)]
        [Alias('InputObject')]
        [RSJob[]]$Job,
        [parameter(ValueFromPipeline=$True,ValueFromPipelineByPropertyName=$True,
        ParameterSetName='Name', Position=0)]
        [string[]]$Name,
        [parameter(ValueFromPipeline=$True,ValueFromPipelineByPropertyName=$True,
        ParameterSetName='Id', Position=0)]
        [int[]]$Id,
        [parameter(ValueFromPipelineByPropertyName=$True,
        ParameterSetName='InstanceID')]
        [string[]]$InstanceID,
        [parameter(ValueFromPipelineByPropertyName=$True,
        ParameterSetName='Batch')]
        [string[]]$Batch,

        [parameter()]
        [switch]$Force
    )
    Begin {
        If ($PSBoundParameters['Debug']) {
            $DebugPreference = 'Continue'
        }
        $List = New-Object System.Collections.ArrayList
    }
    Process {
        Write-Debug "ParameterSet: $($PSCmdlet.ParameterSetName)"
        $Property = $PSCmdlet.ParameterSetName
        if ($PSBoundParameters[$Property]) {
            Write-Verbose "Adding $($PSBoundParameters[$Property])"
            [void]$List.AddRange($PSBoundParameters[$Property])
        }
    }
    End {
        if (-not $List.Count) { return } # No jobs selected to search
        $PSBoundParameters[$Property] = $List
        [void]$PSBoundParameters.Remove('Force')
        [array]$ToRemove = Get-RSJob @PSBoundParameters
        if ($ToRemove.Count) {
            [System.Threading.Monitor]::Enter($PoshRS_Jobs.syncroot)
            try {
                $ToRemove | ForEach-Object {
                    If ($PSCmdlet.ShouldProcess("Name: $($_.Name), associated with JobID $($_.Id)",'Remove')) {
                        If ($_.State -notmatch 'Completed|Failed|Stopped') {
                            If ($Force) {
                                [void] $_.InnerJob.Stop()
                                $PoshRS_Jobs.Remove($_)
                            } Else {
                                Write-Error "Unable to remove job $($_.InstanceID)"
                            }
                        } Else {
                            [void]$PoshRS_Jobs.Remove($_)
                        }
                    }
                }
            }
            finally {
                [System.Threading.Monitor]::Exit($PoshRS_Jobs.syncroot)
            }
        }
    }
}