Citrix StoreFront SDK PowerShell Modules

Start-STFServerGroupJoin

Start the Server Group join process

Syntax

Start-STFServerGroupJoin [-AuthorizerHostName] <String> [-Passcode] <String> [<CommonParameters>]
Start-STFServerGroupJoin [-IsAuthorizingServer] <SwitchParameter> [<CommonParameters>]
<!--NeedCopy-->

Detailed Description

Start the Server Group join process.

Parameters

Name Description Required? Pipeline Input
AuthorizerHostName The hostname of the authorizing server true false
Passcode Passcode generated by the authorizing server true false
IsAuthorizingServer This is the authorizing server true false

Input Type

System.String

Parameter AuthorizerHostName: The .NET ‘System.String’ reference type

System.String

Parameter Passcode: The .NET ‘System.String’ reference type

System.Management.Automation.SwitchParameter

Parameter IsAuthorizingServer: The .NET ‘System.Management.Automation.SwitchParameter’ value type

Return Values

ClusterPasscodeResponse ClusterResponse

The .NET ‘Citrix.DeliveryServices.ClusterService.Contract.ClusterPasscodeResponse’ reference type The .NET ‘Citrix.DeliveryServices.ClusterService.Contract.ClusterResponse’ reference type

Notes

When executed on a joining server the authorizing server and passcode is required.

Examples

EXAMPLE 1 Authorize a server to join

Start-STFServerGroupJoin -IsAuthorizingServer -Confirm:$false
Write-Host 'Use the Passcode to join to this server'
<!--NeedCopy-->

REMARKS

Starts the join process providing a pass code that can be taken to a ‘joiner’ server so it can join to the authorizing server. OUTPUT

Passcode                                                                     Status StatusMessage

--------                                                                     ------ -------------

83226368                                                              PasscodeReady Passcode for authorization.

Use the Passcode to join to this server
<!--NeedCopy-->

EXAMPLE 2 Join an authorizing server

Start-STFServerGroupJoin -AuthorizerHostName serverA -Passcode 12345678 -Confirm:$false
<!--NeedCopy-->

REMARKS

Join the authorizing server ‘serverA’ using the passcode 12345678 that was generated for it.

Start-STFServerGroupJoin