New-SCUplinkPortProfileSet

Creates an uplink port profile set.

Syntax

New-SCUplinkPortProfileSet [-Name] <String> [[-Description] <String>]
 [-ExtensionUplinkPortProfiles <ExtensionUplinkPortProfile[]>] [-JobGroup <Guid>] [-JobVariable <String>]
 -LogicalSwitch <LogicalSwitch> [-NativeUplinkPortProfile <NativeUplinkPortProfile>] [-PROTipID <Guid>]
 [-RunAsynchronously] [-VMMServer <ServerConnection>] [<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

Example 1: Create an uplink port profile set

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
Required:False
Position:1
Default value:None
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[]
Required:False
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
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
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
-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
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
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
Required:True
Position:0
Default value:None
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
Required:False
Position:Named
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
-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 on which this cmdlet creates an uplink port profile set.

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