Export (0) Print
Expand All

Get-NetTCPSetting

Applies To: Windows Server 2012

Get-NetTCPSetting

Gets information about TCP settings and configuration.

Syntax

Parameter Set: ByName
Get-NetTCPSetting [[-SettingName] <String[]> ] [-AsJob] [-AssociatedTransportFilter <CimInstance> ] [-AutoTuningLevelEffective <AutoTuningLevelEffective[]> ] [-AutoTuningLevelGroupPolicy <AutoTuningLevelGroupPolicy[]> ] [-AutoTuningLevelLocal <AutoTuningLevelLocal[]> ] [-CimSession <CimSession[]> ] [-CongestionProvider <CongestionProvider[]> ] [-CwndRestart <CwndRestart[]> ] [-DelayedAckTimeoutMs <UInt32[]> ] [-DynamicPortRangeNumberOfPorts <UInt16[]> ] [-DynamicPortRangeStartPort <UInt16[]> ] [-EcnCapability <EcnCapability[]> ] [-InitialCongestionWindowMss <UInt32[]> ] [-InitialRtoMs <UInt32[]> ] [-MemoryPressureProtection <MemoryPressureProtection[]> ] [-MinRtoMs <UInt32[]> ] [-ScalingHeuristics <ScalingHeuristics[]> ] [-ThrottleLimit <Int32> ] [-Timestamps <Timestamps[]> ] [ <CommonParameters>]




Detailed Description

The Get-NetTCPSetting cmdlet gets information for each TCP setting. There will be different connection characteristics when connecting over a wide area network and within a data center. Thus each TCP setting is optimized for different network conditions including latency and congestion. The default application of the TCP setting is Automatic. To apply a TCP setting to a specific port number or destination IP address range, use the New-NetTransportFilter cmdlet.

Without parameters, this cmdlet returns all TCP settings.

Parameters

-AsJob

Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to complete. The cmdlet immediately returns an object that represents the job and then displays the command prompt. You can continue to work in the session while the job completes. To manage the job, use the *-Job cmdlets. To get the job results, use the Receive-Job cmdlet. For more information about Windows PowerShell® background jobs, see about_Jobs.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-AssociatedTransportFilter<CimInstance>

Gets TCP setting information that applies to a specific network transport filter CIM object. This is typically as input through a pipeline.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-AutoTuningLevelEffective<AutoTuningLevelEffective[]>

Gets TCP setting information only about a specific AutoTuningLevelEffective property. TCP auto-tuning improves throughput on high throughput, high latency networks. AutoTuningLevelEffective determines the effective setting of the TCP auto-tuning level. The acceptable values for this parameter are: :
-- Local: The TCP settings that currently have AutoTuningLevelEffective locally configured.
-- GroupPolicy: The TCP settings that currently have AutoTuningLevelEffective configured through group policy.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-AutoTuningLevelGroupPolicy<AutoTuningLevelGroupPolicy[]>

Gets TCP setting information only about a specific AutoTuningLevelGroupPolicy property. TCP auto-tuning improves throughput on high throughput, high latency networks. AutoTuningLevelGroupPolicy determines the setting of the TCP auto-tuning level that is configured by group policy. This group policy is uniformly applied across all NetTcpSettings. The AutoTuningLevelGroupPolicy settings include (Disabled) set the TCP receive window at its default value; (HighlyRestricted) set TCP to allow the receive window to grow beyond its default value, but do so very conservatively; (Restricted) set TCP to allow the receive window to grow beyond its default value, but does so less conservatively; (Normal) set TCP to allow the receive window to grow to accommodate almost all scenarios; (Experimental) Set TCP to allow the receive window to grow to accommodate extreme scenarios. (NotConfigured) No group policy is applied for AutoTuningLevel. The acceptable values for this parameter are: 
-- Disabled: The TCP settings that currently have TCP auto-tuning disabled.
-- HighlyRestricted: The TCP settings that have the TCP AutoTuningLevelGroupPolicy as HighlyRestricted.
-- Restricted: The TCP settings that currently have TCP AutoTuningLevelGroupPolicy as Restricted.
-- Normal: The TCP settings that currently have TCP AutoTuningLevelGroupPolicy as Normal.
-- Experimental: The TCP settings that currently have TCP AutoTuningLevelGroupPolicy as Experimental.
-- NotConfigured: The TCP settings that currently have TCP AutoTuningLevelGroupPolicy as not configured.
-- NotChanged: The TCP settings that currently have TCP AutoTuningLevelGroupPolicy as Not changed.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-AutoTuningLevelLocal<AutoTuningLevelLocal[]>

