- \n
- Beginning Use of PowerShell Runspaces: Part 1<\/a>\u00a0\u00a0\u00a0Begin use with runspaces.<\/li>\n
- Beginning Use of PowerShell Runspaces: Part 2<\/a>\u00a0\u00a0\u00a0Begin use with runspaces.<\/li>\n
- Beginning Use of PowerShell Runspaces: Part 3<\/a>\u00a0\u00a0Use runspace pools for multithreading.<\/li>\n
- A Look at the PoshRSJob Module<\/a>\u00a0\u00a0\u00a0Learn about a module for working with runspaces.<\/li>\n<\/ul>\n
There are some great scripts out there that provide a tool to work with runspaces, such as Invoke-Parallel<\/a>. I wanted to come up with something that would provide a familiar approach to spinning off multiple commands in parallel\u2014like what we have with the *-Job<\/b> cmdlets. With that in my mind, I set out to basically copy those cmdlets by using the same naming scheme and parameter names as those cmdlets. But instead of relying on the PSJobs framework, I instead rely on runspaces and runspace pools to provide a way to run commands and other tasks concurrently with the benefits of runspaces.<\/p>\n
My module, PoshRSJob<\/b>, does just that, and it is available to download a number of ways. If you have access to the PowerShellGet<\/b> module, you can easily download the module by using Save-Module<\/b>. (This is better for those who want to inspect their downloaded modules before actually installing them.)<\/p>\n
Save-Module \u2013Name PoshRSJob \u2013Path C:\\ModulesToReview<\/p>\n
Or if you want to install it without having to save it first, you can use Install-Module <\/b>instead:<\/p>\n
Install-Module \u2013Name PoshRSJob<\/p>\n
Another option is to head over to my GitHub page,\u00a0proxb\/PoshRSJob<\/a>,\u00a0and download the zip file. GitHub is where I post my code prior to placing it in the PowerShell Gallery. I am always open to folks who want to make my code better or fix a bug that they may find. so be sure to fork it and submit a pull request if you want to help out.<\/p>\n
Now that you have the module available and ready to use, the first thing we should do is look at the available functions that you can use. With the exception of the RS being prepended to each noun, the commands will look pretty familiar to you.<\/p>\n
Get-Command \u2013Module PoshRSJob<\/p>\n
![\"Image](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/29\/2019\/02\/1_PoshRSJob.png\" "\\"Image")
<\/a><\/p>\nThere are a few commands missing (Suspend<\/b>, Resume<\/b>, and Debug<\/b>), but the core commands are here to work with.<\/p>\n
I won\u2019t take you through each command and its parameters, but I can assure you that the parameters are almost identical to the ones that you would find using the *-Job<\/b> cmdlets. This is definitely by design because I wanted a familiar approach for running the commands. Even the output of the RSJob<\/b> objects will have a familiar look.<\/p>\n
Let\u2019s start with a quick example of how we would use this module. I am going to use a range of numbers and send them to Start-RSJob<\/b> to create a job for each number. One of the most important things that I can stress about doing this is that you should never<\/b> use ForEach<\/b> with Start-RJob<\/b> because it will create a runspace pools for each iteration of ForEach<\/b>.<\/p>\n
All of the processing of the objects happens within Start-RSJob<\/b>. You will have to make use of $_<\/b> in your script block to represent each item that is piped to Start-RSJob<\/b>, as shown in the following example:<\/p>\n
$Test = ‘test’<\/p>\n
$Something = 1..10<\/p>\n
1..5|start-rsjob -Name {$_} -ScriptBlock {<\/p>\n
\u00a0\u00a0\u00a0 [pscustomobject]@{<\/p>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 Result=($_*2)<\/p>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 Test=$Using:Test<\/p>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 Something=$Using:Something<\/p>\n
\u00a0\u00a0\u00a0 }<\/p>\n
}<\/p>\n
![\"Image](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/29\/2019\/02\/2_PoshRSJob.png\" "\\"Image")
<\/a><\/p>\nI also have the ability to include the $Using:<\/b> variable, which you may have seen before. This allows you to use a variable from the parent scope within the runspace job so you do not have to worry about messing with a Param()<\/b> block in your script block, and then ensure you have the order correct with the \u2013ArgumentList<\/b> parameter. I will add that you can still do this if you want to because I wanted to keep that familiar functionality available.<\/p>\n
Now, to check if they have completed yet:<\/p>\n
Get-RSJob<\/p>\n
![\"Image](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/29\/2019\/02\/3_PoshRSJob.png\" "\\"Image")
<\/a><\/p>\nLooks like they are not only complete, but they also have data available to retrieve. I can do that by using Receive-RSJob<\/b> and display the output from the RSJobs<\/b>:<\/p>\n
Get-RSJob | Receive-RSjob<\/p>\n
![\"Image](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/29\/2019\/02\/4_PoshRSJob.png\" "\\"Image")
<\/a><\/p>\nThis example isn\u2019t really that impressive, but you can see that all of my jobs completed in the background as runspaces in a runspace pool, and I was able to do all of this by using commands that you are familiar with!<\/p>\n
I\u2019ll finish up by removing those RSJobs<\/b> because they are no longer needed\u201d<\/p>\n
Get-RSJob | Remove-RSJob<\/p>\n
The last example might be a little more useful than simply looking at a collection of numbers. The following example also utilizes a custom function of mine that I want to have available within my runspace pool, so it can be used by all of the runspaces.<\/p>\n
Function Convert-Size {<\/p>\n
\u00a0\u00a0\u00a0 [cmdletbinding()]<\/p>\n
\u00a0\u00a0\u00a0 Param (<\/p>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 [parameter(ValueFromPipeline=$True,ValueFromPipelineByPropertyName=$True)]<\/p>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 [Alias(“Length”)]<\/p>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 [int64]$Size<\/p>\n
\u00a0\u00a0\u00a0 )<\/p>\n
\u00a0\u00a0\u00a0 Begin {<\/p>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 If (-Not $ConvertSize) {<\/p>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 Write-Verbose (“Creating signature from Win32API”)<\/p>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 $Signature =\u00a0 @”<\/p>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 [DllImport(“Shlwapi.dll”, CharSet = CharSet.Auto)]<\/p>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 public static extern long StrFormatByteSize( long fileSize, System.Text.StringBuilder buffer, int bufferSize );<\/p>\n
“@<\/p>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 $Global:ConvertSize = Add-Type -Name SizeConverter -MemberDefinition $Signature -PassThru<\/p>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 }<\/p>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 Write-Verbose (“Building buffer for string”)<\/p>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 $stringBuilder = New-Object Text.StringBuilder 1024<\/p>\n
\u00a0\u00a0\u00a0 }<\/p>\n
\u00a0\u00a0\u00a0 Process {<\/p>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 Write-Verbose (“Converting {0} to upper most size” -f $Size)<\/p>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 $ConvertSize::StrFormatByteSize( $Size, $stringBuilder, $stringBuilder.Capacity ) | Out-Null<\/p>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 $stringBuilder.ToString()<\/p>\n
\u00a0\u00a0\u00a0 }<\/p>\n
}<\/p>\n
Get-ChildItem $PWD -Directory | Start-RSJob -Name {$_.Name} -ScriptBlock {<\/p>\n
\u00a0\u00a0\u00a0 [int64]$Bytes = (Get-ChildItem -Path $_.FullName -Force -Recurse | Measure-Object -Property length -Sum).Sum<\/p>\n
\u00a0\u00a0\u00a0 [pscustomobject]@{<\/p>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 Name = $_.Name<\/p>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 Size = Convert-Size -Size $Bytes<\/p>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 Size_bytes = $Bytes<\/p>\n
\u00a0\u00a0\u00a0 }<\/p>\n
\u00a0\u00a0\u00a0 Start-Sleep -Seconds (Get-Random -InputObject (1..5))<\/p>\n
} -FunctionsToLoad Convert-Size -Throttle 5 | Wait-RSJob -ShowProgress |<\/p>\n
Receive-RSJob | Sort-Object -Property Size_bytes -Descending<\/p>\n
Get-RSJob | Remove-RSJob<\/p>\n
I also make use of the Wait-RSJob<\/b> function here, which gives me a little progress bar (shown in the following image), so I know the current status of the RSJobs. At the end, I retrieve the data and dispose of the jobs.<\/p>\n
![\"Image](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/29\/2019\/02\/5_PoshRSJob.png\" "\\"Image")
<\/a><\/p>\nIn addition to being able to import custom functions, you can import modules by using \u2013ModulesToImport<\/b>. You can also work with PSSnapins if you need to import one of those.<\/p>\n
If you want to know more about this module, be sure to hit up my GitHub page, proxb\/PoshRSJob<\/a>. If you want to help make this module even better, be sure to contribute!<\/p>\n
I invite you to follow the Scripting Guy on\u00a0Twitter<\/a>\u00a0and\u00a0Facebook<\/a>. If you have any questions, send email to the Scripting Guy at\u00a0scripter@microsoft.com<\/a>, or post your questions on the\u00a0Official Scripting Guys Forum<\/a>. Until then, see ya!<\/p>\n
Boe Prox<\/strong>, Microsoft Cloud and Datacenter Management MVP and Honorary Scripting Guy<\/p>\n","protected":false},"excerpt":{"rendered":"
Summary: Boe Prox presents a module for working with runspaces. Honorary Scripting Guy and Cloud and Datacenter Management MVP, Boe Prox, here today filling in for my good friend, The Scripting Guy. Today I finish up my series about using runspaces in PowerShell by showing you a module that I put together that makes working […]<\/p>\n","protected":false},"author":596,"featured_media":87096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[162,56,597,650,3,45],"class_list":["post-75391","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-boe-prox","tag-guest-blogger","tag-module","tag-runspace","tag-scripting-guy","tag-windows-powershell"],"acf":[],"blog_post_summary":"
Summary: Boe Prox presents a module for working with runspaces. Honorary Scripting Guy and Cloud and Datacenter Management MVP, Boe Prox, here today filling in for my good friend, The Scripting Guy. Today I finish up my series about using runspaces in PowerShell by showing you a module that I put together that makes working […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/75391","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/users\/596"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=75391"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/75391\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media\/87096"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media?parent=75391"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=75391"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=75391"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
- Beginning Use of PowerShell Runspaces: Part 2<\/a>\u00a0\u00a0\u00a0Begin use with runspaces.<\/li>\n