New-WSManSessionOption

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

WS-Management コマンドレットの入力パラメーターとして使用するセッション オプション ハッシュ テーブルを作成します。

構文

New-WSManSessionOption
   [-ProxyAccessType <ProxyAccessType>]
   [-ProxyAuthentication <ProxyAuthentication>]
   [-ProxyCredential <PSCredential>]
   [-SkipCACheck]
   [-SkipCNCheck]
   [-SkipRevocationCheck]
   [-SPNPort <Int32>]
   [-OperationTimeout <Int32>]
   [-NoEncryption]
   [-UseUTF16]
   [<CommonParameters>]

説明

このコマンドレットは New-WSManSessionOption 、WSMan コマンドレットに渡すことができる WSMan セッション オプション ハッシュ テーブルを作成します。

  • Get-WSManInstance
  • Set-WSManInstance
  • Invoke-WSManAction
  • Connect-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

次の使用例は、次に定義されている接続オプションを使用して、リモート サーバー 01 コンピューターへの接続を作成 New-WSManSessionOptionします。

最初のコマンドは、一連の接続設定オプションを変数に$a格納するために使用New-WSManSessionOptionします。 この場合は、セッション オプションで接続のタイムアウトを 30 秒 (30,000 ミリ秒) に設定します。

2 番目のコマンドは、SessionOption パラメーターを使用して、変数Connect-WSManに格納されている資格情報を $a . 次に、 Connect-WSMan 指定したセッション オプションを使用してリモート サーバー 01 コンピューターに接続します。

Connect-WSMan は通常、WSMan プロバイダーのコンテキストでリモート コンピューター (この場合は server01 コンピューター) に接続するために使用されます。 ただし、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

出力

SessionOption

このコマンドレットは、作成された WSMan セッション オプションを SessionOption オブジェクトとして返します。