フィードバック

macOS への PowerShell のインストール

  • [アーティクル]

PowerShell 7.0 以降には macOS 10.13 以降が必要です。 すべてのパッケージは GitHub リリース ページにあります。 パッケージがインストールされたら、ターミナルから pwsh を実行します。 インストールする前に、後述の「サポートされているバージョン」の一覧を確認してください。

注意

PowerShell 7.2 はインプレース アップグレードであり、以前のバージョンの PowerShell 6.x および 7.x は削除されます。

/usr/local/microsoft/powershell/6 フォルダーは /usr/local/microsoft/powershell/7 に置き換えられました。

PowerShell の旧バージョンを PowerShell 7.2 と side-by-side 実行する必要がある場合、バイナリ アーカイブ手法を使用し、必要なバージョンをインストールします。

macOS 10.13 以降で Homebrew を使用した最新の安定版リリースのインストール

macOS に PowerShell をインストールするには、いくつかの方法があります。 以下のいずれかの方法を選択します。

PowerShell をインストールした後、OpenSSL をインストールする必要があります。 PowerShell WSMan リモート処理の場合は OpenSSL が必要です。

brew コマンドが見つからない場合、指示に従い、Homebrew をインストールする必要があります。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

これで PowerShell をインストールできます。

brew install --cask powershell

最後に、インストールが正常に動作していることを確認します。

pwsh

新しいバージョンの PowerShell がリリースされたら、Homebrew の式を更新し、PowerShell をアップグレードしてください。

brew update
brew upgrade powershell --cask

注意

上記のコマンドは PowerShell (pwsh) ホスト内から呼び出すことができますが、その場合、アップグレードを完了するには、PowerShell シェルを終了し、再起動して、$PSVersionTable に表示される値を更新する必要があります。

macOS 10.13 以降で Homebrew を使用した最新のプレビュー リリースのインストール

Homebrew をインストールしたら、PowerShell をインストールできます。 最初に、Cask-Versions パッケージをインストールします。これにより、cask パッケージの代替バージョンをインストールすることができます。

brew tap homebrew/cask-versions

これで PowerShell をインストールできます。

brew install --cask powershell-preview

最後に、インストールが正常に動作していることを確認します。

pwsh-preview

新しいバージョンの PowerShell がリリースされたら、Homebrew の式を更新し、PowerShell をアップグレードしてください。

brew update
brew upgrade powershell-preview --cask

注意

上記のコマンドは PowerShell (pwsh) ホストから呼び出すことができますが、その場合、PowerShell シェルを終了し、再起動して、アップグレードを完了し、 $PSVersionTable に表示される値を更新する必要があります。

Homebrew tap メソッドを使用した PowerShell のインストールは、安定バージョンと LTS バージョンでもサポートされています。

brew install powershell/tap/powershell

これで、インストールを確認できます。

pwsh

新しいバージョンの PowerShell がリリースされたら、次のコマンドを実行します。

brew upgrade powershell

注意

cask メソッドと tap メソッドのどちらを使用する場合でも、新しいバージョンの PowerShell に更新するときに、PowerShell の初期インストールに使用したものと同じメソッドを使用します。 別のメソッドを使用する場合、新しい pwsh セッションを開くと、古いバージョンの PowerShell が引き続き使用されます。

別のメソッドを使用することを選択した場合は、Homebrew link メソッドを使用して問題を修正する方法があります。

直接ダウンロードによるインストール

PowerShell 7.2 では、Apple M1 プロセッサのサポートが追加されました。 リリース ページからお使いのコンピューターに、インストール パッケージをダウンロードします。 現在のバージョンへのリンクは次のとおりです。

ファイルをダブルクリックしてプロンプトの指示に従うか、次のコマンドを使用してターミナルからインストールします。 ダウンロードしたファイルに合わせて、ファイルの名前を変更します。

sudo installer -pkg powershell-7.2.4-osx-x64.pkg -target /

macOS Big Sur 11.5 以上で実行している場合は、パッケージのインストール時に次のエラー メッセージが表示されることがあります。

