New-PortGroup
SYNOPSIS
Creates a port group.
SYNTAX
New-PortGroup [-Unisphere] <UnisphereServer> [-ArrayId] <String> [-Id] <String> [-PortId <String[]>] [-Protocol {SCSIFC | iSCSI |NVMeFC | NVMeTCP}]
[-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
Creates a port group and optionally adds a list of ports to the port group.
EXAMPLES
Example 1
PS C:\> New-PortGroup -Unisphere $unisphere -ArrayId 000123456789 -Id pg1
Where $unisphere is a Unisphere server instance. Creates an empty port group named pg1.
Example 2
PS C:\> New-PortGroup -Unisphere $unisphere -ArrayId 000123456789 -Id pg1 -PortId FA-1D:8,FA-2D:8
Where $unisphere is a Unisphere server instance. Creates a port group named pg1 with Fibre ports FA-1D:8 and FA-2D:8.
Example 3
PS C:\> New-PortGroup -Unisphere $unisphere -ArrayId 000123456789 -Id pg1 -PortId SE-1E:000,SE-2E:000
Where $unisphere is a Unisphere server instance. Creates a port group named pg1 with iSCSI ports SE-1E:000 and SE-2E:000.
Example 3
PS C:\> New-PortGroup -Unisphere $unisphere -ArrayId 000123456789 -Id pg1 -Protocol SCSIFC
Where $unisphere is a Unisphere server instance. Creates an empty port group named pg1 with protocol SCSIFC. Protocol is a mandatory parameter when creating a port group on V4 PowerMax arrays.
PARAMETERS
-Unisphere
The Unisphere server object.
Type: UnisphereServer
Parameter Sets: (All)
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-ArrayId
The PowerMax array ID.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-Id
Port group ID.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PortId
A list of port IDs.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Protocol
The protocol type for the port group to contain. Optional for creating even empty port groups on PowerMax V3 arrays. Mandatory for creating any port group on a PowerMax V4 array.
Type: String
Parameter Sets: (All)
Aliases:
Accepted values: SCSIFC, iSCSI, NVMeFC, NVMeTCP
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.