New-WSManSessionOption
WS-Management コマンドレットの入力パラメーターとして使用するセッション オプション ハッシュ テーブルを作成します。
構文
Default (既定)
New-WSManSessionOption
[-ProxyAccessType <ProxyAccessType>]
[-ProxyAuthentication <ProxyAuthentication>]
[-ProxyCredential <PSCredential>]
[-SkipCACheck]
[-SkipCNCheck]
[-SkipRevocationCheck]
[-SPNPort <Int32>]
[-OperationTimeout <Int32>]
[-NoEncryption]
[-UseUTF16]
[<CommonParameters>]
説明
このコマンドレットは、Windows プラットフォームでのみ使用できます。
New-WSManSessionOption コマンドレットは、WSMan コマンドレットに渡すことができる WSMan セッション オプション ハッシュ テーブルを作成します。
Get-WSManInstanceSet-WSManInstanceInvoke-WSManActionConnect-WSMan
例
例 1: 接続オプションを使用する接続を作成する
PS C:\> $a = New-WSManSessionOption -OperationTimeout 30000
PS C:\> Connect-WSMan -ComputerName "server01" -SessionOption $a
PS C:\> cd WSMan:
PS WSMan:\> dir
WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan
ComputerName Type
------------ ----
localhost Container
server01 Container
この例では、New-WSManSessionOptionで定義されている接続オプションを使用して、リモート サーバー 01 コンピューターへの接続を作成します。
最初のコマンドでは、New-WSManSessionOption を使用して、接続設定オプションのセットを $a 変数に格納します。 この場合、セッション オプションは 30 秒 (30,000 ミリ秒) の接続時間を設定します。
2 番目のコマンドでは、SessionOption パラメーターを使用して、$a 変数に格納されている資格情報を渡して Connect-WSManします。 次に、Connect-WSMan 指定したセッション オプションを使用してリモート サーバー 01 コンピューターに接続します。
Connect-WSMan は、通常、WSMan プロバイダーのコンテキストでリモート コンピューター (この場合は server01 コンピューター) に接続するために使用されます。 ただし、WSMan プロバイダーに変更する前に、コマンドレットを使用してリモート コンピューターへの接続を確立できます。 これらの接続は、ComputerName の一覧に表示されます。
パラメーター
-NoEncryption
接続が HTTP 経由のリモート操作に暗号化を使用しないことを示します。
既定では、暗号化されていないトラフィックは有効になっていません。 ローカル構成で有効にする必要があります。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-OperationTimeout
WS-Management 操作のタイムアウトをミリ秒単位で指定します。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | OperationTimeoutMSec |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ProxyAccessType
プロキシ サーバーを配置するメカニズムを指定します。 このパラメーターに使用できる値は次のとおりです。
-
ProxyIEConfig- 現在のユーザーの Internet Explorer プロキシ構成を使用します。 -
ProxyWinHttpConfig- WSMan クライアントは、ProxyCfg.exe ユーティリティを使用して、WinHTTP 用に構成されたプロキシ設定を使用します。 -
ProxyAutoDetect- プロキシ サーバーの自動検出を強制します。 -
ProxyNoProxyServer- プロキシ サーバーを使用しないでください。 すべてのホスト名をローカルで解決します。
既定値は ProxyIEConfig です。
パラメーターのプロパティ
| 型: | ProxyAccessType |
| 規定値: | None |
| 指定可能な値: | ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ProxyAuthentication
プロキシで使用する認証方法を指定します。 このパラメーターに使用できる値は次のとおりです。
-
Basic- Basic は、ユーザー名とパスワードがクリア テキストでサーバーまたはプロキシに送信されるスキームです。 -
Digest- ダイジェストは、チャレンジにサーバー指定のデータ文字列を使用するチャレンジ応答スキームです。 -
Negotiate- ネゴシエートは、認証に使用するスキームを決定するためにサーバーまたはプロキシとネゴシエートするチャレンジ応答スキームです。 たとえば、Kerberos プロトコルと NTLM です。
既定値は Negotiate です。
パラメーターのプロパティ
| 型: | ProxyAuthentication |
| 規定値: | None |
| 指定可能な値: | Negotiate, Basic, Digest |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ProxyCredential
中間 Web プロキシ経由でアクセスするためのアクセス許可を持つユーザー アカウントを指定します。
パラメーターのプロパティ
| 型: | PSCredential |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SkipCACheck
HTTPS 経由で接続するときに、クライアントがサーバー証明書が信頼された証明機関 (CA) によって署名されていることを検証しないことを指定します。 このオプションは、リモート コンピューターが別の方法で信頼されている場合 (たとえば、リモート コンピューターが物理的に安全で分離されたネットワークの一部である場合や、リモート コンピューターが WS-Management 構成で信頼されたホストとして表示されている場合など) にのみ使用します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SkipCNCheck
サーバーの証明書共通名 (CN) がサーバーのホスト名と一致する必要がないことを指定します。 これは、HTTPS を使用するリモート操作でのみ使用されます。 このオプションは、信頼できるコンピューターにのみ使用してください。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SkipRevocationCheck
接続がサーバー証明書の失効状態を検証しないことを示します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SPNPort
リモート サーバーの接続サービス プリンシパル名 (SPN) に追加するポート番号を指定します。 SPN は、認証メカニズムが Kerberos または Negotiate の場合に使用されます。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-UseUTF16
接続が UTF8 形式ではなく UTF16 形式で要求をエンコードすることを示します。 既定値は UTF8 エンコードです。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
出力
SessionOption
このコマンドレットは、作成された WSMan セッション オプションを SessionOption オブジェクトとして返します。