PowerShell Remotingの接続前確認と使い分け:単発・再利用・対話

PowerShell Remotingの手順。準備とWinRM応答を確認し、単発実行と接続の再利用を選び、自分で作成した接続を終了する。

別のWindows PCへコマンドを送りたいのに、接続できない理由が分からない。PowerShell Remotingでは、Windowsの遠隔管理の仕組みであるWinRMの応答と、接続先でコマンドを実行する権限を分けて確認すると、調べる段階を整理できます。

この記事は、管理を許可されたWindows PCとWindows PowerShell 5.1を対象にします。操作元と受信側の役割を整理し、1回だけの実行、接続の再利用、人が対話で操作する方法を、終了操作まで対応させて説明します。

この記事の検証で実行済みなのは、設定を変えないローカル確認と引数の練習です。遠隔接続の例は構文・パラメーターの確認までで、接続成功の出力は掲載しません。実行する場合は、接続先と許可範囲を管理者へ確認してください。

先に結論

  • 受信設定が必要なのはコマンドを受け取る側です。送信だけを行う操作元へ、一律に受信設定を追加する必要はありません。
  • Test-WSManで分かるのはWinRMの応答です。PowerShellの実行権限と接続先の版は、別に確認します。
  • 1回の実行はInvoke-Command、値を引き継ぐ処理は同じ接続を保持するPSSession、人の対話操作はEnter-PSSessionを選びます。終了時は、自分で作成した接続だけを片付けます。

1.操作元でWindows PowerShellの版を確認する

コマンドを送るPCを「操作元」、受け取って実行するPCを「受信側」と呼びます。PowerShell Remotingは、リモートデスクトップのように画面を共有する操作ではありません。送ったコマンドが受信側で動き、結果が操作元へ戻ります。

まず操作元のスタートメニューから「Windows PowerShell」を開き、下の2行を上から順に入力します。最初の行は版、次の行は系列を調べます。以降のコード欄も、説明した場所で末尾まで実行する前提です。

検証の実行環境は、2026年11月18日のWindows PowerShell 5.1.26100.9818です。PowerShell 7やSSH方式の構築手順は対象外です。この確認で分かるのは操作元の環境で、接続先の版は後の読取りで別に確認します。

操作元のPowerShellを調べる

$PSVersionTable.PSVersion.ToString()
$PSVersionTable.PSEdition

実行結果

5.1.26100.9818
Desktop

掲載結果の5.1.26100.9818が版、DesktopがWindows PowerShellの系列です。7.xやCoreが表示された場合は、そのまま進めず、利用する環境を管理者と確認してください。

接続を受け付けてPowerShellを起動する構成を「エンドポイント」と呼びます。操作元の版が対象内でも、接続先で利用できるエンドポイントまで確認できたわけではありません。

2.WinRMの状態と応答を分けて読む

WinRMの応答があっても、接続先でPowerShellを実行できるとは限りません。

ここでは、操作元の設定を変えずに確認します。localhostは、いま操作している自分のPCを指す名前です。下の2つの欄を順に実行し、サービスの状態と、問い合わせへの応答を別々に読みます。

最初のGet-Serviceはサービス情報を取得します。縦棒は、左の結果を右の処理へ渡す記号です。この欄では、取得した情報からStatusという状態の項目だけを取り出して表示します。

次のTest-WSManはWinRMへ問い合わせます。tryは処理を試す範囲、catchは失敗を受け取る範囲です。ErrorAction Stopは、エラーをcatchで扱える形にする指定です。Out-Nullで問い合わせ結果の表示を抑え、成否に応じた案内文を表示します。

  1. Get-Serviceの欄を実行し、WinRMサービスの状態を読みます。
  2. Test-WSManの欄を最後まで実行し、表示された案内文を読みます。

操作元のWinRMサービスの状態を読む

Get-Service -Name WinRM | Select-Object -ExpandProperty Status

実行結果

Stopped

localhostへの応答を確認する

try {
    Test-WSMan -ComputerName localhost -ErrorAction Stop | Out-Null
    'WSManの応答を確認しました'
} catch {
    'WSManの応答を確認できませんでした'
}

実行結果

WSManの応答を確認できませんでした

今回の検証結果は、サービスがStopped(停止)、応答確認が「WSManの応答を確認できませんでした」です。後者はこの例が表示する案内文で、PowerShellの標準エラー全文ではありません。

分かるのは、操作元自身の状態と応答だけです。送信だけを行うPCでは、自分自身への応答確認に失敗しても、別の受信側へ接続できないとは判断できません。

