Export (0) Print
Expand All
Expand Minimize

Set-SCVirtualNetworkAdapterNativePortProfile

Updated: April 29, 2014

Applies To: System Center 2012 R2 Virtual Machine Manager

Set-SCVirtualNetworkAdapterNativePortProfile

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

Syntax

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




Detailed Description

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

Parameters

-AllowIeeePriorityTagging<Boolean>

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-AllowMacAddressSpoofing<Boolean>

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-AllowTeaming<Boolean>

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Description<String>

States a description for the specified object.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-EnableDhcpGuard<Boolean>

Indicates whether DHCP guard is enabled. DHCP guard drops DHCP server messages from unauthorized virtual machines pretending to be DHCP servers.

The default value is $False.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-EnableGuestIPNetworkVirtualizationUpdates<Boolean>

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-EnableIov<Boolean>

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-EnableIPsecOffload<Boolean>

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.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-EnableRouterGuard<Boolean>

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

The default value is $False.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-EnableVmq<Boolean>

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

The default value is $False.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-JobVariable<String>

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-MaximumBandwidth<Int32>

Specifies, in megabits per second (Mbps), the maximum bandwidth for a virtual network adapter port profile. The default value is 0.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-MinimumBandwidthAbsolute<Int32>

Specifies, in megabits per second (Mbps), the minimum bandwidth for a virtual network adapter port profile. The default value is 0.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-MinimumBandwidthWeight<Int32>

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.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Name<String>

Specifies the name of a VMM object.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-PROTipID<Guid>

Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-RunAsynchronously

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

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


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-VMMServer<ServerConnection>

Specifies a VMM server object.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

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.

Outputs

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

Examples

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

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


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

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

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


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

Related topics

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