Support Input from the Pipeline

📐 Guideline.

In each parameter set for a cmdlet, include at least one parameter that supports input from the pipeline. This lets the user retrieve data or objects, send them to the correct parameter set, and pass the results directly to a cmdlet.

How a parameter accepts pipeline input.

A parameter accepts input from the pipeline when the Parameter attribute includes the ValueFromPipeline keyword, the ValueFromPipelineByPropertyName keyword, or both. If no parameter in a parameter set supports either keyword, the cmdlet cannot meaningfully be placed after another cmdlet because it will ignore any pipeline input.