Share via

New-SCUplinkPortProfileSet

  • Reference
Module:
VirtualMachineManager

Creates an uplink port profile set.

Syntax

New-SCUplinkPortProfileSet
   -LogicalSwitch <LogicalSwitch>
   [-NativeUplinkPortProfile <NativeUplinkPortProfile>]
   [-ExtensionUplinkPortProfiles <ExtensionUplinkPortProfile[]>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [[-Description] <String>]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

The New-SCUplinkPortProfileSet cmdlet creates an uplink port profile set.

You must provide a logical switch when you create an uplink port profile set. To obtain a logical switch object, use the Get-SCLogicalSwitch cmdlet.

Examples

PS C:\> $LogicalSwitch = Get-SCLogicalSwitch -Name "LogicalSwitch01"
PS C:\> $NativeUplinkPortProfile = Get-SCNativeUplinkPortProfile -Name "NativeUplinkPortProfile01"
PS C:\> New-SCUplinkPortProfileSet -Name "UplinkPortProfileSet01" -LogicalSwitch $LogicalSwitch -NativeUplinkPortProfile $NativeUplinkPortProfile

The first command gets the logical switch named LogicalSwitch01, and then stores that object in the $LogicalSwitch variable.

The second command gets the native uplink port profile named NativeUplinkPortProfile01, and stores that object in the $NativeUplinkPortProfile variable.

The last command creates an uplink port profile set named UplinkPortProfileSet01 by using LogicalSwitch01 and NativeUplinkPortProfile01.

Parameters

-Description

Specifies a description for the profile set.

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

-ExtensionUplinkPortProfiles

Specifies an array of extension uplink port profiles. To obtain an extension uplink port profile, use the Get-SCExtensionUplinkPortProfile cmdlet.

Type:ExtensionUplinkPortProfile[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-JobGroup

Specifies an identifier for a series of commands that runs as a set just before the final command that includes the same job group identifier runs.

Type:Guid
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LogicalSwitch

Specifies a logical switch that this cmdlet includes in the uplink port profile set. To obtain a logical switch object, use the Get-SCLogicalSwitch cmdlet.

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

-Name

Specifies the name of a Virtual Machine Manager (VMM) object in which this cmdlet creates an uplink port profile set.

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

-NativeUplinkPortProfile

Specifies a native uplink port profile that this cmdlet assigns to the new uplink port profile set.

Type:NativeUplinkPortProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:True
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

-VMMServer

Specifies a VMM server on which this cmdlet creates an uplink port profile set.

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