Set-SCNativeUplinkPortProfile

Updates a native uplink port profile.

Syntax

Set-SCNativeUplinkPortProfile [-NativeUplinkPortProfile] <NativeUplinkPortProfile>
 [-AddLogicalNetworkDefinition <LogicalNetworkDefinition[]>] [-Description <String>]
 [-EnableNetworkVirtualization <Boolean>] [-JobVariable <String>]
 [-LBFOLoadBalancingAlgorithm <NetworkAdapterLBFOLoadBalancingAlgorithm>]
 [-LBFOTeamMode <NetworkAdapterLBFOTeamMode>] [-Name <String>] [-PROTipID <Guid>]
 [-RemoveLogicalNetworkDefinition <LogicalNetworkDefinition[]>] [-RunAsynchronously]
 [-VMMServer <ServerConnection>] [<CommonParameters>]

Description

The Set-SCNativeUplinkPortProfile cmdlet updates a native uplink port profile. You can use it to add or remove a logical network definition.

Examples

Example 1: Remove a logical network definition from a native uplink port profile

PS C:\> $LogNetDefinition = Get-SCLogicalNetworkDefinition -Name "Logical Network Definition 01" 
PS C:\> Get-SCNativeUplinkPortProfile -Name "NativeUplinkPortProfile01" | Set-SCNativeUplinkPortProfile -RemoveLogicalNetworkDefinition $LogNetDefinition

The first command gets the logical network definition object named Logical Network Definition 01 and stores the object in the $LogNetDefinition variable.

The second command gets the native uplink port profile object named NativeUplinkPortProfile01 and uses the pipeline operator to pass the object to Set-SCNativeUplinikPortProfile. This removes Logical Network Definition 01 from NativeUplinkPortProfile01.

Parameters

-AddLogicalNetworkDefinition

Specifies an array of logical network definition objects that this cmdlet adds.

To get a logical network definition object, use the Get-SCLogicalNetworkDefinition cmdlet.

Type:LogicalNetworkDefinition[]
Required:False
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-Description

Specifies a description for the port profile.

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

Indicates whether network virtualization is enabled. The default value is $False.

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

Specifies a variable in which job progress is tracked and stored.

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

Specifies a load balancing and failover (LBFO) network adapter load balancing algorithm. The acceptable values for this parameter are:

- TransortPorts

  • IPAddresses
  • MACAddresses
  • HyperVPort
  • Dynamic
  • HostDefault

Type:NetworkAdapterLBFOLoadBalancingAlgorithm
Parameter Sets:TransportPorts, IPAddresses, MacAddresses, HyperVPort, Dynamic, HostDefault
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-LBFOTeamMode

Specifies a team mode for a load balancing and failover (LBFO) network adapter.

Type:NetworkAdapterLBFOTeamMode
Parameter Sets:Static, SwitchIndependent, Lacp
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

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

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

Specifies a native uplink port profile object.

Type:NativeUplinkPortProfile
Required:True
Position:0
Default value:None
Accept pipeline input:True (ByValue)
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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RemoveLogicalNetworkDefinition

Specifies an array of logical network definition objects to remove.

To get a logical network definition object, use the Get-SCLogicalNetworkDefinition cmdlet.

Type:LogicalNetworkDefinition[]
Required:False
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-RunAsynchronously

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

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

Specifies a VMM server object.

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