PowerShell Splatting the Argumentlist on Invoke-Command

Question

How is it possible to use the parameters collected in a hash table for use with ArgumentList on Invoke-Command?

$CopyParams = @{
    Source      = 'E:\DEPARTMENTS\CBR\SHARE\Target'
    Destination = 'E:\DEPARTMENTS\CBR\SHARE\Target 2'
    Structure   = 'yyyy-MM-dd'
}
Invoke-Command -Credential $Cred -ComputerName 'SERVER' -ScriptBlock ${Function:Copy-FilesHC} -ArgumentList @CopyParams

Whatever I try, it's always complaining about the 'Source':

Cannot validate argument on parameter 'Source'. The "Test-Path $_" validation script for the argument with
 value "System.Collections.Hashtable" did not return true. Determine why the validation script failed

This blog talks about a similar problem, but I can't get it to work.

The same is true for a simple Copy-Item within Invoke-Command, example:

Invoke-Command -Credential $Cred -ComputerName 'SERVER' -ScriptBlock {Copy-Item} -ArgumentList @CopyParams

Invoke-Command : Missing an argument for parameter 'ArgumentList'. Specify a parameter of type 'System.Obj
ect[]' and try again.
At line:11 char:89
+ ... ck {Copy-Item} -ArgumentList @CopyParams

Thank you for your help.

Would help to see what's in the ScriptBlock - assume that's what's pulling args[0] and expecting it to be a hash? Also assume that's where the error message comes from? — arco444
– arco444, Commented Jan 30, 2015 at 11:40
Thank you for the reply arco444. The ScriptBlock is just a function with in the parameters a Test-path on [String]Source and [String]Destination. After this it just uses Copy-Item to copy stuff. It works fine when passing them as -ArgumentList $Source, $Destination, but not with splatting. — DarkLite1
– DarkLite1, Commented Jan 30, 2015 at 12:05
If you try it with my last example of Copy-Item, you'll see it doesn't work. Not even with the dollar sign. — DarkLite1
– DarkLite1, Commented Jan 30, 2015 at 12:19

Bacon Bits · Accepted Answer · 2017-10-24 21:08:20Z

8

One-liner, to convert a remote script to accept named parameters from a hash.

Given a scriptblock which you wish to call like this:

$Options = @{
    Parameter1 = "foo"
    Parameter2 = "bar"
}

Invoke-Command -ComputerName REMOTESERVER -ArgumentList $Options -ScriptBlock {
    param(
        $Parameter1,
        $Parameter2
    )
    #Script goes here, this is just a sample
    "ComputerName: $ENV:COMPUTERNAME"
    "Parameter1: $Parameter1"
    "Parameter2: $Parameter2"
}

You can convert it like so

Invoke-Command -Computername REMOTESERVER -ArgumentList $Options -ScriptBlock {param($Options)&{
    param(
        $Parameter1,
        $Parameter2
    )
    #Script goes here, this is just a sample
    "ComputerName: $ENV:COMPUTERNAME"
    "Parameter1: $Parameter1"
    "Parameter2: $Parameter2"
} @Options}

What's going on? Essentially we've wrapped the original script block like so:

{param($Options)& <# Original script block (including {} braces)#> @options }

This makes the original script block an anonymous function, and creates the outer script block which has a parameter $Options, which does nothing but call the inner script block, passing @options to splat the hash.

edited Oct 24, 2017 at 21:08

Bacon Bits

32.5k6 gold badges64 silver badges79 bronze badges

answered Mar 29, 2016 at 11:52

Ben

35.8k6 gold badges81 silver badges117 bronze badges

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

2 Comments

DarkLite1 Over a year ago

Great tip! Thanks Ben! :)

Petru Zaharia Over a year ago

Quite elegant solution :). Wrap your original (unchanged) scriptblock within a simple outer scriptblock that does all the unpacking (splatting). Reference here: about_Script_Blocks (search for call operator).

mjolinor · Accepted Answer · 2015-02-02 14:01:56Z

3

Here's one way to approach passing named parameters:

function Copy-FilesHC 
{
  param ($Source,$Destination,$Structure)
  "Source is $Source"
  "Desintation is $Destination"
  "Structure is $Structure"
  }


$CopyParams = @{
    Source      = 'E:\DEPARTMENTS\CBR\SHARE\Target'
    Destination = "'E:\DEPARTMENTS\CBR\SHARE\Target 2'" #Nested quotes required due to embedded space in value.
    Structure   = 'yyyy-MM-dd'
}

$SB = [scriptblock]::Create(".{${Function:Copy-FilesHC}} $(&{$args}@CopyParams)")

Invoke-Command -Credential $Cred -ComputerName 'SERVER' -ScriptBlock $SB

Basically, you create a new script block from your invoked script, with the parameters splatted to that from the hash table. Everything is already in the script block with the values expanded, so there's no argument list to pass.

edited Feb 2, 2015 at 14:01

