New-PSTransportOption

参考

模块:: Microsoft.PowerShell.Core

创建一个对象，其中包含会话配置的高级选项。

语法

New-PSTransportOption
   [-MaxIdleTimeoutSec <Int32>]
   [-ProcessIdleTimeoutSec <Int32>]
   [-MaxSessions <Int32>]
   [-MaxConcurrentCommandsPerSession <Int32>]
   [-MaxSessionsPerUser <Int32>]
   [-MaxMemoryPerSessionMB <Int32>]
   [-MaxProcessesPerSession <Int32>]
   [-MaxConcurrentUsers <Int32>]
   [-IdleTimeoutSec <Int32>]
   [-OutputBufferingMode <OutputBufferingMode>]
   [<CommonParameters>]

说明

New-PSTransportOption cmdlet 创建包含会话配置的传输选项的对象。可以将对象用作创建或更改会话配置的 cmdlet TransportOption 参数的值，例如 Register-PSSessionConfiguration 和 Set-PSSessionConfiguration cmdlet。

还可以通过编辑 WSMan：驱动器中的会话配置属性的值来更改传输选项设置。有关详细信息，请参阅 WSMan 提供程序。

会话配置选项表示在服务器端设置的会话值，或接收远程连接的末尾。客户端或发送连接的末尾，可以在创建会话时或客户端断开或重新连接到会话时设置会话选项值。除非另有说明，否则设置值冲突时，客户端值优先。但是，客户端值不能违反会话配置中设置的最大值和配额。

如果没有参数，New-PSTransportOption 将生成一个传输选项对象，该对象具有所有选项的 null 值。如果省略参数，则该对象具有参数所表示的属性的 null 值。 null 值不会影响会话配置。

有关会话选项的详细信息，请参阅 New-PSSessionOption。有关会话配置的详细信息，请参阅 about_Session_Configurations。

此 cmdlet 已在 Windows PowerShell 3.0 中引入。

示例

示例 1：生成默认传输选项

New-PSTransportOption

ProcessIdleTimeoutSec           :
MaxIdleTimeoutSec               :
MaxSessions                     :
MaxConcurrentCommandsPerSession :
MaxSessionsPerUser              :
MaxMemoryPerSessionMB           :
MaxProcessesPerSession          :
MaxConcurrentUsers              :
IdleTimeoutSec                  :
OutputBufferingMode             :

此命令在没有参数的情况下运行 New-PSTransportOption。输出显示 cmdlet 生成一个传输选项对象，该对象具有所有属性的 null 值。

示例 2：获取会话配置选项

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

$t = New-PSTransportOption -MaxSessions 40
Register-PSSessionConfiguration -Name ITTasks -TransportOption $t
Get-PSSessionConfiguration -Name ITTasks | Format-List -Property *

Architecture                  : 64
Filename                      : %windir%\system32\pwrshplugin.dll
ResourceUri                   : http://schemas.microsoft.com/powershell/ITTasks
MaxConcurrentCommandsPerShell : 1000
UseSharedProcess              : false
ProcessIdleTimeoutSec         : 0
xmlns                         : http://schemas.microsoft.com/wbem/wsman/1/config/PluginConfiguration
MaxConcurrentUsers            : 5
lang                          : en-US
SupportsOptions               : true
ExactMatch                    : true
RunAsUser                     :
IdleTimeoutms                 : 7200000
PSVersion                     : 3.0
OutputBufferingMode           : Block
AutoRestart                   : false
MaxShells                     : 40
MaxMemoryPerShellMB           : 1024
MaxIdleTimeoutMs              : 43200000
SDKVersion                    : 2
Name                          : ITTasks
XmlRenderingType              : text
Capability                    : {Shell}
RunAsPassword                 :
MaxProcessesPerShell          : 15
Enabled                       : True
MaxShellsPerUser              : 25
Permission                    :

第一个命令使用 New-PSTransportOption cmdlet 创建传输选项对象，该对象保存在 $t 变量中。该命令使用 MaxSessions 参数将最大会话数增加到 40。

第二个命令使用 Register-PSSessionConfiguration cmdlet 创建 ITTasks 会话配置。该命令使用 TransportOption 参数在 $t 变量中指定传输选项对象。

第三个命令使用 Get-PSSessionConfiguration cmdlet 来获取 ITTasks 会话配置和 Format-List cmdlet，以在列表中显示会话配置对象的所有属性。输出显示会话配置的 MaxShells 属性的值为 40。

示例 3：设置传输选项

此命令显示在使用会话配置的会话配置中设置传输选项的效果。

$t = New-PSTransportOption -IdleTimeoutSec 3600
Set-PSSessionConfiguration -Name ITTasks -TransportOption $t
$s = New-PSSession -Name MyITTasks -ConfigurationName ITTasks
$s | Format-List -Property *

State                  : Opened
IdleTimeout            : 3600000
OutputBufferingMode    : Block
ComputerName           : localhost
ConfigurationName      : ITTasks
InstanceId             : 4110c3f5-68ea-40fa-9bbf-04a433dbb02d
Id                     : 1
Name                   : MyITTasks
Availability           : Available
ApplicationPrivateData : {PSVersionTable}
Runspace               : System.Management.Automation.RemoteRunspace

