New-PSSessionOption

New-PSSessionOption [-ApplicationArguments <PSPrimitiveDictionary>] [-CancelTimeOut <int>] [-Culture <CultureInfo>] [-IdleTimeOut <int>] [-MaximumReceivedDataSizePerCommand <int>] [-MaximumReceivedObjectSize <int>] [-MaximumRedirection <int>] [-NoCompression] [-NoEncryption] [-NoMachineProfile] [-OpenTimeOut <int>] [-OperationTimeOut <int>] [-ProxyAccessType {<None> | <IEConfig> | <WinHttpConfig> | <AutoDetect> | <NoProxyServer>}] [-ProxyAuthentication {<Default> | <Basic> | <Negotiate> | <NegotiateWithImplicitCredential> | <Credssp> | <Digest> | <Kerberos>}] [-ProxyCredential <PSCredential>] [-SkipCACheck] [-SkipCNCheck] [-SkipRevocationCheck] [-UICulture <CultureInfo>] [-UseUTF16] [<CommonParameters>]

C:\PS>New-PSSessionOption


MaximumConnectionRedirectionCount : 5
NoCompression                     : False
NoMachineProfile                  : False
ProxyAccessType                   : IEConfig
ProxyAuthentication               : Negotiate
ProxyCredential                   :
SkipCACheck                       : False
SkipCNCheck                       : False
SkipRevocationCheck               : False
OperationTimeout                  : 00:03:00
NoEncryption                      : False
UseUTF16                          : False
Culture                           :
UICulture                         :
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize         :
ApplicationArguments              :
OpenTimeout                       : 00:03:00
CancelTimeout                     : 00:01:00
IdleTimeout                       : 00:04:00

説明
-----------
このコマンドは、セッション オプション オブジェクトをすべて既定値で作成します。

C:\PS>$pso = new-pssessionoption -Culture "fr-fr" -MaximumReceivedObjectSize 10MB

C:\PS> new-pssession -computerName Server01 -SessionOption $pso

説明
-----------
この例は、セッション オプション オブジェクトを使用してセッションを構成する方法を示しています。

最初のコマンドは、新しいセッション オプション オブジェクトを作成し、$pso 変数の値で保存します。

2 番目のコマンドは、New-PSSession コマンドレットを使用して Server01 リモート コンピューターで PSSession を作成します。このコマンドは、$pso 変数の値のセッション オプション オブジェクトを、コマンドの SessionOption パラメーターの値として使用します。

C:\PS>enter-pssession -computername Server01 -sessionOption (new-pssessionoption -noEncryption -noCompression)

説明
-----------
このコマンドは、Enter-PSSession コマンドレットを使用して、Server01 コンピューターとの対話型のセッションを開始します。SessionOption パラメーターの値は、NoEncryption および NoCompression スイッチ パラメーターを指定した New-PSSessionOption コマンドです。

New-PSSessionOption コマンドは、Enter-PSSession コマンドの前に確実に実行されるように、丸かっこで囲みます。

C:\PS>$a = new-pssessionoption


MaximumConnectionRedirectionCount : 5
NoCompression                     : False
NoMachineProfile                  : False
ProxyAccessType                   : IEConfig
ProxyAuthentication               : Negotiate
ProxyCredential                   :
SkipCACheck                       : False
SkipCNCheck                       : False
SkipRevocationCheck               : False
OperationTimeout                  : 00:03:00
NoEncryption                      : False
UseUTF16                          : False
Culture                           :
UICulture                         :
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize         :
ApplicationArguments              :
OpenTimeout                       : 00:03:00
CancelTimeout                     : 00:01:00
IdleTimeout                       : 00:04:00

C:\PS> $a.UICulture = (get-UICulture)
C:\PS> $a.OpenTimeout = (new-timespan -minutes 4)
C:\PS> $a.MaximumConnectionRedirectionCount = 1

C:\PS> $a

MaximumConnectionRedirectionCount : 1
NoCompression                     : False
NoMachineProfile                  : False
ProxyAccessType                   : IEConfig
ProxyAuthentication               : Negotiate
ProxyCredential                   :
SkipCACheck                       : False
SkipCNCheck                       : False
SkipRevocationCheck               : False
OperationTimeout                  : 00:03:00
NoEncryption                      : False
UseUTF16                          : False
Culture                           :
UICulture                         : en-US
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize         :
ApplicationArguments              :
OpenTimeout                       : 00:04:00
CancelTimeout                     : 00:01:00
IdleTimeout                       : 00:04:00

説明
-----------
この例は、セッション オプション オブジェクトを編集できることを示しています。すべてのプロパティは、読み取り/書き込みの値を持っています。

このメソッドを使用してエンタープライズ用の標準的なセッション オブジェクトを作成してから、特定の使用のためのカスタム バージョンを作成します。

C:\PS>$PSSessionOption = New-PSSessionOption -OpenTimeOut 120000

説明
-----------
このコマンドは、$PSSessionOption 設定変数を作成します。

$PSSessionOption 設定変数がセッションに存在する場合、New-PSSession、Enter-PSSession、および Invoke-Command コマンドレットを使用して作成される PSSessions のオプションの既定値を設定します。

$PSSessionOption 変数がすべてのセッションで使用できるようにするには、Windows PowerShell セッションおよび Windows PowerShell プロファイルにコマンドを追加します。

$PSSessionOption 変数の詳細については、「about_Preference_Variables」を参照してください。プロファイルの詳細については、「about_Profiles」を参照してください。

C:\PS>$skipCN = new-pssessionoption -SkipCNCheck

C:\PS> new-pssession -computername 171.09.21.207 -UseSSL -credential domain01\user01 -sessionOption $skipCN

説明
-----------
この例は、SessionOption オブジェクトを使用してリモート セッション構成の要件を満たす方法を示しています。

最初のコマンドは、New-PSSessionOption コマンドレットを使用し、SkipCNCheck プロパティを持つ、セッション オプション オブジェクトを作成します。このコマンドは、結果のセッション オブジェクトを $skipCN 変数に保存します。

2 番目のコマンドは、New-PSSession コマンドレットを使用してリモート コンピューターで新しい PSSession を作成します。$skipCN 変数は SessionOption パラメーターの値に使用されます。

コンピューターは IP アドレスで識別されるため、ComputerName パラメーターの値は SSL (Secure Sockets Layer) に使用される証明書の共通名と一致しません。その結果、SkipCNCheck オプションが必要となります。