powershellrequirepowershell-ise

PowerShell_ISE "an error occurred while creating the pipeline" #Requires -Version 3.0


If using PowerShell_ISE, when attempting to use any of the #Requires commands, for example:

#Requires -Version 3.0 

They error with the text:

An error occurred while creating the pipeline. + CategoryInfo : NotSpecified: (:) [], ParentContainsErrorRecordException + FullyQualifiedErrorId : RuntimeException

I've tested this on ISE and the Console with the same results, my versions are below:

Name                           Value
----                           -----
PSVersion                      5.1.14409.1012
PSEdition                      Desktop
PSCompatibleVersions           {1.0, 2.0, 3.0, 4.0...}
BuildVersion                   10.0.14409.1012
CLRVersion                     4.0.30319.42000
WSManStackVersion              3.0
PSRemotingProtocolVersion      2.3
SerializationVersion           1.1.0.1

Solution

  • My final test before posting the question provided the answer:

    It seems the '#Requires' commands are designed to break out of the script if it doesn't meet the requirements rather than posting an error, and testing it on a single line will result in an error.

    To test, find your PowerShell version (e.g. 5.1) and save the following transposing 5.1 with your (major.minor) version:

    #Requires -version 5.1
    $PSVersionTable.PSVersion
    Read-Host
    

    This will work on both ISE and the Console, providing an output even if 'Run with PowerShell'.