接続先へ問い合わせる場合は、localhostの箇所を管理者が確認したPC名へ置き換えます。この変更によって遠隔の応答を得た結果は、今回の資料にはありません。応答があっても、その先の認証と実行権限は別に確認します。

原因を調べる際は、サービス、受信設定、名前解決、通信経路、ファイアウォールを管理者と切り分けます。名前解決はPC名から通信先を調べる処理、ファイアウォールは通信を許可・遮断する機能です。

3.受信側の準備を管理者へ依頼する

受信設定の追加や変更は管理者へ依頼し、許可された接続先と利用者を確認します。

受信側の準備が必要な場合は、管理者へ次の事項を伝えます。この記事では受信設定を変更する操作は案内せず、設定済みの管理対象へ、許可された利用者が接続するところから扱います。

Enable-PSRemotingは、管理者が受信側の準備に用いるコマンドです。WinRMサービス、リスナー、ファイアウォールの受信ルール、PowerShellの受信構成へ影響します。リスナーは接続を受け付ける設定です。自分の練習のために既存設定を変更しないでください。

ドメインは、利用者やPCをまとめて管理する範囲です。Kerberosは、利用者と接続相手を確認する認証方式です。接続先を識別するPC名をホスト名と呼びます。

管理者には、既存の受信設定が利用できるか、変更が必要なら誰が変更前の状態・影響範囲・復元方法を記録するかを確認します。接続先と実行権限の準備が整うまでは、第4節の通信なしの練習までにとどめます。

  1. 接続先のホスト名と利用者を伝え、同じドメインなどKerberos認証を利用できる条件か確認します。
  2. Windows PowerShell 5.1のMicrosoft.PowerShellという受信構成を利用でき、利用者に実行権限があるか確認します。
  3. 接続を許可する操作元とネットワーク範囲、変更前のサービス・リスナー・受信ルール・権限の記録と、作業後に戻す範囲を管理者へ確認します。
  4. 受信準備が完了した連絡を受けてから、管理者が許可した接続先の確認へ進みます。

送信だけを行う操作元へ、一律に受信設定を追加する必要はありません。公開ネットワークで接続できない場合も、すべての接続元へ受信許可を広げて進めず、管理者が合意した範囲を確認してください。

ここで扱うKerberos認証では、WinRMはHTTPでも認証後のメッセージを暗号化します。ただし、暗号化と接続相手の確認は別です。HTTPSを利用する場合には、証明書とリスナーの準備も管理者へ依頼します。ポート番号の変更だけでは構築できません。

4.通信なしで、渡す値と戻る値を確かめる

遠隔用の例へ進む前に、操作元の同じ画面で引数の渡し方を練習します。引数は、処理へ渡す値です。次のInvoke-CommandにはComputerNameもSessionも指定していないため、処理は操作元で動きます。

ScriptBlockは実行する処理のまとまりで、波括弧に囲まれた部分です。paramが値の受取口を定め、ArgumentListがそこへ渡す値を指定します。先頭にドル記号が付く名前は、値を保持する変数です。

下の3行を続けて入力します。numberという変数へ41を入れ、処理側のvalueで受け取って1を加えます。最後の行では、操作元に残っているnumberの値を表示します。この節の表には、引数の例を含む今回の確認結果を整理しています。

確認 専用検証の結果 分かる範囲
WinRMサービス Stopped このPCのサービス状態だけ
localhostの応答 確認できない案内を表示 接続成功ではない。原因の一意特定もしない
ローカルで引数41を渡す 42、続いて元の値41 引数の練習。遠隔実行の証拠ではない
遠隔用・設定用コード 構文と実在パラメーターを確認 実際の接続・受信設定の成功は未確認

通信を伴わない引数の練習

$number = 41
Invoke-Command -ScriptBlock { param($value) $value + 1 } -ArgumentList $number
$number

実行結果

42
41

出力の1行目にある42は計算結果、2行目の41は操作元に残る値です。足した結果を表示するだけで、元のnumberへ書き戻す代入は行っていません。

表の「構文と実在パラメーターを確認」は、書き方と指定できる項目を確認したという意味です。遠隔接続や受信設定が成功した結果ではありません。ローカルでの引数の練習を、遠隔での変数参照やデータ変換の全挙動へ広げて判断しないでください。

5.接続先へ1回だけ読取りを送る

ここからの遠隔用コードは、構文とパラメーターを確認した例です。遠隔接続は未実行で、成功出力は掲載しません。まずは接続先のPC名とPowerShellの版を読む、設定変更を含まない処理を示します。

