PowerShellの関数で戻り値の型が変化してしまう

Question

実現したいこと

PowerShellの関数中にGeneric.Listオブジェクトを作成して
戻り値として受け取りたいのですが
戻り値の型が変わってしまいます。

該当のソースコード

function function_name {
	# 戻り値の型の設定
	[OutputType([System.Collections.Generic.List[string]])]

	# 関数中でGeneric.Listオブジェクトを作成
	$List = New-Object System.Collections.Generic.List[string]
	$List.add("a")>$null
	$List.add("b")>$null

	return $List
}

# 関数を実行
$return = function_name

発生している問題・エラーメッセージ

$return.gettype()とすると下のようにSystem.Array型になっており
Generic.List型になっていません

IsPublic IsSerial Name                                     BaseType    
-------- -------- ----                                     --------    
True     True     Object[]                                 System.Array

試したこと

OutputTypeは指定してもしなくても変わりませんでした。
標準出力には出力しないようにしているので戻り値に含まれていないはずです。

どうしたら戻り値をGeneric.List型で受け取れますか？

補足情報（FW/ツールのバージョンなど）

Windows 10 64bit
PowerShell 7.3.3

Comments

[Zuishin]

return ,$List

[nuh]

return ,$List
これで目的の動作になりました
ありがとうございます！

Answer 1

Outputting collections (not just arrays) causes PowerShell to enumerate them by default - i.e., the collection's elements are sent one by one to the success output stream.
(機械翻訳)コレクション（配列に限らず）を出力すると、PowerShellはデフォルトで列挙する、つまりコレクションの要素を1つずつ成功出力ストリームに送信する。
https://stackoverflow.com/questions/50843357/returning-arraylist-from-function-script

コレクションは列挙し直した形で取得されるようです。
列挙された結果、配列になっているみたいです。
Write-Outputの-NoEnumerateオプションを指定するとコレクションオブジェクトのまま取得できるみたいです。

function function_name {
	# 戻り値の型の設定
	[OutputType([System.Collections.Generic.List[string]])]

	# 関数中でGeneric.Listオブジェクトを作成
	$List = New-Object System.Collections.Generic.List[string]
	$List.add("a")>$null
	$List.add("b")>$null

	# return $List
    Write-Output -NoEnumerate $List
}

# 関数を実行
$return = function_name

PowerShellのドキュメントです。
https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/write-output?view=powershell-7.3#-noenumerate

Comments

[nuh]

なるほど！理解できました。
Write-Output -NoEnumerate $List
で1つの要素として扱ったり
,$List
で1つの要素の配列として戻り値にすることで
コレクションをそのまま受け取れるようになるんですね
ありがとうございました。

Answer 2

return 文にカンマ(,)を追加します。

function function_name {
	  # 関数中でGeneric.Listオブジェクトを作成
	  $List = New-Object System.Collections.Generic.List[string]
	  $List.add("a")
	  $List.add("b")

	  return ,$List
}

# 関数を実行
$return = function_name
$return.gettype().FullName

# System.Collections.Generic.List`1[[System.String, System.Private.CoreLib, Version=7.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Comments

[melian]

すみません、既に解決済みでしたね。。。

[nuh]

いえいえ、ありがとうございます！