New-PSSessionOption

New-PSSessionOption
    [-MaximumRedirection <Int32>]
    [-NoCompression]
    [-NoMachineProfile]
    [-Culture <CultureInfo>]
    [-UICulture <CultureInfo>]
    [-MaximumReceivedDataSizePerCommand <Int32>]
    [-MaximumReceivedObjectSize <Int32>]
    [-OutputBufferingMode <OutputBufferingMode>]
    [-MaxConnectionRetryCount <Int32>]
    [-ApplicationArguments <PSPrimitiveDictionary>]
    [-OpenTimeout <Int32>]
    [-CancelTimeout <Int32>]
    [-IdleTimeout <Int32>]
    [-ProxyAccessType <ProxyAccessType>]
    [-ProxyAuthentication <AuthenticationMechanism>]
    [-ProxyCredential <PSCredential>]
    [-SkipCACheck]
    [-SkipCNCheck]
    [-SkipRevocationCheck]
    [-OperationTimeout <Int32>]
    [-NoEncryption]
    [-UseUTF16]
    [-IncludePortInSPN]
    [<CommonParameters>]

New-PSSessionOption cmdlet 创建一个对象，该对象包含用户管理的会话的高级选项（PSSession）。 可以将对象用作 cmdlet 的 SessionOption 参数的值，这些 cmdlet 创建 PSSession，例如 New-PSSession、Enter-PSSession 和 Invoke-Command。

如果没有参数，New-PSSessionOption 将生成一个对象，其中包含所有选项的默认值。 由于可以编辑所有属性，因此可以使用生成的对象作为模板，并为企业创建标准选项对象。

还可以在 $PSSessionOption 首选项变量中保存会话选项对象。 此变量的值为会话选项建立新的默认值。 当没有为会话设置会话选项并且它们优先于在会话配置中设置的选项时，它们有效，但可以通过在创建会话的 cmdlet 中指定会话选项或会话选项对象来替代它们。 有关 $PSSessionOption 首选项变量的详细信息，请参阅 about_Preference_Variables。

在创建会话的 cmdlet 中使用会话选项对象时，会话选项值优先于在$PSSessionOption首选项变量和会话配置中设置的会话的默认值。 但是，它们不优先于会话配置中设置的最大值、配额或限制。 有关会话配置的详细信息，请参阅 about_Session_Configurations。

此命令创建包含所有默认值的会话选项对象。

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

此示例演示如何使用会话选项对象配置会话。

$pso = New-PSSessionOption -Culture "fr-fr" -MaximumReceivedObjectSize 10MB
New-PSSession -ComputerName Server01 -SessionOption $pso

第一个命令创建一个新的会话选项对象，并将其保存在 $pso 变量的值中。 第二个命令使用 New-PSSession cmdlet 在 Server01 远程计算机上创建会话。 该命令使用 $pso 变量的值中的会话选项对象作为命令的 SessionOption 参数的值。

此命令使用 Enter-PSSession cmdlet 启动与 Server01 计算机的交互式会话。

Enter-PSSession -ComputerName Server01 -SessionOption (New-PSSessionOption -NoEncryption -NoCompression)

SessionOption 参数的值是具有 New-PSSessionOption 和 NoCompression 参数的 命令。

New-PSSessionOption 命令括在括号中，以确保它在 Enter-PSSession 命令之前运行。

此示例演示如何修改会话选项对象。 所有属性都具有读/写值。

$a = New-PSSessionOption
$a.OpenTimeout

Days              : 0
Hours             : 0
Minutes           : 3
Seconds           : 0
Milliseconds      : 0
Ticks             : 1800000000
TotalDays         : 0.00208333333333333
TotalHours        : 0.05
TotalMinutes      : 3
TotalSeconds      : 180
TotalMilliseconds : 180000

$a.UICulture = (Get-UICulture)
$a.OpenTimeout = (New-Timespan -Minutes 4)
$a.MaximumConnectionRedirectionCount = 1
$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

使用此方法为企业创建标准会话对象，然后为特定用途创建自定义版本的会话对象。

此命令创建 $PSSessionOption 首选项变量。

$PSSessionOption = New-PSSessionOption -OpenTimeOut 120000

当会话中发生 $PSSessionOption 首选项变量时，它会为使用 New-PSSession、Enter-PSSession和 Invoke-Command cmdlet 创建的会话中的选项建立默认值。

若要使 $PSSessionOption 变量在所有会话中都可用，请将其添加到 PowerShell 会话和 PowerShell 配置文件。

有关 $PSSessionOption 首选项变量的详细信息，请参阅 about_Preference_Variables。 有关配置文件的详细信息，请参阅 about_Profiles。

此示例演示如何使用 SessionOption 对象来满足远程会话配置的要求。

$skipCN = New-PSSessionOption -SkipCNCheck
New-PSSession -ComputerName 171.09.21.207 -UseSSL -Credential Domain01\User01 -SessionOption $SkipCN

第一个命令使用 New-PSSessionOption cmdlet 创建具有 SkipCNCheck 属性的会话选项对象。 该命令将生成的会话对象保存在 $skipCN 变量中。

第二个命令使用 New-PSSession cmdlet 在远程计算机上创建新会话。 $skipCN 检查变量用于 SessionOption 参数的值。

由于计算机由其 IP 地址标识，因此 ComputerName 参数的值与用于安全套接字层（SSL）的证书中的任何公用名不匹配。 因此，SkipCNCheck 选项是必需的。

此示例演示如何使用 cmdlet 的 New-PSSessionOption 参数使其他数据可用于远程会话。

$team = @{Team="IT"; Use="Testing"}
$TeamOption = New-PSSessionOption -ApplicationArguments $team
$s = New-PSSession -ComputerName Server01 -SessionOption $TeamOption
Invoke-Command -Session $s {$PSSenderInfo.ApplicationArguments}

Name                 Value
----                 -----
Team                 IT
Use                  Testing
PSVersionTable       {CLRVersion, BuildVersion, PSVersion, WSManStackVersion...}

Invoke-Command -Session $s {
  if ($PSSenderInfo.ApplicationArguments.Use -ne "Testing") {
    .\logFiles.ps1
  }
  else {
    "Just testing."
  }
}

Just testing.

第一个命令创建一个包含两个键的哈希表，Team 和 Use。 该命令将哈希表保存在 $team 变量中。 有关哈希表的详细信息，请参阅 about_Hash_Tables。

接下来，New-PSSessionOption cmdlet 使用 ApplicationArguments 参数创建保存在 $team 变量中的会话选项对象。 New-PSSessionOption 创建会话选项对象时，它会自动将 ApplicationArguments 参数的值中的哈希表转换为基元字典，以便将数据可靠地传输到远程会话。

New-PSSession cmdlet 在 Server01 计算机上启动会话。 它使用 SessionOption 参数将选项包含在 $teamOption 变量中。

Invoke-Command cmdlet 演示 $team 变量中的数据可用于远程会话中的命令。 数据显示在 自动变量的 $PSSenderInfo 属性中。

最终 Invoke-Command 显示数据可能的使用方式。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

不能通过管道将输入传递给此 cmdlet。

如果未在命令中使用 SessionOption 参数来创建 PSSession，则会话选项由 $PSSessionOption 首选项变量的属性值确定（如果已设置）。 有关 $PSSessionOption 变量的详细信息，请参阅 about_Preference_Variables。

会话配置对象的属性因为会话配置设置的选项以及这些选项的值而有所不同。 此外，使用会话配置文件的会话配置具有其他属性。