Public/Receive-RSJob.ps1
|
Function Receive-RSJob { <# .SYNOPSIS Gets the results of the Windows PowerShell runspace jobs in the current session. .DESCRIPTION Gets the results of the Windows PowerShell runspace jobs in the current session. You can use Get-RSJob and pipe the results into this function to get the results as well. .PARAMETER Name The name of the jobs to receive available data from. .PARAMETER ID The ID of the jobs to receive available data from. .PARAMETER InstanceID The GUID of the jobs to receive available data from. .NOTES Name: Receive-RSJob Author: Boe Prox .EXAMPLE Get-RSJob -State Completed | Receive-RSJob Description ----------- Retrieves any available data that is outputted from completed RSJobs. .EXAMPLE Receive-RSJob -ID 1,5,78 Description ----------- Receives data from RSJob with IDs 1,5,78. #> [cmdletbinding( DefaultParameterSetName='Job' )] 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 ) 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) { $jobs | Where $ScriptBlock | Select -ExpandProperty Output } Else { ForEach ($Item in $list) { $Item.Output } } } } |