Set-PortGroup
SYNOPSIS
Modifies a port group.
SYNTAX
Rename (Default)
Set-PortGroup [-Unisphere] <UnisphereServer> [-ArrayId] <String> [-Id] <String> -NewId <String> [-Confirm]
[-WhatIf] [<CommonParameters>]
AddPort
Set-PortGroup [-Unisphere] <UnisphereServer> [-ArrayId] <String> [-Id] <String> -AddPortId <String[]> [-Confirm]
[-WhatIf] [<CommonParameters>]
RemovePort
Set-PortGroup [-Unisphere] <UnisphereServer> [-ArrayId] <String> [-Id] <String> -RemovePortId <String[]>
[-Confirm] [-Force] [-WhatIf] [<CommonParameters>]
DESCRIPTION
Modifies a port group ID, or adds ports to or removes ports from a port group.
EXAMPLES
Example 1
PS C:\> Set-PortGroup $unisphere 000123456789 pg1 -NewId pg2
Where $unisphere is a Unisphere server instance. Changes the port group ID from pg1 to pg2.
Example 2
PS C:\> Set-PortGroup $unisphere 000123456789 pg1 -AddPortId FA-1D:8,FA-2D:8
Where $unisphere is a Unisphere server instance. Adds the ports FA-1D:8 and FA-2D:8 to the Fibre port group pg1.
Example 3
PS C:\> Set-PortGroup $unisphere 000123456789 pg1 -RemovePortId SE-1E:000,SE-2E:000
Where $unisphere is a Unisphere server instance. Removes the ports SE-1E:000 and SE-2E:000 from the iSCSI port group pg1.
PARAMETERS
-Unisphere
The Unisphere server instance.
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
The port group ID.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 2
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-NewId
The new ID.
Type: String
Parameter Sets: Rename
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AddPortId
The port IDs to add.
Type: String[]
Parameter Sets: AddPort
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-RemovePortId
The port IDs to remove.
Type: String[]
Parameter Sets: RemovePort
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
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
-Force
Skips confirmation before removing the ports.
Type: SwitchParameter
Parameter Sets: RemovePort
Aliases:
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.