PWSH.EXEとは？覚えておきたいPWSH構文（コマンドラインオプション）の一覧

PowerShellは、Microsoftが開発した最も強力なスクリプトツールのひとつです。この記事では、PWSH.exeとは何かを解説し、重要なPWSH構文の一覧をご紹介します。Windows PowerShellを使ったことがある方も多いでしょうが、PWSHは現在、Windows、macOS、Linuxで動作するクロスプラットフォーム対応のスクリプトツールへと進化しています。ただし、WSL（Windows Subsystem for Linux）上ではサポートされておらず、PWSHをログインシェルに設定するとWSLが不安定になる可能性がある点には注意が必要です。

PWSH.EXEとは何か？

まず最初に、ひとつ整理しておきましょう。PWSH.EXEはPowerShellの新しい名称です。バージョン6以降は「PowerShell Core」と呼ばれています。以前はpowershell.exeという名前で、Windows（バージョン5.1）にインストールされているのを目にしたことがある方も多いはずです。そのため、WindowsでPowerShellを起動するたびに、次のようなメッセージが表示されます。

「Try the new cross-platform PowerShell https://aka.ms/pscore6.」

PowerShellとPowerShell Coreの違いについて詳しく知りたい方は、Microsoftの公式ドキュメントを参照してください。

そして現在、PowerShellはバージョン7に到達しました。バージョン6から大きな変更が加えられ、.NET Frameworkの代わりに.NET Core 3を採用しています。試してみたい方は、Windows 10へのPowerShell 7.0のインストール方法を参考にするとよいでしょう。

重要なPWSH構文

-File | -f：コマンドをスクリプトファイルに保存している場合、そのファイルを入力として使用できます。必要に応じて、ファイルに対して引数を渡すことも可能です。

pwsh -File .\test.ps1 -TestParam $env:windir

-Command | -c：コマンドやScriptBlockを実行するために使用します。ScriptBlockとは、{}（波括弧）で囲まれた一連の処理のことです。

pwsh -Command {Get-WinEvent -LogName security}

または、以下のようにパイプ経由で渡すこともできます。

@'
"in"

"hi" |
% { "$_ there" }

"out"
'@ | powershell -NoProfile -Command -

-EncodedCommand | -e | -ec：複雑な引用符や波括弧を扱う必要がある場合に使用します。コマンドをBase64エンコードして渡すことで、クォートの衝突を回避できます。

$command = 'dir "c:\program files" '
$bytes = [System.Text.Encoding]::Unicode.GetBytes($command)
$encodedCommand = [Convert]::ToBase64String($bytes)
pwsh -encodedcommand $encodedCommand

-Login | -l：LinuxおよびmacOS環境で、PowerShellをログインシェルとして起動します。/bin/shを使用して、/etc/profileや~/.profileなどのログインプロファイルを実行します。Windowsでは利用できません。

設定の際は、/etc/shellsに記載されている絶対パスを確認する必要があります。chshユーティリティを使えば、現在のユーザーのデフォルトシェルをpwshに変更できます。

chsh -s /usr/bin/pwsh

-SettingsFile | -settings

グローバル設定をローカルのプロジェクト設定で上書きしたい場合は、このオプションで設定ファイルを指定します。システム全体の設定はpowershell.config.jsonに格納されています。

pwsh -SettingsFile c:\myproject\powershell.config.json

PWSH構文の完全なリスト

pwsh[.exe]
[[-File] <filePath> [args]]
[-Command { - | <script-block> [-args <arg-array>]
| <string> [<CommandParameters>] } ]
[-ConfigurationName <string>]
[-CustomPipeName <string>]
[-EncodedCommand <Base64EncodedCommand>]
[-ExecutionPolicy <ExecutionPolicy>]
[-InputFormat {Text | XML}]
[-Interactive]
[-Login]
[-MTA]
[-NoExit]
[-NoLogo]
[-NonInteractive]
[-NoProfile]
[-OutputFormat {Text | XML}]
[-SettingsFile <SettingsFilePath>]
[-STA]
[-Version]
[-WindowStyle <style>]
[-WorkingDirectory <directoryPath>]

pwsh[.exe] -h | -Help | -? | /?

さらに詳しい情報が必要な場合は、Microsoft公式ドキュメント（docs.microsoft.com / Microsoft Learn）をご覧ください。