官术网_书友最值得收藏!

Piping data to functions

In addition to passing data to functions via parameters, functions can receive data directly from another object or command via a pipe "|". Receiving values by piping helps improve scripting by limiting the use of temporary variables, as well as more easily passing complex object types or descriptors.

How to do it...

In this recipe, we will create a simple function that receives input from command line as well as pipe. To do this, carry out the following steps:

  1. Create a simple function that accepts a parameter:
    Function Square-Num
    {
        Param([float] $FirstNum)
        Write-Host ($FirstNum * $FirstNum)
    }
  2. Use the ValueFromPipeline parameter to enable the script to accept input from the pipeline:
    Function Square-Num
    {
        Param([float]
        [Parameter(ValueFromPipeline = $true)]
        $FirstNum )
        Write-Host ($FirstNum * $FirstNum)
    } 
  3. Test the function using parameters and by passing data from the pipeline:
    How to do it...

How it works...

The script in the first step itself is simple—it creates a variable named $FirstNum, squares it by multiplying the number against itself, and returns the result. In the second step we updated the parameter line with the following code:

    [Parameter(ValueFromPipeline=$true)]

This parameter option allows the function to assign a value to $FirstNum from the command line, as well as from the pipeline. PowerShell will first look for the value on the command line via name or location, and if it isn't listed, it will look for the value from the pipe.

There's more...

PowerShell will attempt to use all arguments provided to a function, and will report errors if there are unknown arguments. For instance, if we try to provide values from the pipeline and command line at the same time as shown in the following screenshot:

There's more...

As you can see from the example, we attempt to pass both 8 and 7 to the Square-Num function, the first via the pipe and the second via the command line. PowerShell reports an error, and then provides an answer of 49, the result of 7 X 7.

主站蜘蛛池模板: 尚义县| 宽城| 永春县| 永城市| 兴宁市| 土默特左旗| 泉州市| 日照市| 克拉玛依市| 囊谦县| 天等县| 博野县| 邵阳县| 丹巴县| 绥江县| 太白县| 南和县| 通州市| 泗阳县| 连城县| 肇源县| 瑞金市| 安陆市| 古蔺县| 独山县| 璧山县| 清镇市| 沙洋县| 太原市| 鄂托克旗| 桦川县| 无极县| 岑溪市| 镇平县| 无锡市| 阜新| 建始县| 资溪县| 墨玉县| 嘉鱼县| 大兴区|