New-SCUplinkPortProfileSet
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
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 $NativeUplinkPortProfileThe 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 |