"powershell-7.2.4-osx-x64.pkg" can't be opened because Apple cannot check it for malicious software. ("powershell-7.2.4-osx-x64.pkg" が悪意のあるソフトウェアかどうかを Apple で確認できないため、開くことができません。)

この問題を回避するには、次の 2 つの方法があります。

Finder の使用

  1. Finder でパッケージを見つけます。
  2. パッケージをコントロールクリック (Ctrl キーを押しながらクリック) します。
  3. コンテキスト メニューから [開く] を選びます。

コマンド ラインから

  1. sudo xattr -rd com.apple.quarantine powershell-7.2.4-osx-x64.pkg を実行します。 .pkg ファイルへの完全なパスを指定します。
  2. 通常と同じ方法でパッケージをインストールします。

注意

これは、パッケージの公証に関連する既知の問題であり、将来対応される予定です。

OpenSSL をインストールします。 PowerShell リモート処理および CIM 操作の場合は OpenSSL が必要です。

.NET グローバル ツールとしてインストールする

.NET Core SDK が既にインストールされている場合は、PowerShell を .NET グローバル ツールとして簡単にインストールできます。

dotnet tool install --global PowerShell

dotnet tool install によって、PATH 環境変数に ~/.dotnet/tools が追加されます。 ただし、現在実行中のシェルには更新された PATH が設定されていません。 新しいシェルからは、「pwsh」と入力すると PowerShell を起動できるはずです。

OpenSSL をインストールします。 PowerShell リモート処理および CIM 操作の場合は OpenSSL が必要です。

バイナリ アーカイブ

macOS プラットフォームで高度な展開シナリオを実行するために、PowerShell バイナリ tar.gz アーカイブが用意されています。 この方法を使用してインストールする場合は、依存関係を手動でインストールする必要もあります。

OpenSSL をインストールします。 PowerShell リモート処理および CIM 操作の場合は OpenSSL が必要です。

注意

この方法を使用して、最新バージョンを含む任意のバージョンの PowerShell をインストールできます。

macOS へのバイナリ アーカイブのインストール

リリース ページからお使いのコンピューターに、インストール パッケージをダウンロードします。 現在のバージョンへのリンクは次のとおりです。

バイナリ アーカイブから PowerShell をインストールするには、次のシェル コマンドを使用します。 インストールする PowerShell のバージョンに合わせて、ダウンロード URL を変更します。

# Download the powershell '.tar.gz' archive
curl -L -o /tmp/powershell.tar.gz https://github.com/PowerShell/PowerShell/releases/download/v7.2.4/powershell-7.2.4-osx-x64.tar.gz

# Create the target folder where powershell is placed
sudo mkdir -p /usr/local/microsoft/powershell/7.2.4

# Expand powershell to the target folder
sudo tar zxf /tmp/powershell.tar.gz -C /usr/local/microsoft/powershell/7.2.4

# Set execute permissions
sudo chmod +x /usr/local/microsoft/powershell/7.2.4/pwsh

# Create the symbolic link that points to pwsh
sudo ln -s /usr/local/microsoft/powershell/7.2.4/pwsh /usr/local/bin/pwsh

依存関係のインストール

PowerShell リモート処理および CIM 操作の場合は OpenSSL が必要です。 必要に応じて、MacPorts を使用して OpenSSL をインストールできます。

注意

MacPorts と Homebrew を同じシステムで一緒に使用すると、問題が発生する可能性があります。 ただし、Homebrew には OpenSSL 1.0 用のパッケージがありません。 詳細については、MacPorts の FAQ に関する記事を参照してください。

  1. Xcode コマンド ライン ツールをインストールします。 MacPorts には Xcode ツールが必要です。

    xcode-select --install

  2. MacPorts をインストールします。 手順が必要な場合は、インストール ガイドをご覧ください。

  3. sudo port selfupdate を実行して MacPorts を更新します。

  4. sudo port upgrade outdated を実行して MacPorts パッケージをアップグレードします。

  5. OpenSSL をインストールします。

    • x64 ベースのシステムの場合は、sudo port install openssl10 を実行します
    • M1 ベースのシステムの場合は、sudo port install openssl10 +universal を実行します

  6. PowerShell で使用できるようにライブラリをリンクします。

    sudo mkdir -p /usr/local/opt/openssl
