Set-WSManQuickConfig
リモート管理用にローカル コンピューターを構成します。
構文
All
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
注
HTTPS
パラメーター
-Force
ユーザーの確認を求めずにコマンドを強制的に実行します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SkipNetworkProfileCheck
コンピューターがパブリック ネットワーク上にある場合にリモート処理用の Windows クライアント バージョンを構成します。 このパラメーターは、同じローカル サブネット内のコンピューターからのリモート アクセスのみを許可するパブリック ネットワークのファイアウォール規則を有効にします。
このパラメーターは、Windows のサーバー バージョンには影響しません。既定では、パブリック ネットワーク用のローカル サブネット ファイアウォール規則があります。 Windows のサーバー バージョンでローカル サブネット ファイアウォール規則が無効になっている場合は、このパラメーターの値に関係なく、再度有効 Enable-PSRemoting。
ローカル サブネットの制限を削除し、パブリック ネットワーク上のすべての場所からリモート アクセスを有効にするには、Set-NetFirewallRule モジュールの コマンドレットを使用します。
このパラメーターは PowerShell 3.0 で導入されました。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-UseSSL
リモート コンピューターへの接続を確立するために Secure Sockets Layer (SSL) プロトコルを使用することを指定します。 既定では、SSL は使用されません。
WS-Management は、ネットワーク経由で送信されるすべての PowerShell コンテンツを暗号化します。 UseSSL パラメーターを使用すると、HTTP ではなく HTTPS の追加保護を指定できます。 このパラメーターを使用していて、接続に使用されているポートで SSL を使用できない場合、コマンドは失敗します。
HTTPS では、WinRM とファイアウォール規則を手動で構成する必要があります。 詳細については、「方法: HTTPSの WINRM を構成する」を参照してください。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
入力
None
このコマンドレットにオブジェクトをパイプすることはできません。
出力
String
このコマンドレットは、操作後の構成の状態を説明する 文字列 オブジェクトとしてメッセージを返します。