New-WSManSessionOption
WS-Management コマンドレットの入力パラメーターとして使用するセッション オプション ハッシュ テーブルを作成します。
構文
New-WSManSessionOption
[-ProxyAccessType <ProxyAccessType>]
[-ProxyAuthentication <ProxyAuthentication>]
[-ProxyCredential <PSCredential>]
[-SkipCACheck]
[-SkipCNCheck]
[-SkipRevocationCheck]
[-SPNPort <Int32>]
[-OperationTimeout <Int32>]
[-NoEncryption]
[-UseUTF16]
[<CommonParameters>]
説明
このコマンドレットは、Windows プラットフォームでのみ使用できます。
コマンドレットは New-WSManSessionOption
、WSMan コマンドレットに渡すことができる WSMan セッション オプション ハッシュ テーブルを作成します。
Get-WSManInstance
Set-WSManInstance
Invoke-WSManAction
Connect-WSMan
例
例 1: 接続オプションを使用する接続をCreateする
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
は、通常、リモート コンピューター (この場合は server01 コンピューター) に接続するために WSMan プロバイダーのコンテキストで使用されます。 ただし、WSMan プロバイダーに変更する前に、このコマンドレットを使用して、リモート コンピューターへの接続を確立することができます。 これらの接続は 、ComputerName の一覧に表示されます。
パラメーター
-NoEncryption
接続が HTTP 経由のリモート操作に暗号化を使用しないことを示します。
既定では、暗号化されていないトラフィックは有効になっていません。 ローカル構成で有効にする必要があります。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OperationTimeout
WS-Management 操作のタイムアウトをミリ秒単位で指定します。
Type: | Int32 |
Aliases: | OperationTimeoutMSec |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProxyAccessType
プロキシ サーバーを検索するメカニズムを指定します。 このパラメーターの有効値は、次のとおりです。
ProxyIEConfig
- 現在のユーザーのインターネット エクスプローラー プロキシ構成を使用します。ProxyWinHttpConfig
- WSMan クライアントは、ProxyCfg.exe ユーティリティを使用して、WinHTTP 用に構成されたプロキシ設定を使用します。ProxyAutoDetect
- プロキシ サーバーの自動検出を強制します。ProxyNoProxyServer
- プロキシ サーバーを使用しないでください。 すべてのホスト名をローカルで解決します。
既定値は ProxyIEConfig です。
Type: | ProxyAccessType |
Accepted values: | ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProxyAuthentication
プロキシで使用する認証方法を指定します。 このパラメーターの有効値は、次のとおりです。
Basic
- Basic は、ユーザー名とパスワードがクリア テキストでサーバーまたはプロキシに送信されるスキームです。Digest
- Digest は、チャレンジにサーバー指定のデータ文字列を使用するチャレンジ応答スキームです。Negotiate
- Negotiate は、認証に使用するスキームを決定するためにサーバーまたはプロキシとネゴシエートするチャレンジ応答スキームです。 たとえば、Kerberos プロトコルや NTLM です。
既定値は Negotiate です。
Type: | ProxyAuthentication |
Accepted values: | Negotiate, Basic, Digest |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProxyCredential
中間 Web プロキシ経由でアクセスするためのアクセス許可を持つユーザー アカウントを指定します。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipCACheck
HTTPS 経由で接続するときに、サーバー証明書が信頼された証明機関 (CA) によって署名されていることをクライアントが検証しないことを指定します。 このオプションは、リモート コンピューターが別の方法で信頼されている場合 (たとえば、リモート コンピューターが物理的に安全で分離されたネットワークの一部である場合や、リモート コンピューターが WS-Management 構成で信頼できるホストとして一覧表示されている場合など) にのみ使用します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipCNCheck
サーバーの証明書共通名 (CN) がサーバーのホスト名と一致する必要がないことを指定します。 これは、HTTPS を使用したリモート操作でのみ使用します。 このオプションは、信頼されているコンピューターに対してのみ使用してください。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipRevocationCheck
接続がサーバー証明書の失効状態を検証しないことを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SPNPort
リモート サーバーの接続サービス プリンシパル名 (SPN) に追加するポート番号を指定します。 SPN は、認証メカニズムが Kerberos またはネゴシエートの場合に使用されます。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseUTF16
接続が UTF8 形式ではなく UTF16 形式で要求をエンコードすることを示します。 既定値は UTF8 エンコードです。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
出力
このコマンドレットは、作成された WSMan セッション オプションを SessionOption オブジェクトとして返します。