sudo ln -s /opt/local/lib/openssl-1.0 /usr/local/opt/openssl/lib

PowerShell のアンインストール

Homebrew を使って PowerShell をインストールした場合は、次のコマンドを使ってアンインストールします。

brew uninstall --cask powershell

直接ダウンロードで PowerShell をインストールした場合、手動で PowerShell を削除する必要があります。

sudo rm -rf /usr/local/bin/pwsh /usr/local/microsoft/powershell

追加の PowerShell パスを削除するには、このドキュメントの「パス」セクションを参照し、sudo rm を使用してパスを削除してください。

注意

Homebrew でインストールした場合、この操作は不要です。

パス

  • $PSHOME は /usr/local/microsoft/powershell/7.2.4/ です
  • ユーザー プロファイルは ~/.config/powershell/profile.ps1 から読み込まれます
  • 既定のプロファイルは $PSHOME/profile.ps1 から読み込まれます
  • ユーザー モジュールは ~/.local/share/powershell/Modules から読み込まれます
  • 共有モジュールは /usr/local/share/powershell/Modules から読み込まれます
  • 既定のモジュールは $PSHOME/Modules から読み込まれます
  • PSReadLine 履歴は ~/.local/share/powershell/PSReadLine/ConsoleHost_history.txt に記録されます

プロファイルには、PowerShell のホスト単位の構成が考慮されています。 そのため、既定のホスト固有のプロファイルは、同じ場所の Microsoft.PowerShell_profile.ps1 に存在します。

PowerShell は、macOS の XDG ベース ディレクトリ仕様を尊重しています。

macOS は BSD から派生しているので、プレフィックスに /opt ではなく /usr/local が使用されます。 そのため、$PSHOME は /usr/local/microsoft/powershell/7.2.4/ となり、シンボリック リンクは /usr/local/bin/pwsh に配置されます。

サポートされているバージョン

Windows のバージョンと、そのバージョンで現在サポートされている PowerShell リリースの一覧は、次の表のとおりです。 これらのバージョンは、PowerShell のバージョンがサポート終了になるか、macOS のバージョンがサポート終了になるまでサポートされます。

  • ✅ は、OS または PowerShell のバージョンがまだサポートされていることを示します
  • ❌ は、OS または PowerShell のバージョンがサポートされていないことを示します
  • 🟡 は、PowerShell のそのバージョンが OS のそのバージョンでサポートされなくなっていることを示します
  • OS のバージョンと PowerShell のバージョンの両方が ✅ である場合は、その組み合わせがサポートされます
macOS 7.0 (LTS) 7.1 7.2 (LTS-current) 7.3 (プレビュー)
✅ macOS Big Sur 11.5 ✅ 🟡 ✅ ✅
✅ macOS Catalina 10.15 ✅ 🟡 ✅ ✅
✅ macOS Mojave 10.14 ✅ 🟡 ✅ ✅
✅ macOS High Sierra 10.13 ✅ 🟡 ❌ ❌

macOS Monterey 12.0 はテストされていません。

macOS のサポートは、Apple が定義しています。 詳細については、次を参照してください。

PowerShell は、次のプロセッサ アーキテクチャの macOS でサポートされています。

macOS 7.0 (LTS) 7.2 (LTS-current) 7.3 (プレビュー)
macOS Big Sur 11.5 X64 x64、Arm64 x64、Arm64
macOS High Sierra 10.13 以降 X64 X64 X64

インストールのサポート

Microsoft は、このドキュメントでインストール方法をサポートしています。 他のソースには、利用可能な別のインストール方法が存在する可能性があります。 そのようなツールと方法は機能しても、Microsoft ではそれらの方法をサポートできません。

その他のリソース