NAME

Get-DcsClientPreferredServer

SYNOPSIS

Returns client-preferred server relationships that show which servers are associated with which clients (hosts).

SYNTAX

Get-DcsClientPreferredServer   [ -Client <Object> ]   [ -Server <Object> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Get-DcsClientPreferredServer   -ClientPreferredServer <Object>   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Returns client-preferred server relationships that show which servers are associated with which clients (hosts). Filtering parameters may be specified to narrow the scope of the data returned. Preferred server data can be returned for a specific client (host), a specific server, or a specific client-preferred server relationship. If no parameters are specified, data for all client-preferred server relationships in the server group is returned.

PARAMETERS

-Client<Object>

ClientHostData object, name, or ID that identifies a client (host). If specified, only data for that client will be returned.

Required: false

Position: 1

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-Server<Object>

ServerHostData object, computer name or ID that identifies a server. The computer name must be unique or the name must be fully qualified. If the server is specified, only data for that server will be returned.

Required: false

Position: 2

Default value:

Accept pipeline input: true (ByValue)

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

-ClientPreferredServer<Object>

ClientServerRelationData object, ID, or caption that identifies a client-preferred server relationship. If specified, only data for that relationship will be returned. The caption is the name of the host followed by the name of the preferred server in this format: "HostVM1 | SSVVM01".

Required: true

Position: 1

Default value:

Accept pipeline input: false

Accept wildcard characters: false

INPUTS

ServerHostData : Object that identifies and describes the server.

OUTPUTS

ClientServerRelationData : Object that identifies the preferred server relationship between a client (host ) and preferred server.

NOTES

A Preferred Server setting of "Auto select" returns no data since no preferred server is specifically set. A host enabled for ALUA with a Preferred Server setting of "ALL" returns no data. In this case, the path policy is Symmetrical, which means that all available paths are utilized equally, therefore no server is preferred.

EXAMPLES

Get-DcsClientPreferredServer -Client "HostVM1"
		

Get-DcsServer -Server "SSVVM01" | Get-DcsClientPreferredServer
		

Get-DcsClientPreferredServer -ClientPreferredServer "HostVM1 | SSVVM01"