Gets TCP setting information only about a specific AutoTuningLevelLocal property. TCP auto-tuning improves throughput on high throughput, high latency networks. AutoTuningLevelLocal determines the setting of the TCP auto-tuning level that is locally configured. The AutoTuningLevelLocal settings include (Disabled) set the TCP receive window at its default value; (HighlyRestricted) set TCP to allow the receive window to grow beyond its default value, but do so very conservatively; (Restricted) set TCP to allow the receive window to grow beyond its default value, but does so less conservatively; (Normal) set TCP to allow the receive window to grow to accommodate almost all scenarios; (Experimental) Set TCP to allow the receive window to grow to accommodate extreme scenarios. The acceptable values for this parameter are: 
-- Disabled: The TCP settings that currently have TCP auto-tuning disabled.
-- HighlyRestricted: The TCP settings that have the TCP AutoTuningLevelLocal as HighlyRestricted.
-- Restricted: The TCP settings that currently have TCP AutoTuningLevelLocal as Restricted.
-- Normal: The TCP settings that currently have TCP AutoTuningLevelLocal as Normal.
-- Experimental: The TCP settings that currently have TCP AutoTuningLevelLocal as Experimental.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-CimSession<CimSession[]>

Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSession or Get-CimSession cmdlet. The default is the current session on the local computer.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-CongestionProvider<CongestionProvider[]>

Gets TCP setting information only for settings that have a specific CongestionProvider. CongestionProvider determines the congestion provider used by TCP. The CongestionProvider settings include (Default) the TCP stack uses its default setting. Servers use DCTCP by default. Clients use NewReno as defined in RFC 3782; (CTCP) the TCP stack uses Compound TCP, which increases the receive window and amount of data sent. This may improve throughput on higher latency connections; (DCTCP) the TCP stack uses Datacenter TCP, which adjusts the TCP window size based on network congestion feedback based on ECN signaling. This may improve throughput on low latency links. The acceptable values for this parameter are: 
-- Default: The TCP settings that have the CongestionProvider as Default.
-- CTCP: The TCP settings that have the CongestionProvider as Compound TCP.
-- DCTCP: The TCP settings that have the CongestionProvider as Data Center TCP.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-CwndRestart<CwndRestart[]>

Gets TCP setting information only for settings that have CwndRestart set to False or True. CwndRestart determines whether congestion window is restarted and can avoid slow start to optimize throughput on low latency networks. This is described in RFC 2581. The CwndRestart settings include (False) set the TCP stack uses its default setting; (True) the TCP stack uses CwndRestart. The acceptable values for this parameter are: 
-- False: The TCP settings that have the CwndRestart as False.
-- True: The TCP settings that have the CwndRestart as True.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DelayedAckTimeoutMs<UInt32[]>

Gets TCP setting information only for a specific DelayedAckTimeoutMs. DelayedAckTimeoutMs controls the timeout, in milliseconds, for sending an ACK when less than delackfrequency packets are received. Reducing this time will potentially benefit throughput on low latency networks by accelerating growth in TCP window size. The acceptable values for this parameter are:  10 through 600.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DynamicPortRangeNumberOfPorts<UInt16[]>

Gets TCP setting information only for a specific DynamicPortRangeNumberOfPorts. DynamicPortRangeNumberOfPorts specifies the number of ports for the dynamic port range starting from the DynamicPortRangeStartPort.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DynamicPortRangeStartPort<UInt16[]>

Gets TCP setting information only for a specific DynamicPortRangeStartPort. DynamicPortRangeStartPort specifies the starting port to send TCP traffic. The acceptable values for this parameter are:  1 through 65535.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-EcnCapability<EcnCapability[]>

