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