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
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 |
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 |