第一个命令使用 New-PSTransportOption cmdlet 创建传输选项对象。该命令使用 IdleTimeoutSec 参数将对象的 IdleTimeoutSec 属性值设置为 1 小时（3600 秒）。该命令将传输对象对象保存在 $t 变量中。

第二个命令使用 Set-PSSessionConfiguration cmdlet 更改 ITTasks 会话配置的传输选项。该命令使用 TransportOption 参数在 $t 变量中指定传输选项对象。

第三个命令使用 New-PSSession cmdlet 在本地计算机上创建 MyITTasks 会话。该命令使用 ConfigurationName 属性来指定 ITTasks 会话配置。该命令将会话保存在$s变量中。请注意，该命令不使用的 New-PSSession 参数设置会话的自定义空闲超时。如果确实如此，会话选项中设置的空闲超时值将优先于会话配置中设置的空闲超时值。

第四个命令使用 Format-List cmdlet 在列表中 $s 变量中显示会话的所有属性。输出显示会话的空闲超时为 1 小时（360,000 毫秒）。

参数

-IdleTimeoutSec

确定如果远程计算机未从本地计算机接收任何通信，则每个会话保持打开的时间。这包括检测信号。当间隔过期时，会话将关闭。

当用户打算断开连接并重新连接到会话时，空闲超时值非常重要。仅当会话未超时时，用户才能重新连接。

IdleTimeoutSec 参数对应于会话配置的 IdleTimeoutMs 属性。

以秒为单位输入值。默认值为 7200 （2 小时）。最小值为 60 （1 分钟）。最大值是 WSMan 配置（）中 Shell 对象的 WSMan:\\\<ComputerName\>\Shell\IdleTimeout 属性的值。默认值为 7200000 毫秒（2 小时）。

如果在会话选项和会话配置中设置了空闲超时值，则会话选项中设置的值优先，但不能超过会话配置的 MaxIdleTimeoutMs 属性的值。若要设置 MaxIdleTimeoutMs 属性的值，请使用 MaxIdleTimeoutSec 参数。

类型:	Nullable<T>[Int32]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-MaxConcurrentCommandsPerSession

将每个会话中可以同时运行的命令数限制为指定的值。默认值为 1000。

MaxConcurrentCommandsPerSession 参数对应于会话配置的 MaxConcurrentCommandsPerShell 属性。

类型:	Nullable<T>[Int32]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-MaxConcurrentUsers

将每个会话中可以同时运行命令的用户数限制为指定的值。默认值为 5。

类型:	Nullable<T>[Int32]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-MaxIdleTimeoutSec

将每个会话的空闲超时设置为指定值。默认值为 [int]::MaxValue（约 25 天）。

当用户打算断开连接并重新连接到会话时，空闲超时值非常重要。仅当会话未超时时，用户才能重新连接。

MaxIdleTimeoutSec 参数对应于会话配置的 MaxIdleTimeoutMs 属性。

类型:	Nullable<T>[Int32]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-MaxMemoryPerSessionMB

将每个会话使用的内存限制为指定的值。输入一个以兆字节为单位的值。默认值为 1024 兆字节（1 GB）。

MaxMemoryPerSessionMB 参数对应于会话配置的 MaxMemoryPerShellMB 属性。

类型:	Nullable<T>[Int32]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-MaxProcessesPerSession

将每个会话中运行的进程数限制为指定值。默认值为 15。

MaxProcessesPerSession 参数对应于会话配置的 MaxProcessesPerShell 属性。

类型:	Nullable<T>[Int32]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-MaxSessions

限制使用会话配置的会话数。默认值为 25。

MaxSessions 参数对应于会话配置的 MaxShells 属性。

类型:	Nullable<T>[Int32]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-MaxSessionsPerUser

限制使用会话配置的会话数，并将给定用户的凭据运行的会话数限制为指定值。默认值为 25。

指定此值时，请考虑许多用户可能正在使用作为用户的运行凭据。

MaxSessionsPerUser 参数对应于会话配置的 MaxShellsPerUser 属性。

类型:	Nullable<T>[Int32]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-OutputBufferingMode

确定当输出缓冲区已满时如何在断开连接的会话中管理命令输出。此参数的可接受值为：

Block 当输出缓冲区已满时，执行将挂起，直到缓冲区清除为止。
Drop 当输出缓冲区已满时，将继续执行。保存新输出后，将丢弃最早的输出。
None 未指定输出缓冲模式。

会话的 OutputBufferingMode 属性的默认值为 Block。

类型:	Nullable<T>[OutputBufferingMode]
接受的值:	None, Drop, Block
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-ProcessIdleTimeoutSec

将每个主机进程的超时限制为指定的值。默认值 0 表示进程没有超时值。

其他会话配置具有每个进程超时值。例如，Microsoft.PowerShell.Workflow 会话配置的每个进程超时值为 28800 秒（8 小时）。

类型:	Nullable<T>[Int32]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

输入

None

不能通过管道将对象传递给此 cmdlet。

输出

WSManConfigurationOption

备注

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

通过