Is a string parameter sent to PowerShell not really a string?

Question

I am bit confused of the behaviour of the script below:

Test.ps1:

param(
    [array]$Value = $(throw "Give me a value")
)

Write-Host $Value 
$Value | Get-Member -MemberType Method
$Value.ToUpper()

Running the script:

PS C:\Temp> .\weird.ps1 test
TypeName: System.String
Name MemberType Definition
—- ———- ———-
…
ToUpper Method string ToUpper(), string ToUpper(System.Globalization.CultureInfo culture)
…
Method invocation failed because [System.Object[]] doesn’t contain a method named ‘ToUpper’.
At C:\Temp\weird.ps1:6 char:15
+ $Value.ToUpper <<<< ()
+ CategoryInfo : InvalidOperation: (ToUpper:String) [], RuntimeException
+ FullyQualifiedErrorId : MethodNotFound

Why do I get a MethodNotFound exception? Get-Member clearly says it is a string.

JaredPar · Accepted Answer · 2010-08-19 17:06:23Z

5

What's happening here is that the variable $value is typed to Object[] in the script. The call to Get-Member works because you are piping the value into the function. Hence instead of seeing the array it sees the values in the array which are indeed typed to String. This can be viewed by using the following Get-Member call without piping

Get-Member -MemberType Method -InputObject $value

This is also why ToUpper correctly fails (it's an array not a String).

answered Aug 19, 2010 at 17:06

JaredPar

759k152 gold badges1.3k silver badges1.5k bronze badges

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

Comments

x0n · Accepted Answer · 2010-08-19 17:07:15Z

When you pipe a collection of anything in powershell, it gets "unrolled" and sent one by one to the right hand side of the bar (pipe) character. This means that the contents of the array get sent to get-member. Get-member only accepts the first item sent to it, so it shows you the members of the string. Your parameter is of type [array], so the parameter binder sets $value to an array of length 1, containing your string "test."

Example:

ps> @(1,"hello",3) | gm
... shows members of int32

ps> @("hello", 1, 3) | gm
... shows members of string

In order to see the members of an array when you pipe it, you should wrap it in another array, so it becomes the unrolled item:

ps> ,@("hello", 1, 3) | gm
... shows members of array

The leading comma "," creates a wrapping array.

-Oisin

driis · Accepted Answer · 2010-08-19 17:07:12Z

2

$Value is actually an array, because that is how you declare the parameter in your param block.

answered Aug 19, 2010 at 17:07

driis

165k46 gold badges272 silver badges345 bronze badges

Collectives™ on Stack Overflow

Is a string parameter sent to PowerShell not really a string?

3 Answers 3

Comments

Comments

Comments

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

3 Answers 3

Comments

Comments

Comments

Your Answer

Sign up or log in

Post as a guest

Related