New-VolumeGroupClone
SYNOPSIS
Creates a clone of a volume group.
SYNTAX
ByVolumeGroupName (Default)
New-VolumeGroupClone [-Cluster] <Cluster> [-Name] <String> -VolumeGroupName <String> [-Description <String>]
[-ProtectionPolicy <String>] [-ReplicationDestination] [-Confirm] [-WhatIf] [<CommonParameters>]
BySnapshotNameAndVolumeGroupName
New-VolumeGroupClone [-Cluster] <Cluster> [-Name] <String> -VolumeGroupName <String> -SnapshotName <String>
[-Description <String>] [-ProtectionPolicy <String>] [-ReplicationDestination] [-Confirm] [-WhatIf] [<CommonParameters>]
BySnapshotNameAndVolumeGroupId
New-VolumeGroupClone [-Cluster] <Cluster> [-Name] <String> -VolumeGroupId <String> -SnapshotName <String>
[-Description <String>] [-ProtectionPolicy <String>] [-ReplicationDestination] [-Confirm] [-WhatIf] [<CommonParameters>]
ByVolumeGroupId
New-VolumeGroupClone [-Cluster] <Cluster> [-Name] <String> -VolumeGroupId <String> [-Description <String>]
[-ProtectionPolicy <String>] [-ReplicationDestination] [-Confirm] [-WhatIf] [<CommonParameters>]
BySnapshotId
New-VolumeGroupClone [-Cluster] <Cluster> [-Name] <String> -SnapshotId <String> [-Description <String>]
[-ProtectionPolicy <String>] [-ReplicationDestination] [-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
Creates a clone of a volume group or from a snapshot of a volume group. Options are available to specify the source volume group by name or by Id as well as by specifying the snapshot name when creating clones from snapshots. You can also optionally assign a protection policy to the new volume group and indicate if the volume group is a replication destination.
EXAMPLES
Example 1
PS C:\> New-VolumeGroupClone -Cluster $cluster -Name clonevolgrp -VolumeGroupName volgroup
Where $cluster is a PowerStore cluster instance. Creates a clone of volume group volgroup.
Example 2
PS C:\> New-VolumeGroupClone -Cluster $cluster -Name clonevolgrp -VolumeGroupName volgroup -SnapshotName volgroup-snapshot
Where $cluster is a PowerStore cluster instance. Creates a clone from snapshot volgroup-snapshot where volgroup-snapshot is a snapshot of volume group volgroup.
PARAMETERS
-Cluster
A PowerStore cluster instance.
Type: Cluster
Parameter Sets: (All)
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Name of new volume group.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-VolumeGroupName
Volume group name.
Type: String
Parameter Sets: ByVolumeGroupName, BySnapshotNameAndVolumeGroupName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-VolumeGroupId
Volume group Id.
Type: String
Parameter Sets: BySnapshotNameAndVolumeGroupId, ByVolumeGroupId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SnapshotName
Snapshot name when creating a clone from a snapshot.
Type: String
Parameter Sets: BySnapshotNameAndVolumeGroupName, BySnapshotNameAndVolumeGroupId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SnapshotId
Snapshot Id when creating a clone from a snapshot.
Type: String
Parameter Sets: BySnapshotId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-Description
Optional description for the clone.
Type: String
Parameter Sets: (All)
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)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ReplicationDestination
Indicate whether the clone volume group is a destination of a replication session.
Type: SwitchParameter
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.