Edit

Share via

New-NetIntentSwitchConfigurationOverrides

Module:
NetworkATC Module

Creates a new instance of virtual switch configuration overrides which can be used to supply granular values to Set-NetIntent.

Syntax

Default (Default) 

New-NetIntentSwitchConfigurationOverrides
    [-EnableSoftwareRsc <Boolean>]
    [-DefaultQueueVrssMaxQueuePairs <UInt32>]
    [-DefaultQueueVrssMinQueuePairs <UInt32>]
    [-DefaultQueueVrssQueueSchedulingMode <UInt32>]
    [-EnableIov <Boolean>]
    [-EnableEmbeddedTeaming <Boolean>]
    [-LoadBalancingAlgorithm <String>]
    [<CommonParameters>]

Description

The New-NetIntentSwitchConfigurationOverrides cmdlet creates a new instance of a virtual switch configuration override that allows you to provide specific configuration values for network intent settings.

Examples

Example 1

$params = @{
    DefaultQueueVrssMaxQueuePairs  = 16
    EnableSoftwareRsc              = $true
    EnableIov                      = $false
}
New-NetIntentSwitchConfigurationOverrides @params

This example creates a new switch configuration override with the maximum number of Vrss queue pairs to 16 while enabling Software RSC and disabling IOV.

Parameters

-DefaultQueueVrssMaxQueuePairs

Specifies the maximum number of Virtual RSS (Vrss) queue pairs to be used by default. This parameter can help optimize network performance by balancing the load across multiple CPU cores.

Parameter properties

Type:UInt32
Default value:0
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DefaultQueueVrssMinQueuePairs

Specifies the minimum number of Virtual RSS (Vrss) queue pairs to be used by default. Setting this can ensure a minimum level of resource allocation for network traffic processing.

Parameter properties

Type:UInt32
Default value:0
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DefaultQueueVrssQueueSchedulingMode

Defines the scheduling mode for Virtual RSS (Vrss) queues. This parameter can be used to configure how Virtual RSS queues are scheduled for processing network traffic.

Parameter properties

Type:UInt32
Default value:0
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-EnableEmbeddedTeaming

Specifies whether Embedded Teaming is enabled. Embedded Teaming allows multiple network adapters to be grouped together for redundancy and load balancing.

Parameter properties

Type:Boolean
Default value:False
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-EnableIov

Indicates whether Input-Output Virtualization (IOV) is enabled. IOV allows VMs to have direct access to hardware I/O resources, potentially improving performance.

Parameter properties

Type:Boolean
Default value:False
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-EnableSoftwareRsc

Indicates whether Software Receive Side Coalescing (RSC) is enabled. When enabled, this feature can improve network performance by reducing the CPU load associated with processing received packets.

Parameter properties

Type:Boolean
Default value:False
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-LoadBalancingAlgorithm

Determines the load balancing algorithm used for distributing network traffic. This parameter can be used to select a specific algorithm that best suits the network environment.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.