NAME

Set-DcsVirtualDiskScsiId

SYNOPSIS

Sets the SCSI device ID for a virtual disk.

SYNTAX

Set-DcsVirtualDiskScsiId -VirtualDisk <Object> [ -ScsiId <String> ] [ -Connection <String> ] [ -PipelineVariable <String> ]

DESCRIPTION

Sets the SCSI device ID for a virtual disk. Under most circumstances this value should not be changed. If the virtual disk is using duplicate disk IDs and is involved in replications, snapshots, or Continuous Data Protection, then if the replication, snapshot or rollback is split, both virtual disks will have the same SCSI device ID. Under these circumstances, the SCSI device IDs on one virtual disk may need to be changed in order to make it unique. WARNING: This value should only be changed if necessary and with extreme caution. Providing an incorrect value will result in functional problems.

PARAMETERS

-VirtualDisk<Object>: VirtualDiskData object, name, or ID that identifies the virtual disk.; Required: true; Position: named; Default value:; Accept pipeline input: false; Accept wildcard characters: false
-ScsiId<String>: The new SCSI device ID to use for the virtual disk. The SCSI device ID is intended to be globally unique and must be unique in the local server group and any server groups of which the virtual disk may interact, for instance in replications. The format of the value is a 32-digit hexadecimal number. Valid characters are 0-9 and a-f. The value must begin with "60030D90" which signifies a DataCore virtual disk. Add 24 additional characters to complete the number. For example, "60030d9078870206ffc9c0263011a718" could be a valid ID.; 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 is 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

INPUTS

OUTPUTS

VirtualDiskData : Object that identifies and describes the virtual disk.

NOTES

Also see Get-DcsVirtualDisk, Set-DcsVirtualDiskProperties

EXAMPLES

-------------- Example 1 Assigns new SCSI ID to a virtual disk --------------

Get-DcsVirtualDisk | foreach { $_.ScsiDeviceIdString } | sort
Set-DcsVirtualDiskScsiId -VirtualDisk "Virtual disk 1" -ScsiId "60030D90D1DB02061F960065E185D7AF"

The cmdlet Get-DcsVirtualDisk is invoked to retrieve the SCSI IDs assigned to all virtual disks in the server group and sorts them. (In this case, assume that the virtual disk will never be interacting with virtual disks in any other server group.)The cmdlet Set-DcsVirtualDiskScsiId is invoked to set the SCSI device ID for "Virtual disk 1" to a unique SCSI device ID " " in the local server group.