NAME

Replace-DcsVirtualDiskSource

SYNOPSIS

Replaces a storage source used in a mirrored virtual disk.

SYNTAX

Replace-DcsVirtualDiskSource   [ -Server <String> ]   -VirtualDisk <Object>   -Pool <String>   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Replace-DcsVirtualDiskSource   [ -Server <String> ]   -VirtualDisk <Object>   -PassThroughDisk <String>   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Replace-DcsVirtualDiskSource   [ -Server <String> ]   -VirtualDisk <Object>   -LogicalDisk <Object>   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Replaces a storage source used in a mirrored virtual disk. The new storage source can be from a pool, pass-through disk, or logical disk. When the storage source is replaced, all paths are adjusted to use the new source.

PARAMETERS

-Server<String>
Computer name or ID of the server from which the storage source is being replaced. The computer name must be unique or the name must be fully qualified.

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

-VirtualDisk<Object>
VirtualDiskData object, name, or ID that identifies the virtual disk in which the storage source should be replaced.

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

-Pool<String>
Name or ID of the pool if using a pool as the new storage source. To resolve by name, the name must be unique to the server group or the server must be specified.

Required: true
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

-PassThroughDisk<String>
The name or ID of the pass-through disk, if it is being used as the new storage source for the virtual disk. To resolve by name, the name must be unique to the server group or the server must be specified.

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

-LogicalDisk<Object>
LogicalDiskData object, ID or caption of a logical disk that identifies the new storage source.

Required: true
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.

NOTES

Also see Move-DcsVirtualDiskSource, Split-DcsVirtualDisk, Get-DcsVirtualDisk.

EXAMPLES


-------------- Example 1 Replaces a virtual disk source from a pool --------------
Replace-DcsVirtualDiskSource -Server SSV1 -VirtualDisk "Virtual disk 1" -Pool "Disk pool 1"
		

Replaces the virtual disk source from server "SSV1" for the virtual disk named "Virtual disk 1" from the pool named "Disk pool 1".

VirtualDiskGroupId:
FirstHostId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4
SecondHostId:C553D471-3527-47EC-9326-D53E04204F2B
BackupHostId:
StorageProfileId:100469DF-0BE1-40DA-874E-9F1DA5A259E3
Alias:Virtual disk 1
Description:
Size:50.00 GiB
Type:MultiPathMirrored
DiskStatus:FailedRedundancy
InquiryData:DataCore Virtual Disk DCS
ScsiDeviceId:{96, 3, 13, 144...}
RemovableMedia:False
WriteThrough:False
Offline:False
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:Regular
IsServed:False
Id:162032c99ebd4272b80ea6de9757bafc
Caption:Virtual disk 1
ExtendedCaption:Virtual disk 1 from LOCAL
Internal:False
   

-------------- Example 2 Replaces a virtual disk source with a passthrough disk --------------
Replace-DcsVirtualDiskSource -Server SSV1 -VirtualDisk "Virtual disk 1" -PassThroughDisk "Disk 8"
		

Replaces the virtual disk source from server "SSV1" for the virtual disk named "Virtual disk 1" with the pass-through disk named "Disk 8".

VirtualDiskGroupId:
FirstHostId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4
SecondHostId:C553D471-3527-47EC-9326-D53E04204F2B
BackupHostId:
StorageProfileId:100469DF-0BE1-40DA-874E-9F1DA5A259E3
Alias:Virtual disk 1
Description:
Size:50.00 GiB
Type:MultiPathMirrored
DiskStatus:FailedRedundancy
InquiryData:DataCore Virtual Disk DCS
ScsiDeviceId:{96, 3, 13, 144...}
RemovableMedia:False
WriteThrough:False
Offline:False
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:Regular
IsServed:False
Id:162032c99ebd4272b80ea6de9757bafc
Caption:Virtual disk 1
ExtendedCaption:Virtual disk 1 from LOCAL
Internal:False
   

-------------- Example 3 Replaces a virtual disk source with a logical disk --------------
Replace-DcsVirtualDiskSource -VirtualDisk "Virtual disk 1" -LogicalDisk (Add-DcsLogicalDisk -Pool "Disk Pool 1" -Server SSV1)
		

Replaces the virtual disk source for the virtual disk named "Virtual disk 1" with a new logical disk. The parameter LogicalDisk is obtained by invoking the cmdlet Add-DcsLogicalDisk which creates a new logical disk from the pool named "Disk pool 1" on server "SSV1" and passes the LogicalDiskData object to Replace-DcsVirtualDiskSource.

