以前、以下の記事で、Windows環境でSSHサーバーを有効化する方法を紹介しました。
Windows環境でSSHサーバーを有効化する - JBS Tech Blog
環境固有の問題により、SSHサーバーのインストールが0x800f0954エラーコードにより失敗する問題が解決しないケースを確認したため、MSIパッケージを使用した別の方法を紹介します。
前提条件
SSHサーバーのインストールを評価した環境は、Microsoft Windows 11 Enterpriseの22H2(10.0.22621 ビルド22621)になります。
OpenSSH Clientはインストール済み、OpenSSH Serverはインストールされていない状態のため、Add-WindowsCapabilityコマンドレットで追加しようとしますが、0x800f0954エラーにより失敗している状態です。
実行コマンドとしては以下が存在する状態です。クライアントコマンドのscp.exeやsftp.exe、ssh.exeはありますが、サーバーコマンドのsshd.exeはありません。
OpenSSH Serverのインストール
MSIパッケージの入手
以下から最新版をダウンロードします。
https://github.com/PowerShell/Win32-OpenSSH/releases/latest
記事作成時点では、9.8.1.0が最新でしたので、今回はOpenSSH-Win64-v9.8.1.0.msiをクリックしてダウンロードします。
インストールとSSHサーバー側の確認
Windows PowerShellを「管理者として実行する」で開きます。
SSHサーバー機能のみインストールしたいため、以下のコマンド構文を実行します。
msiexec /i <msiファイルのパス> ADDLOCAL=Server
インストール先は、C:\Program Files\OpenSSH配下になります。
ファイル構成は以下のとおりです。
sshdサービスとして登録されていることを確認します。
Get-Service -Name ssh*
システムパスの更新をします。
以下のコマンドは、既存のパスにC:¥Profram Files¥OpenSSHを追加するものです。
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path",[System.EnvironmentVariableTarget]::Machine) + ';' + ${Env:ProgramFiles} + '\OpenSSH', [System.EnvironmentVariableTarget]::Machine)
SSHクライアントからの接続確認
SSHサーバが起動していることは、Get-ServiceコマンドレットのStatusでRunningになっていることから確認できました。
サービスが起動している状態でSSHクライアントからSSHサーバーに対して接続を試します。
今回は環境構築で使用したローカルアカウントで接続を試しました。
ssh.exe <任意の存在するアカウント名>@localhost
パスワード入力後、画面が切り替わることを確認できればSSH接続成功です。
SSHサーバーの設定ファイルについて
SSHサーバー側の設定ファイル(sshd_config)は、C:\ProgramData\ssh 配下にあります。
初期状態の設定ファイルの中身について以下記載します。
# This is the sshd server system-wide configuration file. See
# sshd_config(5) for more information.
# The strategy used for options in the default sshd_config shipped with
# OpenSSH is to specify options with their default value where
# possible, but leave them commented. Uncommented options override the
# default value.
#Port 22
#AddressFamily any
#ListenAddress 0.0.0.0
#ListenAddress ::
#HostKey __PROGRAMDATA__/ssh/ssh_host_rsa_key
#HostKey __PROGRAMDATA__/ssh/ssh_host_dsa_key
#HostKey __PROGRAMDATA__/ssh/ssh_host_ecdsa_key
#HostKey __PROGRAMDATA__/ssh/ssh_host_ed25519_key
# Ciphers and keying
#RekeyLimit default none
# Logging
#SyslogFacility AUTH
#LogLevel INFO
# Authentication:
#LoginGraceTime 2m
#PermitRootLogin prohibit-password
#StrictModes yes
#MaxAuthTries 6
#MaxSessions 10
#PubkeyAuthentication yes
# The default is to check both .ssh/authorized_keys and .ssh/authorized_keys2
# but this is overridden so installations will only check .ssh/authorized_keys
AuthorizedKeysFile .ssh/authorized_keys
#AuthorizedPrincipalsFile none
# For this to work you will also need host keys in %programData%/ssh/ssh_known_hosts
#HostbasedAuthentication no
# Change to yes if you don't trust ~/.ssh/known_hosts for
# HostbasedAuthentication
#IgnoreUserKnownHosts no
# Don't read the user's ~/.rhosts and ~/.shosts files
#IgnoreRhosts yes
# To disable tunneled clear text passwords, change to no here!
#PasswordAuthentication yes
#PermitEmptyPasswords no
# GSSAPI options
#GSSAPIAuthentication no
#AllowAgentForwarding yes
#AllowTcpForwarding yes
#GatewayPorts no
#PermitTTY yes
#PrintMotd yes
#PrintLastLog yes
#TCPKeepAlive yes
#UseLogin no
#PermitUserEnvironment no
#ClientAliveInterval 0
#ClientAliveCountMax 3
#UseDNS no
#PidFile /var/run/sshd.pid
#MaxStartups 10:30:100
#PermitTunnel no
#ChrootDirectory none
#VersionAddendum none
# no default banner path
#Banner none
# override default of no subsystems
Subsystem sftp sftp-server.exe
# Example of overriding settings on a per-user basis
#Match User anoncvs
# AllowTcpForwarding no
# PermitTTY no
# ForceCommand cvs server
Match Group administrators
AuthorizedKeysFile __PROGRAMDATA__/ssh/administrators_authorized_keys
サービスの管理方法
初期状態では、SSHサービスは自動起動される状態になっています。
セキュリティ上のリスクがあるため、手動起動設定に変更し、必要な時だけ起動して作業完了後に停止する対応を推奨します。
サービス管理で使用するコマンドには以下のようなものがあるので参考にしてください。
サービスの起動設定確認(Manual:手動、Automatic:自動)
(Get-Service -Name sshd).StartType
サービスの手動起動設定
Set-Service -Name sshd -StartupType Manual
サービスの自動起動設定
Set-Service -Name sshd -StartupType Automatic
サービスの起動状態確認(Stopped:停止中、Running:起動中)
(Get-Service -Name sshd).Status
サービスの起動
Start-Service -Name sshd
サービスの停止
Stop-Service -Name sshd
おわりに
今回は、Add-WindowsCapabilityコマンドレットによるSSHサーバーのインストール失敗時の代案として、MSIパッケージでのインストール方法を紹介しました。
0x800f0954エラーで失敗して苦労している方には代案として利用できると思いますので、参考にしてください。