NAME

Set-DcsPhysicalDiskPathPreference

SYNOPSIS

Sets a back-end or mirror Fibre Channel path to be preferred or non-preferred.

SYNTAX

Set-DcsPhysicalDiskPathPreference   -Path <Object>   -Preferred <Boolean>   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Sets a back-end or mirror Fibre Channel path to be preferred or non-preferred. A preferred path will always be used if available.

PARAMETERS

-Path<Object>

The physical disk ID or DiskPathData object that identifies the back-end or mirror Fibre Channel path.

Required: true

Position: named

Default value:

Accept pipeline input: true (ByValue)

Accept wildcard characters: false

-Preferred<Boolean>

Use this parameter to set whether or not the path should be preferred. Specify $true to assign the path to be the preferred path to use. A preferred path will always be used if available. Specify $false to assign the path as non-preferred.

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

DiskPathData : Object that identifies the path.

OUTPUTS

DiskPathData : Object that identifies the disk path.

NOTES

Also see Get-DcsPhysicalDiskPath. To set front-end preferred path option and access rights, see Set-DcsVirtualLogicalUnitProperties.

EXAMPLES

Get-DcsPhysicalDiskPath -Server Server1 -Disk "Disk 0" | Set-DcsPhysicalDiskPathPreference -Preferred $true