Enable-PSRemoting
リモート コマンドを受信するようにコンピューターを構成します。
構文
Enable-PSRemoting
[-Force]
[-SkipNetworkProfileCheck]
[-WhatIf]
[-Confirm]
[<CommonParameters>]説明
このコマンドレットは、Windows プラットフォームでのみ使用できます。
コマンドレットは Enable-PSRemoting 、WS-Management テクノロジを使用して送信される PowerShell リモート コマンドを受信するようにコンピューターを構成します。 WS-Management ベースの PowerShell リモート処理は、現在、Windows プラットフォームでのみサポートされています。
Windows Server プラットフォームでは、PowerShell リモート処理が既定で有効になっています。 サポートされている他のバージョンの Windows で PowerShell リモート処理を有効にしたり、無効になった場合にリモート処理を再度有効にしたりするために使用 Enable-PSRemoting できます。
このコマンドは、コマンドを受信する各コンピューターで 1 回だけ実行する必要があります。 コマンドのみを送信するコンピューターで実行する必要はありません。 構成ではリスナーがリモート接続を受け入れるように開始されるため、必要な場所でのみ実行することが賢明です。
コンピューターがパブリック ネットワーク上にある場合にクライアント バージョンの Windows で PowerShell リモート処理を有効にすることは通常許可されませんが、 SkipNetworkProfileCheck パラメーターを使用してこの制限をスキップできます。 詳細については、SkipNetworkProfileCheck パラメーターの説明を参照してください。
1 台のコンピューターに複数の PowerShell インストールを並べてインストールできます。 実行 Enable-PSRemoting すると、コマンドレットを実行している特定のインストール バージョンのリモート処理エンドポイントが構成されます。 そのため、PowerShell 6.2 の実行中に実行 Enable-PSRemoting すると、PowerShell 6.2 を実行するリモート処理エンドポイントが構成されます。 PowerShell 7 プレビューの実行中に実行 Enable-PSRemoting する場合、PowerShell 7-preview を実行するリモート処理エンドポイントが構成されます。
Enable-PSRemoting は、必要に応じて 2 つのリモート処理エンドポイント構成を作成します。 エンドポイント構成が既に存在する場合は、単に有効であることが保証されます。 作成された構成は同じですが、名前は異なります。 セッションをホストする PowerShell バージョンに対応する単純な名前が付けられます。 もう 1 つの構成名には、セッションをホストする PowerShell バージョンに関する詳細情報が含まれています。 たとえば、PowerShell 6.2 で実行 Enable-PSRemoting すると、 PowerShell.6、PowerShell.6.2.2 という名前の 2 つの構成済みエンドポイントが取得されます。
これにより、PowerShell.6 という単純な名前を使用して、最新の PowerShell 6 ホスト バージョンへの接続を作成できます。 または、 PowerShell.6.2.2 という長い名前を使用して、特定の PowerShell ホスト バージョンに接続することもできます。
新しく有効になったリモート処理エンドポイントを使用するには、コマンドレットを使用してリモート接続を作成するときに、ConfigurationName パラメーターを使用してInvoke-CommandNew-PSSessionEnter-PSSession名前で指定する必要があります。 詳細については、「例 4」を参照してください。
コマンドレットは Enable-PSRemoting 、次の操作を実行します。
- Set-WSManQuickConfig コマンドレットを実行し、次のタスクを実行します。
- WinRM サービスを開始します。
- WinRM サービスのスタートアップの種類を [自動] に設定します。
- 任意の IP アドレスで要求を受け入れるリスナーを作成します。
- WS-Management通信のファイアウォール例外を有効にします。
- 必要に応じて、単純な名前と長い名前のセッション エンドポイント構成を作成します。
- すべてのセッション構成を有効にします。
- リモート アクセスを許可するように、すべてのセッション構成のセキュリティ記述子を変更します。
- WinRM サービスを再起動して、上記の変更を有効にします。
Windows プラットフォームでこのコマンドレットを実行するには、[管理者として実行] オプションを使用して PowerShell を起動します。 このコマンドレットは、Linux または MacOS バージョンの PowerShell では使用できません。
注意事項
このコマンドレットは、Windows PowerShellによって作成されたリモート エンドポイント構成には影響しません。
影響を受けるのは、PowerShell バージョン 6 以降で作成されたエンドポイントのみです。 Windows PowerShellによってホストされている PowerShell リモート処理エンドポイントを有効または無効にするには、Windows PowerShell セッション内からコマンドレットを実行Enable-PSRemotingします。
例
例 1: リモート コマンドを受信するようにコンピューターを構成する
このコマンドは、リモート コマンドを受信するようにコンピューターを構成します。
Enable-PSRemoting
WARNING: PowerShell remoting has been enabled only for PowerShell Core configurations and does not
affect Windows PowerShell remoting configurations. Run this cmdlet in Windows PowerShell to affect
all PowerShell remoting configurations.例 2: 確認プロンプトなしでリモート コマンドを受信するようにコンピューターを構成する
このコマンドは、リモート コマンドを受信するようにコンピューターを構成します。 Force パラメーターを指定すると、ユーザーのプロンプトが表示されなくなります。
Enable-PSRemoting -Force
WARNING: PowerShell remoting has been enabled only for PowerShell Core configurations and does not
affect Windows PowerShell remoting configurations. Run this cmdlet in Windows PowerShell to affect
all PowerShell remoting configurations.例 3: クライアントでリモート アクセスを許可する
この例では、Windows オペレーティング システムのクライアント バージョンでパブリック ネットワークからのリモート アクセスを許可する方法を示します。 ファイアウォール規則の名前は、Windows のバージョンによって異なる場合があります。
ルールの一覧を表示するために使用 Get-NetFirewallRule します。 ファイアウォール規則を有効にする前に、規則のセキュリティ設定を表示して、構成が環境に適していることを確認します。
Get-NetFirewallRule -Name 'WINRM*' | Select-Object Name
Name
----
WINRM-HTTP-In-TCP-NoScope
WINRM-HTTP-In-TCP
WINRM-HTTP-Compat-In-TCP-NoScope
WINRM-HTTP-Compat-In-TCP
Enable-PSRemoting -SkipNetworkProfileCheck -Force
Set-NetFirewallRule -Name 'WINRM-HTTP-In-TCP' -RemoteAddress Any既定では、 Enable-PSRemoting プライベート ネットワークとドメイン ネットワークからのリモート アクセスを許可するネットワーク 規則を作成します。 このコマンドでは、SkipNetworkProfileCheck パラメーターを使用して、同じローカル サブネット内のパブリック ネットワークからのリモート アクセスを許可しています。 このコマンドは、確認メッセージを抑制する Force パラメーターを指定します。
SkipNetworkProfileCheck パラメーターは、既定で同じローカル サブネット内のパブリック ネットワークからのリモート アクセスを許可する Windows オペレーティング システムのサーバー バージョンには影響しません。
NetSecurity モジュールのコマンドレットはSet-NetFirewallRule、任意のリモートの場所からパブリック ネットワークからのリモート アクセスを許可するファイアウォール規則を追加します。 これには、異なるサブネット内の場所が含まれます。
例 4: 新しく有効になったエンドポイント構成へのリモート セッションを作成する
この例では、コンピューターで PowerShell リモート処理を有効にし、構成されているエンドポイント名を見つけて、いずれかのエンドポイントへのリモート セッションを作成する方法を示します。
最初のコマンドは、コンピューターで PowerShell リモート処理を有効にします。
2 番目のコマンドは、エンドポイント構成を一覧表示します。
3 番目のコマンドは、同じコンピューターへのリモート PowerShell セッションを作成し、名前で PowerShell.6 エンドポイントを指定します。 リモート セッションは、最新の PowerShell 6 バージョン (6.2.2) でホストされます。
最後のコマンドは、 $PSVersionTable リモート セッションの変数にアクセスして、セッションをホストしている PowerShell バージョンを表示します。
Enable-PSRemoting -Force
Get-PSSessionConfiguration
$session = New-PSSession -ComputerName localhost -ConfigurationName PowerShell.6
Invoke-Command -Session $session -ScriptBlock { $PSVersionTable }
WARNING: PowerShell remoting has been enabled only for PowerShell Core configurations and does not
affect Windows PowerShell remoting configurations. Run this cmdlet in Windows PowerShell to affect
all PowerShell remoting configurations.
Name : PowerShell.6
PSVersion : 6.2
StartupScript :
RunAsUser :
Permission : NT AUTHORITY\INTERACTIVE AccessAllowed, BUILTIN\Administrators AccessAllowed,
BUILTIN\Remote Management Users AccessAllowed
Name : PowerShell.6.2.2
PSVersion : 6.2
StartupScript :
RunAsUser :
Permission : NT AUTHORITY\INTERACTIVE AccessAllowed, BUILTIN\Administrators AccessAllowed,
BUILTIN\Remote Management Users AccessAllowed
Name Value
---- -----
PSCompatibleVersions {1.0, 2.0, 3.0, 4.0…}
PSEdition Core
PSRemotingProtocolVersion 2.3
Platform Win32NT
SerializationVersion 1.1.0.1
GitCommitId 6.2.2
WSManStackVersion 3.0
PSVersion 6.2.2
OS Microsoft Windows 10.0.18363注意
ファイアウォール規則の名前は、Windows のバージョンによって異なる場合があります。 コマンドレットを Get-NetFirewallRule 使用して、システム上の規則の名前を一覧表示します。
パラメーター
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
ユーザーに確認せずに、直ちにコマンドを実行します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
コンピューターがパブリック ネットワーク上にある場合に、このコマンドレットを使用して Windows オペレーティング システムのクライアント バージョンでリモート処理を有効にすることを示します。 このパラメーターは、同じローカル サブネット内のコンピューターに対してのみリモート アクセスを許可する、パブリック ネットワークのファイアウォール規則を有効にします。
このパラメーターは、既定ではパブリック ネットワーク用のローカル サブネット ファイアウォール規則を持つ Windows オペレーティング システムのサーバー バージョンには影響しません。 ローカル サブネットのファイアウォール規則がサーバー バージョンで無効になっている場合は、 Enable-PSRemoting このパラメーターの値に関係なく、再度有効にします。
ローカル サブネットの制限を削除し、パブリック ネットワーク上のすべての場所からリモート アクセスを有効にするには、NetSecurity モジュールのコマンドレットを使用Set-NetFirewallRuleします。
このパラメーターは、PowerShell 3.0 で導入されました。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
None
パイプを使用してこのコマンドレットに入力を渡すことはできません。
出力
このコマンドレットは、結果を記述する文字列を返します。
メモ
このコマンドレットは、Windows プラットフォームでのみ使用できます。
Windows オペレーティング システムのサーバー バージョンでは、 Enable-PSRemoting リモート アクセスを許可するプライベート ネットワークとドメイン ネットワークのファイアウォール規則を作成し、同じローカル サブネット内のコンピューターからのリモート アクセスのみを許可するパブリック ネットワークのファイアウォール規則を作成します。
Windows オペレーティング システムのクライアント バージョンでは、 Enable-PSRemoting 無制限のリモート アクセスを許可するプライベート ネットワークとドメイン ネットワークのファイアウォール規則を作成します。 パブリック ネットワークに対して同じローカル サブネットからのリモート アクセスを許可するファイアウォール規則を作成するには、SkipNetworkProfileCheck パラメーターを使用します。
Windows オペレーティング システムのクライアントまたはサーバー バージョンで、ローカル サブネットの制限を削除し、リモート アクセスを許可するパブリック ネットワークのファイアウォール規則を作成するには、NetSecurity モジュールのコマンドレットを使用 Set-NetFirewallRule して次のコマンドを実行します。 Set-NetFirewallRule -Name "WINRM-HTTP-In-TCP-PUBLIC" -RemoteAddress Any
Enable-PSRemoting では、すべてのセッション構成の Enabled プロパティの値を に設定することで、すべてのセッション構成を $True有効にします。
Enable-PSRemoting は、 Deny_All と Network_Deny_All の設定を削除します。 これにより、ローカルで使用するために予約されたセッション構成へのリモート アクセスが提供されます。