Share via

Set-SCVirtualNetworkAdapterNativePortProfile

  • Reference
Module:
VirtualMachineManager

Sets the properties of a virtual network adapter native port profile.

Syntax

Set-SCVirtualNetworkAdapterNativePortProfile
   [-Description <String>]
   [-VMMServer <ServerConnection>]
   [-VirtualNetworkAdapterNativePortProfile] <VirtualNetworkAdapterNativePortProfile>
   [-Name <String>]
   [-AllowTeaming <Boolean>]
   [-AllowMacAddressSpoofing <Boolean>]
   [-AllowIeeePriorityTagging <Boolean>]
   [-EnableDhcpGuard <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableRouterGuard <Boolean>]
   [-MinimumBandwidthWeight <Int32>]
   [-MinimumBandwidthAbsolute <Int32>]
   [-MaximumBandwidth <Int32>]
   [-EnableVmq <Boolean>]
   [-EnableIPsecOffload <Boolean>]
   [-EnableIov <Boolean>]
   [-EnableVrss <Boolean>]
   [-EnableRdma <Boolean>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

The Set-SCVirtualNetworkAdapterNativePortProfile cmdlet updates the properties of a virtual network adapter native port profile.

Examples

Example 1: Enable VMQ for a virtual network adapter native port profile

PS C:\> Get-SCVirtualNetworkAdapterNativePortProfile -Name "VirtualNetworkAdapterNativePortProf01" | Set-SCVirtualNetworkAdapterNativePortProfile -EnableVMQ $True

This command gets the virtual network adapter native port profile object named VirtualNetworkAdapterNativePortProf01 and uses the pipeline operator to pass the object to Set-SCVirtualNetworkAdapterNativePortProfile, which sets the EnableVMQ property to True for the virtual network adapter native port profile object.

Example 2: Set the maximum and minimum bandwidth for a virtual network adapter native port profile

PS C:\> Get-SCVirtualNetworkAdapterNativePortProfile -Name "VirtualNetworkAdapterNativePortProf01" | Set-SCVirtualNetworkAdapterNativePortProfile -MaximumBandwidth "100" -MinimumBandwidthAbsolute "25"

This command gets the virtual network adapter native port profile object named VirtualNetworkAdapterNativePortProf01 and uses the pipeline operator to pass the object to Set-SCVirtualNetworkAdapterNativePortProfile, which sets the maximum bandwidth for the object to 100 and the minimum bandwidth to 25.

Parameters

-AllowIeeePriorityTagging

Indicates whether outgoing packets from the virtual machine adapter are allowed to be tagged with IEEE 802.1p priority. When set to $False, the priority value in the packet is reset to zero.

The default value is $False.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowMacAddressSpoofing

Indicates whether media access control (MAC) address spoofing is enabled. MAC address spoofing allows virtual machines to change the source MAC address in outgoing packets to one that is not assigned to them.

The default value is $False.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowTeaming

Indicates whether guest teaming is allowed. Guest teaming allows the virtual network adapter to be teamed with other network adapters that are connected to the same switch.

The default value is $False.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Specifies a description for the port profile.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableDhcpGuard

Indicates whether Dynamic Host Configuration Protocol (DHCP) guard is enabled. DHCP guard drops DHCP server messages from unauthorized virtual machines pretending to be DHCP servers.

The default value is $False.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableGuestIPNetworkVirtualizationUpdates

Indicates whether IP network virtualization updates by a guest is enabled.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableIov

Indicates whether single-root I/O virtualization (SR-IOV) is enabled.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableIPsecOffload

Indicates whether IPsec task offloading is enabled. When sufficient hardware resources are not available, the security associations are not offloaded and are handled in software by the guest operating system. Support from a physical network adapter and the guest operating system is required to offload IPsec tasks.

The default value is $False.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableRdma

The default value is $False.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableRouterGuard

Indicates whether router advertisement and redirection messages from authorized virtual machines pretending to be routers are dropped.

The default value is $False.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableVmq

Indicates whether virtual machine queue (VMQ) is enabled. A physical network adapter is required to enable VMQ.

The default value is $False.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableVrss

Enables virtual receive-side scaling for this port profile.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Specifies that job progress is tracked and stored in the variable named by this parameter.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaximumBandwidth

Specifies the maximum bandwidth, in Megabits per second (Mbps), for a virtual network adapter port profile.

The default value is 0.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinimumBandwidthAbsolute

Specifies the minimum bandwidth, in Megabits per second (Mbps), for a virtual network adapter port profile.

The default value is 0.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinimumBandwidthWeight

Specifies the minimum bandwidth relative to how much bandwidth the virtual network adapter intends to use compared to other virtual network adapters connected to the same switch. Valid values are 0 to 100.

The default value is 0.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifies the name of a Virtual Machine Manager (VMM) object.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Specifies the ID of the Performance and Resource Optimization tip (PRO tip) that triggered this action. This parameter lets you audit PRO tips.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Indicates that the job runs asynchronously so that control returns to the command shell immediately.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VirtualNetworkAdapterNativePortProfile

Specifies a virtual network adapter native port profile object.

To obtain a virtual network adapter native port profile object, use the Get-SCVirtualNetworkAdapterNativePortProfile cmdlet.

Type:VirtualNetworkAdapterNativePortProfile
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMMServer

Specifies a VMM server object.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False