NAME

Add-DcsClient

SYNOPSIS

Adds a client (host) to a server group configuration.

SYNTAX

Add-DcsClient   -Name <String>   [ -Description <String> ]   [ -ClientType <String> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ] [<CommonParameters>]

Add-DcsClient   -Name <String>   [ -PreferredServer <Object[]> ]   [ -Description <String> ]   [ -ClientType <String> ]   -Multipath <Boolean>   -ALUA <Boolean>   [ -Connection <String> ]   [ -PipelineVariable <String> ][<CommonParameters>]

DESCRIPTION

Adds a client (host) to a server group configuration. Preferred servers can also be assigned, and MPIO and ALUA settings can be configured. After adding the client, ports can be assigned, see Register-DcsClientPort. See Set-DcsClientProperties to change properties.

PARAMETERS

-Name<String>

Name of the client to add.

Required: true

Position: 1

Default value:

Accept pipeline input: true (ByValue)

Accept wildcard characters: false

-Description<String>

Description of the client host.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-ClientType<String>

The operating system of the client. If this parameter is not specified, the default value of "WindowsServer2012" will be assigned. Values include: "WindowsServer2012" if the client host is running Windows Server 2012 and later. "WindowsServer2008" if the client host is running Windows Server 2008. "Windows" if the client host is running any Windows operating system version prior to Windows Server 2008. "ESXi" if the client host is running VMware ESXi. "CitrixXenServer" if the client host is running Citrix Xen Server. "SuseEnterpriseLinusServer11" if the client host is running Linux Suse Enterprise Server 11. "Linux" if the client host is running any Linux operating system other than Linux Suse Enterprise Server 11. "AixMpio" if the client host is running IBM AIX Native MPIO Legacy. "AixMpioTL6Plus" if the client host is running IBM AIX. "HPUX" if the client is running HP HPUX. "SolarisSanFoundation" if the client host is running Oracle (Sun) Solaris. "Proxmox" if the client host is a Proxmox Virtual Environment. "Other" if the client host is running an operating system that is not listed.

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

-PreferredServer<Object[]>

Computer name or ID of one or more servers that should be preferred to handle I/O requests from the client (host). The computer names must be either unique or fully qualified. Multiple servers should be separated by commas, for instance "SSVVM01", "SSVVM02", "SSVVM03". MPIO and ALUA must be enabled. The Auto Select option (available in the console) is not supported in this cmdlet. If this parameter is not specified, the preferred server will be automatically selected when a mirrored virtual disk is created, the server with the first storage source is designated as the preferred server. See Add-DcsVirtualDisk and refer to the FirstServer parameter.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-Multipath<Boolean>

Specify $true to enable multipathing support, or $false to disable multipathing support.

Required: true

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-ALUA<Boolean>

Specify $true to enable ALUA support, or $false to disable ALUA. Multipathing support must be enabled in order to enable ALUA support.

Required: true

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

 

-<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

OUTPUTS

ClientHostData : Object that identifies and describes the client host.

NOTES

Also see Register-DcsClientPort, Set-DcsClientProperties, Get-DcsClient, Remove-DcsClient.

EXAMPLES

Add-DcsClient -Name ExchSrv1 -Description "MainLab_ExchangeServer" -ClientType "WindowsServer2012" -PreferredServer "BlazeSSV1", "BlazeSSV2" -Multipath $true -ALUA $true