Set-SCNativeUplinkPortProfile

Updates a native uplink port profile.

Syntax

Set-SCNativeUplinkPortProfile
   [-AddLogicalNetworkDefinition <LogicalNetworkDefinition[]>]
   [-RemoveLogicalNetworkDefinition <LogicalNetworkDefinition[]>]
   [-VMMServer <ServerConnection>]
   [-NativeUplinkPortProfile] <NativeUplinkPortProfile>
   [-Name <String>]
   [-Description <String>]
   [-EnableNetworkVirtualization <Boolean>]
   [-LBFOLoadBalancingAlgorithm <NetworkAdapterLBFOLoadBalancingAlgorithm>]
   [-LBFOTeamMode <NetworkAdapterLBFOTeamMode>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<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.

Required Parameters

-NativeUplinkPortProfile

Specifies a native uplink port profile object.

Type:NativeUplinkPortProfile
Position:0
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False

Optional 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[]
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-Description

Specifies a description for the port profile.

Type:String
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
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
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
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
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
Position:Named
Default value:None
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
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[]
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
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-VMMServer

Specifies a VMM server object.

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