New-Volume
SYNOPSIS
Adds new volumes to a storage group.
SYNTAX
New-Volume [-Unisphere] <UnisphereServer> [-ArrayId] <String> -StorageGroupId <String> -Size <Int64>
[-Unit <String>] [-Count <Int64>] [-IdentifierChoice <String>] [-IdentifierName <String>]
[-AppendNumber <Int32>] [-EnableMobilityId] [-RemoteArray1Id <String>] [-RemoteArray1StorageGroup <String[]>]
[-RemoteArray2Id <String>] [-RemoteArray2StorageGroup <String[]>] [-SrdfForce <Boolean>] [-Confirm] [-WhatIf]
[<CommonParameters>]
DESCRIPTION
Creates one or more volumes and adds to a storage group. Optionally adds volume identifiers. New volumes can also be added to the remote storage groups.
EXAMPLES
Example 1
PS C:\> New-Volume -Unisphere $unisphere -ArrayId 000123456789 -StorageGroupId sg1 -Size 1GB
Where $unisphere is a Unisphere server instance. This is the simplest option to create a single volume and add to the storage group, sg1.
Example 2
PS C:\> New-Volume -Unisphere $unisphere -ArrayId 000123456789 -StorageGroupId sg1 -Size 1 -Unit GB -Count 5 -IdentifierChoice NamePlusAppendNumber -IdentifierName sg1vol -AppendNumber 201
Where $unisphere is a Unisphere server instance. Creates five 1GB volumes and adds volume identifiers sg1vol201 to sg1vol205 in sequence.
Example 3
PS C:\> New-Volume -Unisphere $unisphere -ArrayId 000123456789 -StorageGroupId sg1 -Size 1 -Unit GB -Count 5 -RemoteArray1Id 000123456790 -RemoteArray1StorageGroup sg1dr
Where $unisphere is a Unisphere server instance. Adds five new volumes to the local storage group as well as to the remote storage group sg1dr.
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
-StorageGroupId
The storage group ID.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-Size
The size of the volume. If -Unit is not specified then the size is interpreted as bytes and will be rounded down to the nearest MB.
Type: Int64
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Unit
The size unit. If not specified then the value of the -Size parameter is assumed to be in bytes.
Type: String
Parameter Sets: (All)
Aliases:
Accepted values: CYL, MB, GB, TB
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Count
The number of volumes to create.
Type: Int64
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IdentifierChoice
Specify if and what format is used to add a volume identifier to each volume.
Type: String
Parameter Sets: (All)
Aliases:
Accepted values: None, Name, NamePlusVolumeId, NamePlusAppendNumber
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IdentifierName
The base name to be used in the volume identifier for each volume.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AppendNumber
Number to append to each volume identifier. Defaults to 0 if not specified when NamePlusAppendNumber is used as the identifier choice.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableMobilityId
Enable mobility.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoteArray1Id
The ID of the first remote PowerMax array.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoteArray1StorageGroup
The storage groups on the first remote PowerMax array to add volumes to.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoteArray2Id
The ID of the second remote PowerMax array.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoteArray2StorageGroup
The storage groups on the second remote PowerMax array to add volumes to.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SrdfForce
Whether force flag is enabled or disabled.
Type: Boolean
Parameter Sets: (All)
Aliases:
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.