同じActive Directoryドメインなど、Kerberos認証を利用できる管理済み環境が前提です。ドメインは、利用者やPCをまとめて管理する範囲です。Kerberosは、その環境で利用者と接続相手を確認する認証方式です。

現在の利用者には、接続先のPowerShellを実行する権限が必要です。ドメインに参加しないワークグループや、PC名の代わりにIPアドレスを指定する接続は認証条件が異なります。この例をそのまま流用しません。

ComputerNameは接続先、Authenticationは認証方式の指定です。ConfigurationNameのMicrosoft.PowerShellで、Windows PowerShell側の受信構成を選びます。ScriptBlockの波括弧内だけが接続先で動きます。

波括弧内では、接続先のPC名と版情報を、名前付きの3項目にまとめて返します。pscustomobjectは、このようなデータを作る指定です。PC名を取得する環境変数は、実行環境の情報を保持する値です。

  1. 操作元の通常のWindows PowerShell画面で、先頭行の架空の接続先名を、管理者が指定したホスト名へ置き換えます。ホスト名はPCを識別する名前です。
  2. 下のコード欄を、最後の行までまとめて実行します。

設定済み接続先へ1回だけ問い合わせる(接続は未実行)

$target = 'server01.example.test'
Invoke-Command -ComputerName $target -Authentication Kerberos -ConfigurationName Microsoft.PowerShell -ScriptBlock {
    [pscustomobject]@{
        Computer = $env:COMPUTERNAME
        Version = $PSVersionTable.PSVersion.ToString()
        Edition = $PSVersionTable.PSEdition
    }
} -ErrorAction Stop

接続できた場合は、Computerが接続先のPC名、VersionがPowerShellの版、Editionが系列を表します。意図したPCと環境かを確認してください。これらは想定する項目の説明で、今回取得した遠隔の値ではありません。

アクセス拒否の場合は、利用者と受信構成の実行権限を管理者と確認します。ワークグループやIPアドレスでの接続が必要なら、認証方式の検討へ戻ります。

TrustedHostsは、接続相手の身元を確認できない場合のエラーを抑える設定です。名前を登録しても、その相手の身元が保証されるわけではありません。すべてのホストを登録したり、証明書の検証を無効にしたりして先へ進めず、必要な接続条件を管理者と整理してください。

6.単発・再利用・対話を用途で選ぶ

前の処理の値を残す必要があるか、人が結果を見ながら入力するかで選びます。

1回の読取りなら、前節のInvoke-Commandを選べます。関連する複数の処理で前の値を残したい場合は、PSSessionを作って再利用します。PSSessionは、接続先に処理の状態を保持するための接続です。

人が1つずつコマンドを入力し、結果を見ながら操作する場合は、Enter-PSSessionを選びます。用途と終了操作を、この節の表で対応させてください。続く節で、再利用する例と対話する例を分けて説明します。

用途 選ぶ操作 終了時
1回の読取り Invoke-Command -ComputerName 一時セッションは実行後に閉じる
同じ値を複数回使う New-PSSession と -Session 自分で作成した接続をRemove-PSSession
人が対話で操作する Enter-PSSession -ComputerName Exit-PSSessionで操作元へ戻る

ComputerNameを指定したInvoke-Commandの一時セッションは、実行後に閉じます。毎回別々に送った処理で、前回の変数が残ることを前提にしないでください。

表のRemove-PSSessionは、自分で作成した再利用用の接続を片付ける操作です。対話から操作元へ戻るExit-PSSessionとは、役割を分けて読みます。

7.値を引き継ぐ処理を同じ接続へ送る

次は、接続先へ置いた値を次の処理でも読む例です。遠隔接続は未実行のため、コードの意図と後始末の条件を説明します。接続先・認証・実行権限の前提は、第5節の単発実行と同じです。

New-PSSessionで作った接続をsessionという変数へ保存し、Invoke-CommandのSessionへ渡します。最初の送信が接続先のmemoという変数へ文字列を入れ、2回目の送信が同じ接続からその値を読みます。

この例は、接続を作ってから閉じるところまでが1つの欄です。別作業の接続が入った変数を上書きしないよう、操作元で新しいWindows PowerShell画面を開き、下の順で扱ってください。

  1. 新しく開いた操作元の画面で、先頭行の架空の接続先名を、管理者指定のホスト名へ置き換えます。
  2. 接続の作成からfinallyの終わりまで、下のコード欄をまとめて実行します。

