Set-WSManQuickConfig

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

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

構文

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

説明

このコマンドレットは、Windows プラットフォームでのみ使用できます。

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

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

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

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

例

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

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

Set-WSManQuickConfig

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

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

Set-WSManQuickConfig -UseSSL

Note

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

パラメーター

-Force

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipNetworkProfileCheck

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

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

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

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseSSL

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

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

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

None

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

出力

None

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