NAME

Set-DcsVirtualLogicalUnitProperties

SYNOPSIS

Sets the preferred path option and access rights for the front-end path of a logical disk.

SYNTAX

Set-DcsVirtualLogicalUnitProperties   -VirtualLogicalUnit <Object>   [ -Access <LogicalUnitAccess> ]   [ -PreferredPathOption <PreferredPathOption> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Sets the preferred path option and access rights for the front-end path of a logical disk. Note: To change the LUN, the virtual logical unit must be removed and re-added with the new LUN specified. (See Remove-DcsVirtualLogicalUnit and Add-DcsVirtualLogicalUnit)

PARAMETERS

-VirtualLogicalUnit<Object>

VirtualLogicalUnitData object, ID or name (caption) that identifies the virtual logical unit (path of a logical disk).

Required: true

Position: 1

Default value:

Accept pipeline input: true (ByValue)

Accept wildcard characters: false

-Access<LogicalUnitAccess>

The client (host) access rights to assign for the front-end path. Valid values include "ReadWrite", "ReadOnly", and "NoAccess".

Required: false

Position: 2

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-PreferredPathOption<PreferredPathOption>

Sets the preferred path option for the logical disk path. Possible parameter values are "NotSet", "NotPreferred", or "Preferred". The value "NotSet" will allow the preferred path to be auto-selected by the software, which will select the path to the first server used when the virtual disk was created (see Add-DcsVirtualDisk for first server). The value "NotPreferred" will make the path not preferred no matter which server is the first server and regardless of the preferred server setting for a client (see Set-DcsClientProperties).

Required: false

Position: 3

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

VirtualLogicalUnitData : Object that identifies and describes the virtual logical unit (path of a logical disk on a server).

OUTPUTS

VirtualLogicalUnitData : Object that identifies and describes the virtual logical unit (path of a logical disk on a server).

NOTES

Also see Add-DcsVirtualLogicalUnit, Get-DcsVirtualLogicalUnit, Remove-DcsVirtualLogicalUnit. To set back-end or mirror preferred path options for Fibre Channel paths, see Set-DcsDiskPathPreference.

EXAMPLES

$LD1 | Set-DcsVirtualLogicalUnitProperties -Access "ReadOnly"
		

$LD = Get-DcsVirtualLogicalUnit -InitiatorHost HostVM1 -TargetHost SSVVM1 -VirtualDisk "Virtual disk 1"
$LD[0] | Set-DcsVirtualLogicalUnitProperties -PreferredPathOption Preferred