次の方法で共有


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-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
規定値: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 オブジェクトとして返します。