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 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 Job The job object to remove. .PARAMETER Force Force a running job to stop prior to being removed. .NOTES Name: Remove-RSJob Author: Boe Prox .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='Name')] [string[]]$Name, [parameter(ValueFromPipeline=$True,ValueFromPipelineByPropertyName=$True, ParameterSetName='Id')] [int[]]$Id, [parameter(ValueFromPipeline=$True,ValueFromPipelineByPropertyName=$True, ParameterSetName='Guid')] [guid[]]$InstanceID, [parameter(ValueFromPipeline=$True,ParameterSetName='Job')] [PoshRS.PowerShell.RSJob[]]$Job, [parameter()] [switch]$Force ) Begin { If ($PSBoundParameters['Debug']) { $DebugPreference = 'Continue' } $List = New-Object System.Collections.ArrayList $StringBuilder = New-Object System.Text.StringBuilder #Take care of bound parameters If ($PSBoundParameters['Name']) { [void]$list.AddRange($Name) $Bound = $True } If ($PSBoundParameters['Id']) { [void]$list.AddRange($Id) $Bound = $True } If ($PSBoundParameters['InstanceId']) { [void]$list.AddRange($InstanceId) $Bound = $True } If ($PSBoundParameters['Job']) { [void]$list.AddRange($Job) $Bound = $True } } Process { If (-Not $Bound) { [void]$List.Add($_) } } End { Write-Debug "ParameterSet: $($PSCmdlet.parametersetname)" Switch ($PSCmdlet.parametersetname) { 'Name' { $Items = '"{0}"' -f (($list | ForEach {"^{0}$" -f $_}) -join '|') -replace '\*','.*' [void]$StringBuilder.Append("`$_.Name -match $Items") $ScriptBlock = [scriptblock]::Create($StringBuilder.ToString()) } 'Id' { $Items = '"{0}"' -f (($list | ForEach {"^{0}$" -f $_}) -join '|') [void]$StringBuilder.Append("`$_.Id -match $Items") $ScriptBlock = [scriptblock]::Create($StringBuilder.ToString()) } 'Guid' { $Items = '"{0}"' -f (($list | ForEach {"^{0}$" -f $_}) -join '|') [void]$StringBuilder.Append("`$_.InstanceId -match $Items") $ScriptBlock = [scriptblock]::Create($StringBuilder.ToString()) } Default {$ScriptBlock=$Null} } If ($ScriptBlock) { Write-Verbose "Using ScriptBlock" $ToRemove = $jobs | Where $ScriptBlock } Else { $ToRemove = $List } [System.Threading.Monitor]::Enter($Jobs.syncroot) $ToRemove | ForEach { If ($PSCmdlet.ShouldProcess("Name: $($_.Name), associated with JobID $($_.Id)",'Remove')) { If ($_.State -notmatch 'Completed|Failed') { If ($PSBoundParameters.ContainsKey('Force')) { $_.InnerJob.EndInvoke($_.Handle) $Jobs.Remove($_) } Else { Write-Error "Unable to remove job $($_.InstanceID)" } } Else { [void]$jobs.Remove($_) } } } [System.Threading.Monitor]::Exit($Jobs.syncroot) } } |