Powershell Sample Function

Sample-Function.ps1

function Sample-Function {
    # Turns a regular function into an advanced function, adding common
    # parameters like `-Verbose` and `-WhatIf`.
    # Note: The `[...]` syntax is an "attribute" in PowerShell.
    [CmdletBinding()] 

    # parameter configuration and typing.
    param (
        [Parameter(Mandatory,
                   # Allows to take input from the pipeline, if present.
                   ValueFromPipeline,

                   # Allows to take input from a particular property of the
                   # piped object, if present.
                   ValueFromPipelineByPropertyName)]
        [string[]]$ComputerName
    )

    # A 'process' block is needed when accepting pipeline input.
    # Otherwise, you can just inline the logic in the function body.
    process {
        foreach ($Computer in $ComputerName) {
            # ...
        }
    }
}