# Add-SfServerToCluster
Adds a new server to an existing cluster.
Syntax
Add-SfServerToCluster -ClusterId <Guid> -ServerName <String> [-StorefrontUrl <Uri>] [-FarmName <String>] [-XmlServices <Uri[]>] [-RunAsynchronously <Boolean>] [-LoggingId <Guid>] [-AdminAddress <String>] [<CommonParameters>]
Detailed Description
Adds a new server to an existing cluster. Optionally updates Farm and StoreFront URL. After operation succeeds, all servers are configured identically.
Related Commands
Parameters
| Name | Description | Required? | Pipeline Input | Default Value |
|---|---|---|---|---|
| ClusterId | The id of the cluster to perform operation on. | true | false | |
| ServerName | The name of the server to join to exisiting cluster. The name must be one of the values returned by Get-SfCluster | true | false | |
| StorefrontUrl | The url that will be used by Receivers to contact StoreFront. Http or https absolute urls are accepted. | false | false | Server name and http binding. |
| FarmName | Name of the farm that will be used within Store service. Either both FarmName and XmlServices need to be specified or none of them. | false | false | |
| XmlServices | Collection of the url of xml services that will be used inside a farm. The URLs need to be http or https, be absolute and share the same schema and port. Either both FarmName and XmlServices need to be specified or none of them. | false | false | |
| RunAsynchronously | If set, the command will run asynchronously. | false | false | false |
| LoggingId | Specifies the identifier of the high-level operation this cmdlet call forms a part of. Citrix Studio and Director typically create high-level operations. PowerShell scripts can also wrap a series of cmdlet calls in a high-level operation by way of the Start-LogHighLevelOperation and Stop-LogHighLevelOperation cmdlets. | false | false | |
| AdminAddress | Specifies the address of a XenDesktop controller the PowerShell snap-in will connect to. You can provide this as a host name or an IP address. | false | false | Localhost. Once a value is provided by any cmdlet, this value becomes the default. |
Input Type
Return Values
Citrix.Storefront.Sdk.Task or Citrix.Storefront.DataModel.Cluster
Returns cluster description or a task, if ran asynchronously.
Examples
EXAMPLE 1
Add-SfServerToCluster -ClusterId (Guid) -ServerName NewSfServer -RunAsynchronously $true
Description
-----------
Adds "NewSfServer" to cluster with id (Guid).