PowerShell で、複数の引数をパイプライン経由で扱うにはどうしたらよいでしょうか

Question

前提・実現したいこと

PowerShellで関数を自作しています。
引数として、年と月を取ります。
この引数をパイプライン経由でも受け取るようにしたいです。

コマンドライン引数を使用した場合とパイプラインから受け取る場合が両立できず悩んでいます。
普通はこうする。というような情報でも良いので、教えていただけないでしょうか。

# SYNTAX
#    Test-Function [-Year] <Int32> [-Month] <Int32> [<CommonParameters>]
Test-Function -Year 2014 -Month 3

このような実装です。

function Test-Function {
    Param(
        [Parameter(Mandatory)]
        [ValidateRange(1,9999)]
        [Int]
        $Year,
        [Parameter(Mandatory)]
        [ValidateRange(1,12)]
        [int]
        $Month
    )
    begin{}
    process{
        "Year: {0}" -f $Year
        "Month: {0}" -f $Month
    }
    end{}
}

発生している問題・試したこと

試行錯誤としては、

• 単純に下記のような渡しかたをしても、2014と3が渡るだけになってしまいます。

2014,3 | Test-Function
@(2014,3) | Test-Function

下記のように連想配列をパイプラインで流すことも考えてみましたが、普通にコマンドライン引数でパラメータを渡すときの挙動を変更したくありません。

@{Year=2014;Month=3} | Test-Function

下記のような受け取り方を考えたのですが、できれば必須属性を外したくありません。

function Test-Function {
    Param(
        [Parameter(Mandatory)]
        [ValidateRange(1,9999)]
        [Int]
        $Year,
        [Parameter(Mandatory)]
        [ValidateRange(1,12)]
        [int]
        $Month,
        [Parameter(ValueFromPipeline)]
        [System.Collections.Hashtable]
        $YearMonth
    )
    begin{}
    process{
        "Year: {0}" -f $Year
        "Month: {0}" -f $Month
    }
    end{}
}

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

PowerShellはv7.1を使用しています。

Comments

[Zuishin]

ValueFromPipelineByProperty は試しましたか？

[hos]

ありがとうございます！
ヒントをいただいたおかげで解決しました。
自己解決方法に記入します！

Answer 1

パラメータに、ValueFromPipelineByPropertyName属性を設定しオブジェクトを渡します。

function Test-Function {
    Param(
        [Parameter(Mandatory,ValueFromPipelineByPropertyName)]
        [ValidateRange(1,9999)]
        [Int]
        $Year,
        [Parameter(Mandatory,ValueFromPipelineByPropertyName)]
        [ValidateRange(1,12)]
        [int]
        $Month
    )
    begin{
    }
    process{d
        "Year: {0}" -f $Year
        "Month: {0}" -f $Month
    }
    end{}
}

呼び出しはこのような感じになり、自分のやりたい動作となります。

PS > [PsCustomObject]@{Year = 2014; Month = 12} | Test-Function

Year: 2014
Month: 12

PS > Test-Function -Year 2014 -Month 12 

Year: 2014
Month: 12

配列も想定通り動作しました。

PS> @([PsCustomObject]@{Year = 2014;Month = 12}, [PsCustomObject]@{Year = 2021;Month = 3}) | Test-Function                           

Year: 2014
Month: 12 
Year: 2021
Month: 3