Set-WSManQuickConfig

  • リファレンス
モジュール:
Microsoft.WSMan.Management

ローカル コンピューターをリモート管理用に構成します。

構文

Set-WSManQuickConfig
   [-UseSSL]
   [-Force]
   [-SkipNetworkProfileCheck]
   [<CommonParameters>]

説明

Set-WSManQuickConfig コマンドレットは、Web Services for Management (WS-Management) テクノロジを使用して送信される PowerShell リモート コマンドを受信するようにコンピューターを構成します。

Set-WSManQuickConfig は、次のアクションを実行します。

  • WinRM サービスが実行されているかどうかを確認します。 WinRM サービスが実行されていない場合は、サービスが開始されます。
  • WinRM サービスのスタートアップの種類を自動に設定します。
  • 任意の IP アドレスで要求を受け入れるリスナーを作成する。 既定のトランスポートは HTTP です。
  • WinRM トラフィックのファイアウォール例外を有効にします。

Set-WSManQuickConfigを実行するには、管理者として実行 オプションを使用して PowerShell を起動します。

例

例 1: HTTP 経由でローカル コンピューターのリモート管理を有効にする

次の使用例は、ローカル コンピューターのリモート管理を有効にするために必要な構成を設定します。 既定では、このコマンドは WS-Management リスナーを HTTP に作成します。

Set-WSManQuickConfig

例 2: HTTPS 経由でローカル コンピューターのリモート管理を有効にする

次の使用例は、ローカル コンピューターのリモート管理を有効にするために必要な構成を設定します。 UseSSL パラメーターは、コンピューターとの通信に HTTPS を使用することを指定します。

Set-WSManQuickConfig -UseSSL

Note

HTTPS には手動で構成する必要があります。 詳細については、 UseSSL パラメーターの説明を参照してください。

パラメーター

-Force

ユーザーに確認せずに、直ちにコマンドを実行します。

型:SwitchParameter
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SkipNetworkProfileCheck

コンピューターがパブリック ネットワーク上にある場合にリモート処理用の Windows クライアント バージョンを構成します。 このパラメーターは、同じローカル サブネット内のコンピューターに対してのみリモート アクセスを許可する、パブリック ネットワークのファイアウォール規則を有効にします。

このパラメーターは、Windows のサーバー バージョンには影響しません。既定では、パブリック ネットワーク用のローカル サブネット ファイアウォール規則があります。 Windows のサーバー バージョンでローカル サブネット ファイアウォール規則が無効になっている場合は、このパラメーターの値に関係なく、再度有効 Enable-PSRemoting 。

ローカル サブネットの制限を削除し、パブリック ネットワーク上のすべての場所からリモート アクセスを有効にするには、NetSecurity モジュールの Set-NetFirewallRule コマンドレットを使用します。

このパラメーターは PowerShell 3.0 で導入されました。

型:SwitchParameter
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-UseSSL

リモート コンピューターへの接続を確立するために Secure Sockets Layer (SSL) プロトコルを使用することを指定します。 既定では、SSL は使用されません。

WS-Management は、ネットワーク経由で送信されるすべての PowerShell コンテンツを暗号化します。 UseSSL パラメーターを使用すると、HTTP ではなく HTTPS の追加保護を指定できます。 このパラメーターを使用していて、接続に使用されているポートで SSL を使用できない場合、コマンドは失敗します。

HTTPS では、WinRM とファイアウォール規則を手動で構成する必要があります。 詳細については、「 方法: HTTPS 用に WINRM を構成するを参照してください。

型:SwitchParameter
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

None

このコマンドレットにオブジェクトをパイプすることはできません。

出力

None

このコマンドレットは、出力を返しません。