COMMAND EVERYTHING.

Set-NetTCPSetting

Modifies a TCP setting.

Last verified: 2026-10-26

Microsoft NetTCPIP reference: Modifies a TCP setting. The syntax and selected example below are adapted from the pinned Windows Server 2025 reference. Module availability, target configuration and delegated permissions determine whether it can run in your environment. Documentation and parameter text: Microsoft, CC BY 4.0; formatting adapted by Cmdlet World. No execution testing is claimed.

Set-NetTCPSetting [[-SettingName] <String[]>] [-MinRtoMs <UInt32>] [-InitialCongestionWindowMss <UInt32>]
 [-CongestionProvider <CongestionProvider>] [-CwndRestart <CwndRestart>] [-DelayedAckTimeoutMs <UInt32>]
 [-DelayedAckFrequency <Byte>] [-MemoryPressureProtection <MemoryPressureProtection>]
 [-AutoTuningLevelLocal <AutoTuningLevelLocal>] [-EcnCapability <EcnCapability>] [-Timestamps <Timestamps>]
 [-InitialRtoMs <UInt32>] [-ScalingHeuristics <ScalingHeuristics>] [-DynamicPortRangeStartPort <UInt16>]
 [-DynamicPortRangeNumberOfPorts <UInt16>] [-AutomaticUseCustom <AutomaticUseCustom>]
 [-NonSackRttResiliency <NonSackRttResiliency>] [-ForceWS <ForceWS>] [-MaxSynRetransmissions <Byte>]
 [-AutoReusePortRangeStartPort <UInt16>] [-AutoReusePortRangeNumberOfPorts <UInt16>]
 [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf] [-Confirm]
 [<CommonParameters>]

Required permissions

Use an account with the target resource permissions documented for Set-NetTCPSetting. Modifying administrative cmdlets may require elevation or delegated administration. This catalog does not assert that ordinary users can execute the command.

Supported environments

Windows / NetTCPIP · Windows Server 2025 documentation; feature/module prerequisites apply

Parameters

-AsJob

Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to complete.

-AutoReusePortRangeNumberOfPorts

Specifies the number of ports for the auto-reuse port range, which is a port range used for local ephemeral port selection by outbound TCP connections for which either SO_REUSE_UNICASTPORT has been set on the socket, or for which connect() has been called without calling bind() on the socket. If you specify 0, the auto-reuse feature is disabled and ephemeral ports are drawn instead from the dynamic port range as specified by *DynamicPortRangeStartPort* and *DynamicPortRangeNumberOfPorts*, even if SO_REUSE_UNICASTPORT is set on a socket.

-AutoReusePortRangeStartPort

Specifies the starting port for the auto-reuse port range. This parameter sets the starting port to send and receive TCP traffic, which is a port range used for local ephemeral port selection by outbound TCP connections for which either SO_REUSE_UNICASTPORT has been set on the socket, or for which connect() has been called without calling bind() on the socket. If you specify 0, the auto-reuse feature is disabled and ephemeral ports are drawn instead from the dynamic port range as specified by *DynamicPortRangeStartPort* and *DynamicPortRangeNumberOfPorts*, even if SO_REUSE_UNICASTPORT is set on a socket.

-AutoTuningLevelLocal

Specifies a TCP auto-tuning level for the host computer. TCP auto-tuning can improve throughput on high throughput, high latency networks. The acceptable values for this parameter are: - Disabled. Sets the TCP receive window to the default value. - HighlyRestricted. Sets the TCP receive window to grow beyond the default value, but very conservatively. - Restricted. Sets the TCP receive window to grow beyond the default value, but less conservatively than HighlyRestricted. - Normal. Sets the TCP receive window to grow to accommodate almost all scenarios. - Experimental. Sets the TCP receive window to grow to accommodate extreme scenarios.

-AutomaticUseCustom

Specifies whether the automatic profile assigns a custom template, either Datacenter Custom or Internet Custom, to a connection. The acceptable values for this parameter are: - Enabled - Disabled

-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.

-Confirm

Prompts you for confirmation before running the cmdlet.

-CongestionProvider

Specifies the congestion provider property that TCP uses. The acceptable values for this parameter are: - CTCP. Compound TCP increases the receive window and amount of data sent. CTCP can improve throughput on higher latency connections. - DCTCP. Data Center TCP adjusts the TCP window based on network congestion feedback based on Explicit Congestion Notification (ECN) signaling. DCTCP may improve throughput on low latency links. - Default. Servers use DCTCP by default. Client computers use NewReno. For information about NewReno, see RFC 3782.

Prerequisites

Windows with the NetTCPIP module and the Windows feature or management tools that provide it. Confirm target connectivity and version compatibility using the linked Microsoft reference.

Security considerations

This cmdlet changes system state. Review every target and parameter in the official reference, test outside production, and prepare an appropriate backup or rollback. Do not execute the example automatically.

Examples

Set-NetTCPSetting -SettingName "InternetCustom" -CongestionProvider CTCP -InitialCongestionWindowMss 6

Sources

https://github.com/MicrosoftDocs/windows-powershell-docs/blob/b7645dd8c687139b28e845119da30ec670526507/docset/winserver2025-ps/NetTCPIP/Set-NetTCPSetting.md

https://learn.microsoft.com/powershell/module/nettcpip/set-nettcpsetting?view=windowsserver2025-ps

Explain or customize this command with AI

Related commands

Get-NetIPInterface

Add-MpPreference

Get-MpPerformanceReport

Add-DhcpServerInDC