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