New-VolumeClone
SYNOPSIS
Creates a volume clone on the PowerStore cluster.
SYNTAX
ByVolumeName (Default)
New-VolumeClone [-Cluster] <Cluster> [-Name] <String> -VolumeName <String> [-Description <String>]
[-PerformancePolicy {Low | Medium | High}] [-ProtectionPolicy <String>] [-Host <String>]
[-HostGroup <String>] [-Lun <Int32>] [Confirm] [-WhatIf] [<CommonParameters>]
BySnapshotNameAndVolumeName
New-VolumeClone [-Cluster] <Cluster> [-Name] <String> -VolumeName <String> -SnapshotName <String>
[-Description <String>] [-PerformancePolicy {Low | Medium | High}] [-ProtectionPolicy <String>]
[-Host <String>] [-HostGroup <String>] [-Lun <Int32>] [Confirm] [-WhatIf] [<CommonParameters>]
BySnapshotNameAndVolumeId
New-VolumeClone [-Cluster] <Cluster> [-Name] <String> -VolumeId <String> -SnapshotName <String>
[-Description <String>] [-PerformancePolicy {Low | Medium | High}] [-ProtectionPolicy <String>]
[-Host <String>] [-HostGroup <String>] [-Lun <Int32>] [Confirm] [-WhatIf] [<CommonParameters>]
ByVolumeId
New-VolumeClone [-Cluster] <Cluster> [-Name] <String> -VolumeId <String> [-Description <String>]
[-PerformancePolicy {Low | Medium | High}] [-ProtectionPolicy <String>] [-Host <String>]
[-HostGroup <String>] [-Lun <Int32>] [Confirm] [-WhatIf] [<CommonParameters>]
BySnapshotId
New-VolumeClone [-Cluster] <Cluster> [-Name] <String> -SnapshotId <String> [-Description <String>]
[-PerformancePolicy {Low | Medium | High}] [-ProtectionPolicy <String>] [-Host <String>]
[-HostGroup <String>] [-Lun <Int32>] [Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
Creates a volume clone of the specified volume or snapshot on the PowerStore cluster. Optionally assign a performance policy, protection policy and host/host group mapping.
EXAMPLES
Example 1
PS C:\> New-VolumeClone -Cluster $cluster -Name clone1 -VolumeName volume1
Where $cluster is a PowerStore cluster instance. Creates new clone with name clone1 of volume with name volume1 and MEDIUM as default performance policy.
Example 2
PS C:\> New-VolumeClone -Cluster $cluster -Name clone1 -VolumeName volume1 -PerformancePolicy High -Host host1
Where $cluster is a PowerStore cluster instance. Creates new clone with name clone1 of volume with name volume1 and HIGH as performance policy. Also the clone will be mapped to Host with name host1.
Example 3
PS C:\> New-VolumeClone -Cluster $cluster -Name clone1 -SnapshotName snapshot1 -VolumeName volume1
Where $cluster is a PowerStore cluster instance and snapshot1 is a snapshot of volume with name volume1. Creates new clone with name clone1 of snapshot with name snapshot1 and MEDIUM as default performance policy.
Example 4
PS C:\> New-VolumeClone -Cluster $cluster -Name clone1 -VolumeName volume1 -SnapshotName snapshot1 -PerformancePolicy High -Host host1
Where $cluster is a PowerStore cluster instance and snapshot1 is a snapshot of volume with name volume1. Creates new clone with name clone1 of snapshot with name snapshot1 and HIGH as performance policy. Also the clone will be mapped to Host with name host1.
Example 5
PS C:\> New-VolumeClone -Cluster $cluster -Name clone1 -VolumeId uuid1 -SnapshotName snapshot1 -PerformancePolicy High -Host host1
Where $cluster is a PowerStore cluster instance and snapshot1 is a snapshot of volume with Id uuid1. Creates new clone with name clone1 of snapshot with name snapshot1 and HIGH as performance policy. Also the clone will be mapped to Host with name host1.
Example 6
PS C:\> New-VolumeClone -Cluster $cluster -Name clone1 -VolumeId uuid1 -PerformancePolicy Low -HostGroup hostgroup1
Where $cluster is a PowerStore cluster instance. Creates new clone with name clone1 of a volume with Id uuid1 and Low as performance policy. Also the clone will be mapped to Host group with name hostgroup1.
Example 7
PS C:\> New-VolumeClone -Cluster $cluster -Name clone1 -SnapshotId uuid1 -PerformancePolicy Low -HostGroup hostgroup1
Where $cluster is a PowerStore cluster instance. Creates new clone with name clone1 of a snapshot with Id uuid1 and Low as performance policy. Also the clone will be mapped to Host group with name hostgroup1.
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
Clone name.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-VolumeName
Volume name.
Type: String
Parameter Sets: ByVolumeName, BySnapshotNameAndVolumeName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-VolumeId
Volume Id.
Type: String
Parameter Sets: BySnapshotNameAndVolumeId, ByVolumeId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SnapshotName
Snapshot name.
Type: String
Parameter Sets: BySnapshotNameAndVolumeName, BySnapshotNameAndVolumeId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SnapshotId
Snapshot Id.
Type: String
Parameter Sets: BySnapshotId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-Description
Clone description.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PerformancePolicy
Performance policy name.
Type: String
Parameter Sets: (All)
Aliases:
Accepted values: Low, Medium, High
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
-Host
Host name.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-HostGroup
Host group name.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Lun
Logical unit number.
Type: Int32
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.