Skip to main content

Documentation Index

Fetch the complete documentation index at: https://tally.wharflab.com/llms.txt

Use this file to discover all available pages before exploring further.

powershell/PSUseProcessBlockForPipelineCommand is a PSScriptAnalyzer diagnostic emitted by tally for PowerShell snippets embedded in Dockerfiles.
PropertyValue
SeverityWarning
CategoryPSScriptAnalyzer
Auto-fixNo

​
Description

Functions that support pipeline input should always handle parameter input in a process block. Unexpected behavior can result if input is handled directly in the body of a function where parameters declare pipeline support.

​
Examples

​
Problematic code

Function Get-Number
{
    [CmdletBinding()]
    Param(
        [Parameter(ValueFromPipeline)]
        [int]
        $Number
    )

    $Number
}

​
Result

PS C:\> 1..5 | Get-Number
5

​
Correct code

Function Get-Number
{
    [CmdletBinding()]
    Param(
        [Parameter(ValueFromPipeline)]
        [int]
        $Number
    )

    process
    {
        $Number
    }
}

​
Result

PS C:\> 1..5 | Get-Number
1
2
3
4
5

​
Source

This rule documentation is adapted from Microsoft’s PSScriptAnalyzer documentation for UseProcessBlockForPipelineCommand, licensed under CC BY 4.0.