Pass arguments to a scriptblock in powershell

Question

I guess you can't just do this:

  $servicePath = $args[0]

  if(Test-Path -path $servicePath) <-- does not throw in here

  $block = {

        write-host $servicePath -foreground "magenta"

        if((Test-Path -path $servicePath)) { <-- throws here.

              dowork 
        }
  }

So how can I pass my variables to the scriptblock $block?

What will you do with your scriptblock? Use Invoke-Command or &? — Lars Truijens
– Lars Truijens, Commented May 2, 2013 at 21:06
If you plan to use & then you can do this: & { param($hello) $hello } -hello world — JohnL
– JohnL, Commented May 2, 2013 at 21:09
@LarsTruijens - I am planning to do the Invoke-Command -Session — dexter
– dexter, Commented May 3, 2013 at 14:25

jpaugh · Accepted Answer · 2019-09-10 15:35:02Z

71

Keith's answer also works for Invoke-Command, with the limit that you can't use named parameters. The arguments should be set using the -ArgumentList parameter and should be comma separated.

$sb = {
    param($p1,$p2)
    $OFS=','
    "p1 is $p1, p2 is $p2, rest of args: $args"
}
Invoke-Command $sb -ArgumentList 1,2,3,4

Also see here and here.

edited Sep 10, 2019 at 15:35

jpaugh

7,1745 gold badges46 silver badges94 bronze badges

answered May 3, 2013 at 16:57

Lars Truijens

43.9k6 gold badges134 silver badges146 bronze badges

Sign up to request clarification or add additional context in comments.

Comments

participant · Accepted Answer · 2015-09-23 09:44:08Z

46

A scriptblock is just an anonymous function. You can use $args inside the scriptblock as well as declare a param block, for example

$sb = {
  param($p1, $p2)
  $OFS = ','
  "p1 is $p1, p2 is $p2, rest of args: $args"
}
& $sb 1 2 3 4
& $sb -p2 2 -p1 1 3 4

edited Sep 23, 2015 at 9:44

participant

3,0132 gold badges26 silver badges40 bronze badges

answered May 3, 2013 at 3:22

Keith Hill

203k44 gold badges370 silver badges377 bronze badges

4 Comments

Kakira Over a year ago

Right, but don't closures traditionally capture variables as well? I'd assume that $servicePath above would be captured.

Keith Hill Over a year ago

Not in PowerShell. If you run the scriptblock in the current runspace, then yeah, those variables are picked up. But that is just a dynamic scoping feature. Try this with the scriptblock for Start-Job, where the scriptblock is serialized to another PowerShell process for execution and you will see no automatically captured variables.

Steve can help Over a year ago

If I wanted to run this same function as a new on-screen Powershell instance, is there any way to pass the arguments in? I'd have thought it would just be something like start powershell $sb(1,2).

djvg Over a year ago

Also see documentation for $args and about script-blocks.

user724067 · Accepted Answer · 2020-05-19 19:57:26Z

20

For anyone reading in 2020 who wants to use local variables in a remote session script block, starting in Powershell 3.0 you can use local variables directly in the scriptblock with the "$Using" scope modifier. Example:

$MyLocalVariable = "C:\some_random_path\"
acl = Invoke-Command -ComputerName REMOTEPC -ScriptBlock {Get-Acl $Using:MyLocalVariable}

Found in example 9 of https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/invoke-command?view=powershell-7

answered May 19, 2020 at 19:57

user724067

3012 silver badges3 bronze badges

1 Comment

maclu Over a year ago

I think this is the cleanest look, since our typical use-case for scriptblocks has variables set previously within the same function or script, not being passed in externally.

Jean-Claude DuBois · Accepted Answer · 2017-05-25 20:12:41Z

13

BTW, if using the script block to run in a separate thread (multi threaded):

$ScriptBlock = {
    param($AAA,$BBB) 
    return "AAA is $($AAA) and BBB is $($BBB)"
}

$AAA = "AAA"
$BBB = "BBB1234"    
$null = Start-Job $ScriptBlock -ArgumentList $AAA,$BBB

then yields:

$null = Start-Job $ScriptBlock -ArgumentList $AAA,$BBB    
Get-Job | Receive-Job
AAA is AAA and BBB is BBB1234

answered May 25, 2017 at 20:12