VirtualDiskGroupId:
FirstHostId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4
SecondHostId:C553D471-3527-47EC-9326-D53E04204F2B
BackupHostId:
StorageProfileId:100469DF-0BE1-40DA-874E-9F1DA5A259E3
Alias:Virtual disk 1
Description:
Size:50.00 GiB
Type:MultiPathMirrored
DiskStatus:FailedRedundancy
InquiryData:DataCore Virtual Disk DCS
ScsiDeviceId:{96, 3, 13, 144...}
RemovableMedia:False
WriteThrough:False
Offline:False
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:Regular
IsServed:False
Id:162032c99ebd4272b80ea6de9757bafc
Caption:Virtual disk 1
ExtendedCaption:Virtual disk 1 from LOCAL
Internal:False
   

-------------- Example 4 Replaces all virtual disk sources from a specified pool by piping objects --------------
Get-DcsVirtualDisk -Server SSV1 -Kind Standard | Replace-DcsVirtualDiskSource -Server SSV1 -Pool "Disk pool 2"
		

In this example, assume that the server SSV1 has two pools. All existing virtual disks were created from Disk pool 1. Disk pool 2 is a new pool and there are no virtual disks created from the pool.
This example invokes the cmdlet Get-DcsVirtualDisk to get objects for all "standard" virtual disks on server "SSV1". The VirtualDiskData objects are piped to Replace-DcsVirtualDiskSource, resulting in the replacement of those virtual disk sources on server "SSV1" using the new pool named "Disk pool 2".


VirtualDiskGroupId:
FirstHostId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4
SecondHostId:C553D471-3527-47EC-9326-D53E04204F2B
BackupHostId:
StorageProfileId:100469DF-0BE1-40DA-874E-9F1DA5A259E3
Alias:Virtual disk 1
Description:
Size:50.00 GiB
Type:MultiPathMirrored
DiskStatus:FailedRedundancy
InquiryData:DataCore Virtual Disk DCS
ScsiDeviceId:{96, 3, 13, 144...}
RemovableMedia:False
WriteThrough:False
Offline:False
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:Regular
IsServed:False
Id:162032c99ebd4272b80ea6de9757bafc
Caption:Virtual disk 1
ExtendedCaption:Virtual disk 1 from LOCAL
Internal:False
   
VirtualDiskGroupId:
FirstHostId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4
SecondHostId:C553D471-3527-47EC-9326-D53E04204F2B
BackupHostId:
StorageProfileId:100469DF-0BE1-40DA-874E-9F1DA5A259E3
Alias:Virtual disk 2
Description:
Size:50.00 GiB
Type:MultiPathMirrored
DiskStatus:FailedRedundancy
InquiryData:DataCore Virtual Disk DCS
ScsiDeviceId:{96, 3, 13, 144...}
RemovableMedia:False
WriteThrough:False
Offline:False
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:Regular
IsServed:False
Id:0f1fbf4ac7cf40a491cad91e4ef8d324
Caption:Virtual disk 2
ExtendedCaption:Virtual disk 2 from LOCAL
Internal:False
   
VirtualDiskGroupId:
FirstHostId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4
SecondHostId:C553D471-3527-47EC-9326-D53E04204F2B
BackupHostId:
StorageProfileId:100469DF-0BE1-40DA-874E-9F1DA5A259E3
Alias:Virtual disk 3
Description:
Size:50.00 GiB
Type:MultiPathMirrored
DiskStatus:FailedRedundancy
InquiryData:DataCore Virtual Disk DCS
ScsiDeviceId:{96, 3, 13, 144...}
RemovableMedia:False
WriteThrough:False
Offline:False
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:Regular
IsServed:True
Id:635134ab2cad4b5d81af73ae5f09bd6f
Caption:Virtual disk 3
ExtendedCaption:Virtual disk 3 from LOCAL
Internal:False
   
VirtualDiskGroupId:
FirstHostId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4
SecondHostId:C553D471-3527-47EC-9326-D53E04204F2B
BackupHostId:
StorageProfileId:100469DF-0BE1-40DA-874E-9F1DA5A259E3
Alias:Virtual disk 4
Description:
Size:50.00 GiB
Type:MultiPathMirrored
DiskStatus:FailedRedundancy
InquiryData:DataCore Virtual Disk DCS
ScsiDeviceId:{96, 3, 13, 144...}
RemovableMedia:False
WriteThrough:False
Offline:False
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:Regular
IsServed:False
Id:7ffb74fd190d4c9c9c7b7e14748e2da6
Caption:Virtual disk 4
ExtendedCaption:Virtual disk 4 from LOCAL
Internal:False