Share via


New-SCVirtualNetworkAdapterNativePortProfile

Creates a virtual network adapter native port profile.

Syntax

Default (Default)

New-SCVirtualNetworkAdapterNativePortProfile
    [-Description <String>]
    [-VMMServer <ServerConnection>]
    [-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 New-SCVirtualNetworkAdapterNativePortProfile cmdlet creates a network adapter native port profile.

Examples

Example 1: Create a virtual network adapter native port profile

PS C:\> New-SCVirtualNetworkAdapterNativePortProfile -Name "VirtualNetworkAdapterNativePortProf01" -AllowMacAddressSpoofing $True

This command creates a virtual network adapter native port profile named VirtualNetworkAdapterNativePortProf01 and allows MAC address spoofing.

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.

Parameter properties

Type:Boolean
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

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

Parameter properties

Type:Boolean
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

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

Parameter properties

Type:Boolean
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

-Description

Specifies a description for the port profile.

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

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

Parameter properties

Type:Boolean
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

-EnableGuestIPNetworkVirtualizationUpdates

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

Parameter properties

Type:Boolean
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

-EnableIov

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

Parameter properties

Type:Boolean
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

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

Parameter properties

Type:Boolean
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

-EnableRdma

The default value is $False.

Parameter properties

Type:Boolean
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

-EnableRouterGuard

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

The default value is $False.

Parameter properties

Type:Boolean
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

-EnableVmq

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

The default value is $False.

Parameter properties

Type:Boolean
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

-EnableVrss

Indicates whether to enable virtual receive-side scaling for this port profile.

Parameter properties

Type:Boolean
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

-JobVariable

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

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

-MaximumBandwidth

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

The default value is 0.

Parameter properties

Type:Int32
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

-MinimumBandwidthAbsolute

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

The default value is 0.

Parameter properties

Type:Int32
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

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

Parameter properties

Type:Int32
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

-Name

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

Parameter properties

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

Parameter sets

(All)
Position:0
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:Guid
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

-RunAsynchronously

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

Parameter properties

Type:SwitchParameter
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

-VMMServer

Specifies a VMM server object.

Parameter properties

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

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:True
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.