同じセッションへ2回送る(接続は未実行)

$target = 'server01.example.test'
$session = $null
try {
    $session = New-PSSession -ComputerName $target -Authentication Kerberos -ConfigurationName Microsoft.PowerShell -ErrorAction Stop
    Invoke-Command -Session $session -ScriptBlock { $memo = '接続先の値' } -ErrorAction Stop
    Invoke-Command -Session $session -ScriptBlock { $memo } -ErrorAction Stop
} finally {
    if ($null -ne $session) {
        Remove-PSSession -Session $session
    }
}

2回目の処理が読む想定の値は「接続先の値」です。これはコードの意図であり、今回その文字列を遠隔で取得したわけではありません。

finallyは、途中でエラーになっても通る後始末の範囲です。最初にsessionをnullという値にし、まだ接続がない状態を表します。ifの条件で接続が作成できた場合だけ、Remove-PSSessionを実行して閉じます。

ローカルの補助検証では、接続を作る前に失敗してもfinallyを通り、存在しない接続を削除しない分岐を確認しています。この結果も、遠隔接続の成功を示すものではありません。

8.人が入力する対話接続を始める

Enter-PSSessionは、人が開いているPowerShell画面で対話するためのコマンドです。コマンドを保存したファイルや、人の入力を待たない自動処理の中へ組み込む用途には使いません。

開始する場所は、操作元のWindows PowerShellの対話画面です。接続条件は第5節と同じで、架空の接続先名を管理者指定のホスト名へ置き換えます。下の開始欄の2行を順に入力する例ですが、今回の検証では遠隔の対話操作は未実行です。

対話接続を開始する(接続は未実行)

$target = 'server01.example.test'
Enter-PSSession -ComputerName $target -Authentication Kerberos -ConfigurationName Microsoft.PowerShell -ErrorAction Stop

接続できた場合は、プロンプトという入力待ちの表示に接続先の名前が付きます。それ以降に入力するコマンドの実行場所は、接続先です。操作元で動いていると取り違えないでください。

ファイルの保存先に指定するパスも、接続先の場所を指します。作業を終えたら、接続先のプロンプトが表示されている画面で、次節の終了操作を行います。

9.対話を終えて操作元へ戻る

対話接続での作業を終えたら、接続先のプロンプトが表示されている画面で、下の終了欄を入力します。Exit-PSSessionは、対話を終えて操作元へ戻るコマンドです。今回の検証では、遠隔の対話画面からの終了は未実行です。

前節はComputerNameを指定して直接始める方法です。別途New-PSSessionで作成した接続に入った場合は、対話から戻ることと、その接続を削除することを分けて考えます。

対話接続先から操作元へ戻る(対話では未実行)

Exit-PSSession

入力後は、操作元へ戻ったことをプロンプトで確認します。作成済みのPSSessionに入っていた場合は、戻った後、自分が作成したその接続だけをRemove-PSSessionで閉じます。

ほかの作業で利用中の接続をまとめて削除しないでください。次の一覧確認で、このPowerShell画面に残っている接続を読み取れます。

10.残った接続と設定の復元範囲を確認する

操作元へ戻ったら、そのPowerShell画面が持つ接続を一覧で確認します。下の欄は、接続を作成・削除する操作ではありません。今回の検証では新しいセッションを作っておらず、出力はありませんでした。

Get-PSSessionが接続を取得し、Select-Objectが表示する項目を選びます。Idは接続の識別番号、ComputerNameは接続相手、Stateは状態です。Openedは接続が開いている状態を表します。表示があれば、自分が作成した接続かを確認する手掛かりにします。

操作元に残るセッションを確認する

Get-PSSession | Select-Object -Property Id, ComputerName, State

一覧が空でも、別のPowerShell画面や別利用者を含む、サーバー全体の接続がゼロという意味ではありません。また、取り除いたセッション内の値が、次の一時接続へ自動で引き継がれることもありません。

今回のローカル確認と引数の練習では、サービスやファイアウォールの設定を変更していないため、それらを戻す操作はありません。接続失敗を理由に利用者や権限を変更する前に、管理者と原因を整理してください。

受信設定を変更した場合は、Disable-PSRemotingだけで全変更を元に戻せるとは限りません。実行するPowerShell系列によって対象も異なります。設定前の記録を基に、リスナー、受信ルール、サービスを管理者が個別に確認します。

既存の管理用途がある環境を一括停止せず、今回変更した範囲を復元対象にします。接続を閉じる後始末と、受信設定を戻す作業は、別々に確認してください。