Gets TCP setting information only for settings if they have EcnCapability enabled or disabled. EcnCapability controls if a TCP setting can use the ECN Capability on the system. If the NetIPInterface setting of ECNMarking is disabled or has a static setting configured to UseECT0 or UseEct1, then this setting will not have an effect. The acceptable values for this parameter are: 
-- Enabled: The TCP settings that have the EcnCapability as Enabled.
-- Disabled: The TCP settings that have the EcnCapability as Disabled.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-InitialCongestionWindowMss<UInt32[]>

Gets TCP setting information only for a specific InitialCongestionWindowMss. InitialCongestionWindowMss determines the initial congestion window in Maximum Segment Size. The acceptable values for this parameter are:  2 through 64.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-InitialRtoMs<UInt32[]>

Gets TCP setting information only for a specific InitialRtoMs. InitialRtoMs determines the connect (SYN) retransmit timeout, in milliseconds. The default value is 3000.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-MemoryPressureProtection<MemoryPressureProtection[]>

Gets the MemoryPressureProtection property. TCP memory pressure protection ensures the computer can continue normal operation when in low on memory due to DoS attacks. When enabled, in low memory, and a DoS attack is in progress, MemoryPressureProtection will kill the existing TCP connections and drop incoming SYN requests. Enabled by default on servers and Disabled by default on clients. The acceptable values for this parameter are: 
-- Disabled: The TCP settings that have TCP memory pressure protection Disabled.
-- Enabled: The TCP settings that have TCP memory pressure protection Enabled.
-- Default: The TCP settings that have TCP memory pressure protection set to Default.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-MinRtoMs<UInt32[]>

Gets TCP setting information only for a specific MinRtoMs. MinRtoMs determines the TCP retransmission timeout, in milliseconds. The acceptable values for this parameter are:  20 through 300.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ScalingHeuristics<ScalingHeuristics[]>

Gets TCP setting information only for a specific ScalingHeuristics setting. The acceptable values for this parameter are: 
-- Disabled: The TCP settings that have ScalingHeuristics disabled.
-- Enabled: The TCP settings that have ScalingHeuristics enabled.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-SettingName<String[]>

Gets TCP setting information for a specific SettingName. Each SettingName determines the TCP settings applied to each TCP connection. The acceptable values for this parameter are: 
-- Internet: The TCP settings that are optimized for networks with higher latency and lower throughput.
-- Datacenter: The TCP settings that are optimized for networks with lower latency and higher throughput.
-- Compat: The TCP settings that are optimized for compatibility with legacy network equipment.
-- Custom: The TCP settings that are defined by the administrator.
-- Automatic: The computer uses latency, measured by TCP round trip time (RTT), to dynamically apply Internet or Datacenter settings. For low latency links, 10 milliseconds or less, the computer will apply Datacenter settings. For higher latency links, greater than 10 milliseconds, the computer will apply Internet settings.


Aliases

none

Required?

false

Position?

1

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ThrottleLimit<Int32>

Specifies the maximum number of concurrent operations that can be established to run the cmdlet. If this parameter is omitted or a value of 0 is entered, then Windows PowerShell® calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer. The throttle limit applies only to the current cmdlet, not to the session or to the computer.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Timestamps<Timestamps[]>

Controls RFC 1323 TCP timestamps. RFC 1323 timestamps can help with round trip measurement and protection against wrapped sequence numbers on high throughput links. The default value is Disabled. The acceptable values for this parameter are: 
-- Disabled: The TCP settings that have RFC 1323 timestamps disabled.
-- Enabled: The TCP settings that have the RFC 1323 timestamps enabled.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • None

Outputs

The output type is the type of the objects that the cmdlet emits.

  • Microsoft.Management.Infrastructure.CimInstance#root\StandardCimv2\MSFT_NetTCPSetting

    The Microsoft.Management.Infrastructure.CimInstance object is a wrapper class that displays Windows Management Instrumentation (WMI) objects. The path after the pound sign (#) provides the namespace and class name for the underlying WMI object.


Examples

EXAMPLE 1

This example gets information about TCP settings and configuration. Used without parameters gets all TCP settings.


PS C:\> Get-NetTCPSetting

EXAMPLE 2

This example gets information about TCP settings that are optimized for connectivity across the Internet.


PS C:\> Get-NetTCPSetting –Setting Internet

EXAMPLE 3

This example gets information about TCP settings, and displays a summary in a table view.


PS C:\> Get-NetTcpSetting | Format-Table

Related topics

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft