次の方法で共有


New-WSManSessionOption

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

この例では、 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
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-OperationTimeout

WS-Management 操作のタイムアウトをミリ秒単位で指定します。

型:Int32
Aliases:OperationTimeoutMSec
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ProxyAccessType

プロキシ サーバーを検索するメカニズムを指定します。 このパラメーターの有効値は、次のとおりです。

  • ProxyIEConfig - 現在のユーザーに対して Internet Explorer プロキシ構成を使用します。
  • ProxyWinHttpConfig - WSMan クライアントは、ProxyCfg.exe ユーティリティを使用して、WinHTTP 用に構成されたプロキシ設定を使用します。
  • ProxyAutoDetect - プロキシ サーバーの自動検出を強制します。
  • ProxyNoProxyServer - プロキシ サーバーは使用しないでください。 すべてのホスト名をローカルで解決します。

既定値は ProxyIEConfig です。

型:ProxyAccessType
指定可能な値:ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ProxyAuthentication

プロキシで使用する認証方法を指定します。 このパラメーターの有効値は、次のとおりです。

  • Basic - Basic は、ユーザー名とパスワードがクリア テキストでサーバーまたはプロキシに送信されるスキームです。
  • Digest - Digest は、チャレンジにサーバー指定のデータ文字列を使用するチャレンジ応答スキームです。
  • Negotiate - Negotiate は、認証に使用するスキームを決定するためにサーバーまたはプロキシとネゴシエートするチャレンジ応答スキームです。 たとえば、Kerberos プロトコルや NTLM です。

既定値は Negotiate です。

型:ProxyAuthentication
指定可能な値:Negotiate, Basic, Digest
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ProxyCredential

中間 Web プロキシ経由でアクセスするためのアクセス許可を持つユーザー アカウントを指定します。

型:PSCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SkipCACheck

HTTPS 経由で接続するときに、クライアントがサーバー証明書が信頼された証明機関 (CA) によって署名されていることを検証しないことを指定します。 このオプションは、リモート コンピューターが別の方法で信頼されている場合 (たとえば、リモート コンピューターが物理的に安全で分離されたネットワークの一部である場合や、リモート コンピューターが WS-Management 構成で信頼されたホストとして表示されている場合など) にのみ使用します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SkipCNCheck

サーバーの証明書共通名 (CN) がサーバーのホスト名と一致する必要がないことを指定します。 これは、HTTPS を使用したリモート操作でのみ使用します。 このオプションは、信頼されているコンピューターに対してのみ使用してください。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SkipRevocationCheck

接続がサーバー証明書の失効状態を検証しないことを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SPNPort

リモート サーバーの接続サービス プリンシパル名 (SPN) に追加するポート番号を指定します。 SPN は、認証メカニズムが Kerberos またはネゴシエートの場合に使用されます。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-UseUTF16

接続が UTF8 形式ではなく UTF16 形式で要求をエンコードすることを示します。 既定値は UTF8 エンコードです。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

出力

SessionOption

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