NAME

Add-DcsVirtualDiskFromVirtualDisk

SYNOPSIS

Creates a new virtual disk with the same properties and settings as an existing virtual disk.

SYNTAX

Add-DcsVirtualDiskFromVirtualDisk   -VirtualDisk <Object>   [ -Name <String> ]   [ -Description <String> ]   [ -Count <Int32> ]   [ -AutoCreate]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Add-DcsVirtualDiskFromVirtualDisk   -VirtualDisk <Object>   [ -Name <String> ]   [ -Description <String> ]   [ -Count <Int32> ]   [ -CopyMappings]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Creates a new virtual disk with the same properties and settings as an existing virtual disk. The existing virtual disk will be used as a "model" to create the new virtual disk. The new virtual disk will be created from the same storage sources. If optional parameters are not included, one virtual disk will be created with a default name and mirror paths will be auto-selected by the software.

PARAMETERS

-VirtualDisk<Object>
VirtualDiskData object, name, or ID that identifies the virtual disk to use as a model.

Required: true
Position: named
Default value:
Accept pipeline input: true (ByValue)
Accept wildcard characters: false

-Name<String>
Name of the virtual disk to create. If specified and multiple virtual disks will be created, the virtual disks created will begin with the designated name and have a number appended to the end of the name. Subsequent names will have the number incremented.If not specified a default name will be assigned. The default name will consist of "Virtual disk" with the next available number assigned. For instance, if no other virtual disks have default names assigned, the virtual disk will be named "Virtual disk 1". If creating multiple virtual disks, subsequent virtual disks created will be named "virtual disk 2" and so on.

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-Description<String>
Description of the new virtual disk.

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-Count<Int32>
The number of virtual disks to create when storage sources are from pools. If not specified, one virtual disk will be created.

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-AutoCreate<SwitchParameter>
Use this parameter to allow the software to auto-select mirror paths. Auto-selection of mirror paths is also the default behavior if neither AutoCreate or CopyMappings parameters are included in the command.

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-Connection<String>
Alias of the connection to the server group. If not specified, the default connection will be used.

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-PipelineVariable<String>

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-CopyMappings<SwitchParameter>
Use this parameter to specify that mirror paths should be identical to the virtual disk that is used as a model.

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

INPUTS

VirtualDiskData : Object that identifies and describes the virtual disk.

OUTPUTS

VirtualDiskData : Object that identifies and describes the virtual disk. One object is returned for each virtual disk created.

NOTES

Also see Get-DcsVirtualDisk.

EXAMPLES


-------------- Example 1 Creates one virtual disk with only the existing virtual disk specified. --------------
Add-DcsVirtualDiskFromVirtualDisk -VirtualDisk "Virtual disk 1"
		

The existing virtual disk named "Virtual disk 1" is used as a model to create a new virtual disk with the same properties and settings as "Virtual disk 1". No optional parameters are supplied in the command, so one virtual disk is created with a default name and mirror paths are auto-selected.

VVirtualDiskGroupId:
FirstHostId:09440587-2E02-4BAA-8CC5-162B1DF66BE8
SecondHostId:60858B8A-928F-4CF0-9FBA-A62DC4C120C7
BackupHostId:
StorageProfileId:100469DF-0BE1-40DA-874E-9F1DA5A259E3
SnapshotPoolId:
Alias:Virtual disk 5
Description:
Size:5 GiB
SectorSize:512 B
Type:MultiPathMirrored
DiskStatus:Failed
InquiryData:DataCore Virtual Disk DCS c093a0025cbf4ee28d0a64a131136618
ScsiDeviceId:{96, 3, 13, 144...}
ScsiDeviceIdString:60030D90B64BE60659BEAF27834D369C
RemovableMedia:False
WriteThrough:False
Offline:False
Disabled:False
ManualRecovery:False
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:Regular
IsServed:False
SubType:Standard
MirrorTrunkMappingEnabled:False
Sequencenumber:5358
Id:c093a0025cbf4ee28d0a64a131136618
Caption:Virtual disk 5
ExtendedCaption:Virtual disk 5 from LocalGroup1
Internal:False
   

-------------- Example 2 Creates multiple virtual disks with identical mirror paths --------------
Add-DcsVirtualDiskFromVirtualDisk -VirtualDisk "Virtual disk 1" -Name "BillingQ3" -Description "Account Billing for Q3" -Count 2 -CopyMappings
		

The existing "Virtual disk 1" is used as a model to create 3 new virtual disks. The new virtual disks will have the same properties and settings as "Virtual disk 1". The names for the new virtual disks will have a root of "BillingQ3". The description for those virtual disks will be "Account Billing for Q3". The parameter CopyMappings is included in the command to specify that the mirror paths should be identical to the paths used for "Virtual disk 1".

VirtualDiskGroupId:
FirstHostId:09440587-2E02-4BAA-8CC5-162B1DF66BE8
SecondHostId:60858B8A-928F-4CF0-9FBA-A62DC4C120C7
BackupHostId:
StorageProfileId:100469DF-0BE1-40DA-874E-9F1DA5A259E3
SnapshotPoolId:
Alias:BillingQ3
Description:Account Billing for Q3
Size:5 GiB
SectorSize:512 B
Type:MultiPathMirrored
DiskStatus:Failed
InquiryData:DataCore Virtual Disk DCS 02da20543e2b45e7ac9eb228c4adc404
ScsiDeviceId:{96, 3, 13, 144...}
ScsiDeviceIdString:60030D90E3542C07DABD4C1BC61174B4
RemovableMedia:False
WriteThrough:False
Offline:False
Disabled:False
ManualRecovery:False
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:Regular
IsServed:False
SubType:Standard
MirrorTrunkMappingEnabled:False
Sequencenumber:6121
Id:02da20543e2b45e7ac9eb228c4adc404
Caption:BillingQ3
ExtendedCaption:BillingQ3 from LocalGroup1
Internal:False
   
VirtualDiskGroupId:
FirstHostId:09440587-2E02-4BAA-8CC5-162B1DF66BE8
SecondHostId:60858B8A-928F-4CF0-9FBA-A62DC4C120C7
BackupHostId:
StorageProfileId:100469DF-0BE1-40DA-874E-9F1DA5A259E3
SnapshotPoolId:
Alias:BillingQ 4
Description:Account Billing for Q3
Size:5 GiB
SectorSize:512 B
Type:MultiPathMirrored
DiskStatus:Failed
InquiryData:DataCore Virtual Disk DCS e4b624874b5d4b42921866ac22bb5c7c
ScsiDeviceId:{96, 3, 13, 144...}
ScsiDeviceIdString:60030D9065572C0760BD8AECC71CFC58
RemovableMedia:False
WriteThrough:False
Offline:False
Disabled:False
ManualRecovery:False
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:Regular
IsServed:False
SubType:Standard
MirrorTrunkMappingEnabled:False
Sequencenumber:6216
Id:e4b624874b5d4b42921866ac22bb5c7c
Caption:BillingQ 4
ExtendedCaption:BillingQ 4 from LocalGroup1
Internal:False