answered Jan 30, 2015 at 14:38

mjolinor

68.7k7 gold badges118 silver badges141 bronze badges

2 Comments

DarkLite1 Over a year ago

Thank you mjolinor, it does work when there are no spaces in the Source path. When there are, it fails (Ex. Source = 'E:\DEPARTMENTS\CBR\SHARE\Target\De file.txt').

mjolinor Over a year ago

If the path contains embedded spaces, then you have to pass an explicitly quoted string, just the same as if you were passing it as a parameter at the command line. This is true in any situation where you're using a hash table to splat parameters, not just for this application. I simply missed that one of the values had an embedded space in the answer. You use the same hash table that you would use if you wanted to splat the parameters to the command if it was being run in the local session. I updated the answer with an example.

DarkLite1 · Accepted Answer · 2015-02-02 07:44:43Z

I found a workaround, but you have to make sure that your Advanced function which is located in your module file is loaded up front in the local session. So it can be used in the remote session. I wrote a small helper function for this.

Function Add-FunctionHC {
    [CmdletBinding(SupportsShouldProcess=$True)]
    Param(
        [String]$Name
    )
    Process {
        Try {
            $Module = (Get-Command $Name -EA Stop).ModuleName
        }
        Catch {
            Write-Error "Add-FunctionHC: Function '$Name' doesn't exist in any module"
            $Global:Error.RemoveAt('1')
            Break
        }
        if (-not (Get-Module -Name $Module)) {
            Import-Module -Name $Module
        }
    }
}

# Load funtion for remoting
Add-FunctionHC -Name 'Copy-FilesHC'

$CopyParams = @{
    Source      = 'E:\DEPARTMENTS\CBR\SHARE\Target\De file.txt'
    Destination = 'E:\DEPARTMENTS\CBR\SHARE\Target 2'
}

$RemoteFunctions = "function Copy-FilesHC {${function:Copy-FilesHC}}" #';' seperated to add more

Invoke-Command -ArgumentList $RemoteFunctions -ComputerName 'SERVER' -Credential $Cred -ScriptBlock {
    Param (
        $RemoteFunctions
    )
    . ([ScriptBlock]::Create($RemoteFunctions))
    $CopyParams = $using:CopyParams
    Copy-FilesHC @CopyParams
}

The big advantage is that you don't need to copy your complete function in the script and it can stay in the module. So when you change something in the module to the function it will also be available in the remote session, without the need to update your script.

This part was key for me: $CopyParams = $using:CopyParams. Thanks!

Ryan · Accepted Answer · 2017-12-20 22:10:00Z

0

I recently experienced a similar problem and solved it by building the hash (or rebuilding the hash) inside the invoke by leveraging the $using variable scope (more on that here)

it looks something like this:

$Source      = 'E:\DEPARTMENTS\CBR\SHARE\Target'
$Destination = 'E:\DEPARTMENTS\CBR\SHARE\Target 2'
$Structure   = 'yyyy-MM-dd'

Invoke-Command -Credential $Cred -ComputerName 'SERVER' -ScriptBlock {
    $CopyParms= @{ 
        'Source'=$Using:Source
        'Destination'=$Using:Destination
        'Structure'=$Using:Structure
    }
    Function:Copy-FilesHC @CopyParms
}

answered Dec 20, 2017 at 22:10

Ryan

3812 silver badges8 bronze badges

Comments

Carsten · Accepted Answer · 2018-11-15 08:43:40Z

0

This is what works for me:

$hash = @{
    PARAM1="meaning of life"
    PARAM2=42
    PARAM3=$true
}
$params = foreach($x in $hash.GetEnumerator()) {"$($x.Name)=""$($x.Value)"""}

answered Nov 15, 2018 at 8:43

Carsten

2,3411 gold badge24 silver badges42 bronze badges

1 Comment

Jason Thurston Over a year ago

Does it work with switch parameters?

markd · Accepted Answer · 2015-10-06 16:51:29Z

-1

I know this is late, but I ran into the same problem and found a solution that worked for me. Assigning it to a variable within the scriptblock and then using that variable to splat didn't show any problems.

Here's an example:

$param=@{"parameter","value"}
invoke-command -asjob -session $session -ScriptBlock {$a=$args[0];cmdlet @a } -ArgumentList $param

answered Oct 6, 2015 at 16:51

markd

1

1 Comment

Sebastian Over a year ago

@{"parameter","value"} is invalid syntax of hashtable, have you realy tested your posted script?

Collectives™ on Stack Overflow

PowerShell Splatting the Argumentlist on Invoke-Command

6 Answers 6

2 Comments

2 Comments

1 Comment

Comments

1 Comment

1 Comment

Your Answer

Linked

Hot Network Questions

Collectives™ on Stack Overflow

6 Answers 6

2 Comments

2 Comments

1 Comment

Comments

1 Comment

1 Comment

Your Answer

Sign up or log in

Post as a guest

Linked

Related