Jean-Claude DuBois

3865 silver badges9 bronze badges

Comments

Chris R. Donnelly · Accepted Answer · 2017-10-16 18:40:20Z

5

By default PowerShell won't capture variables for a ScriptBlock. You can explicitly capture by calling GetNewClosure() on it, however:

$servicePath = $args[0]

if(Test-Path -path $servicePath) <-- does not throw in here

$block = {

    write-host $servicePath -foreground "magenta"

    if((Test-Path -path $servicePath)) { <-- no longer throws here.

          dowork 
    }
}.GetNewClosure() <-- this makes it work

answered Oct 16, 2017 at 18:40

Chris R. Donnelly

3,1453 gold badges30 silver badges29 bronze badges

4 Comments

Ian Kemp - SO dead by AI greed Over a year ago

Note that GetNewClosure() doesn't appear to work with Start-Job.

Chris R. Donnelly Over a year ago

@IanKemp Interesting, do you know any more as to why it doesn't? Does it fail as the original question describes, or with a different error?

Ian Kemp - SO dead by AI greed Over a year ago

@ChrisRDonnelly Seems that the variables' values simply don't get copied into the variables in the ScriptBlock, so those inside the block end up having the default value (null).

papo Over a year ago

It does only work with Global variables. If you have a script block and another script block inside it, the variable defined inside first - parent script block will become Local and GetNewClosure() will not capture and make it available inside the second - child script block. Need to make it Global, e.g.:

function parentScriptBlock(myParam) { myVar = 3; $Global:myVar = $myVar; $Global:myParam = $myParam; childScriptBlock = { echo $myParam }.GetNewClosure(); # use the script block here }

schen · Accepted Answer · 2020-11-05 14:20:06Z

3

Three example syntax:

$a ={ 
  param($p1, $p2)
  "p1 is $p1"
  "p2 is $p2"
  "rest of args: $args"
}
//Syntax 1:
Invoke-Command $a -ArgumentList 1,2,3,4 //PS> "p1 is 1, p2 is 2, rest of args: 3 4"
//Syntax 2:
&$a -p2 2 -p1 1 3      //PS> "p1 is 1, p2 is 2, rest of args: 3"
//Syntax 3:
&$a 2 1 3              //PS> "p1 is 2, p2 is 1, rest of args: 3"

answered Nov 5, 2020 at 14:20

schen

1371 gold badge2 silver badges7 bronze badges

Comments

Sled · Accepted Answer · 2023-01-27 15:40:20Z

3

Other possibility:

$a ={ 
    param($p1, $p2)
    "p1 is $p1"
    "p2 is $p2"
    "rest of args: $args"
};
$a.invoke(1,2,3,4,5)

edited Jan 27, 2023 at 15:40

Sled

19.1k28 gold badges125 silver badges173 bronze badges

answered Feb 26, 2021 at 15:08

koekjesdoos

312 bronze badges

Comments

SpaceGhost440 · Accepted Answer · 2017-02-07 18:59:02Z

I know this article is a bit dated, but I wanted to throw this out as a possible alternative. Just a slight variation of the previous answers.

$foo = {
    param($arg)

    Write-Host "Hello $arg from Foo ScriptBlock" -ForegroundColor Yellow
}

$foo2 = {
    param($arg)

    Write-Host "Hello $arg from Foo2 ScriptBlock" -ForegroundColor Red
}


function Run-Foo([ScriptBlock] $cb, $fooArg){

    #fake getting the args to pass into callback... or it could be passed in...
    if(-not $fooArg) {
        $fooArg = "World" 
    }
    #invoke the callback function
    $cb.Invoke($fooArg);

    #rest of function code....
}

Clear-Host

Run-Foo -cb $foo 
Run-Foo -cb $foo 

Run-Foo -cb $foo2
Run-Foo -cb $foo2 -fooArg "Tim"

Collectives™ on Stack Overflow

Pass arguments to a scriptblock in powershell

8 Answers 8

Comments

4 Comments

1 Comment

Comments

4 Comments

Comments

Comments

Comments

Linked

Hot Network Questions

Collectives™ on Stack Overflow

8 Answers 8

Comments

4 Comments

1 Comment

Comments

4 Comments

Comments

Comments

Comments

Linked

Related