Mention the quasi-interactive, REPL-like behavior of -File - and -Command - and a workaround

[mklement0]

Type of issue

Missing information

Feedback

It is reasonable for users - especially those familiar with POSIX-compatible shells such as Bash - to expect -File - to treat its stdin input as a whole as if it were the content of a script file.
-Command - does not have a POSIX-compatible shell counterpart, but the expectation applies analogously.

Unfortunately, both -File - and -Command - exhibit quasi-interactive behavior that seems to be geared toward supporting REPL-like functionality via stdin: see PowerShell/PowerShell#21808 (comment) for a summary.

To get the expected behavior, the following workaround is currently required, which is worth mentioning:

• Enclose the code in & { ... }

• Ensure that it is terminated by two trailing newlines.

Example:

• From PowerShell:

@'
& { 
  Get-Date
  $PROFILE
}

'@ |
  pwsh -NoProfile -Command -

• From Bash:

pwsh -NoProfile -Command - <<'EOF'
& { 
  Get-Date
  $PROFILE
}

EOF

Note that, without the extra newline (empty line), both commands above currently provide no output, which is a bug discussed in:

• (some) command read from stdin seem to require extra trailing newline PowerShell/PowerShell#21644 (comment)

Page URL

https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_Pwsh?view=powershell-7.4

Content source URL

https://github.com/MicrosoftDocs/PowerShell-Docs/blob/main/reference/7.4/Microsoft.PowerShell.Core/About/about_Pwsh.md

Author

@sdwheeler

Document Id

4ccd2aa8-1a49-5b9d-04ee-5d2c61fb3c38