New-VolumeGroup
SYNOPSIS
Creates a new PowerStore volume group.
SYNTAX
All (Default)
New-VolumeGroup [-Cluster] <Cluster> [-Name] <String> [-Description <String>] [-ProtectionPolicy <String>]
[-WriteOrderConsistent <Boolean>] [-Confirm] [-WhatIf] [<CommonParameters>]
ByName
New-VolumeGroup [-Cluster] <Cluster> [-Name] <String> [-VolumeName <String[]>] [-Description <String>]
[-ProtectionPolicy <String>] [-WriteOrderConsistent <Boolean>] [-Confirm] [-WhatIf] [<CommonParameters>]
ById
New-VolumeGroup [-Cluster] <Cluster> [-Name] <String> [-VolumeId <String[]>] [-Description <String>]
[-ProtectionPolicy <String>] [-WriteOrderConsistent <Boolean>] [-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
Creates a new PowerStore volume group and optionally assigns a protection policy and sets write order consistency (default true). You can add volumes by specifying either a list of volume names or volume Ids.
EXAMPLES
Example 1
PS C:\> New-VolumeGroup -Cluster $cluster -Name volgroup1 -Description 'A volume group' -WriteOrderConsistent $true -VolumeName vol1,vol2
Where $cluster is a PowerStore cluster instance. Creates a new volume group with write order consistent set to true and includes volumes vol1, and vol2.
Example 2
PS C:\> New-VolumeGroup -Cluster $cluster -Name volgroup2 -Description 'A volume group' -ProtectionPolicy Policy1 -VolumeId uuid1,uuid2
Where $cluster is a PowerStore cluster instance. Creates a new volume group with write order consistent set to the default of true and includes volumes with IDs uuid1, and uuid2. The volume group will be assigned a protection policy Policy1.
PARAMETERS
-Cluster
A PowerStore cluster instance.
Type: Cluster
Parameter Sets: All, ByName, ById
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Volume group name.
Type: String
Parameter Sets: All, ByName, ById
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-VolumeName
List of volume names.
Type: String[]
Parameter Sets: ByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-VolumeId
List of volume Ids.
Type: String[]
Parameter Sets: ById
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Description
Optional description for the volume group.
Type: String
Parameter Sets: All, ByName, ById
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ProtectionPolicy
Protection policy name.
Type: String
Parameter Sets: All, ByName, ById
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WriteOrderConsistent
Specify $true or $false to indicate if write order consistency is required. Default is $true.
Type: Boolean
Parameter Sets: All, ByName, ById
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: False
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: False
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.