Download full document:

# New-STFEquivalentFarmset

Create a new EquivalentFarmSet for a UserFarmMapping.


New-STFEquivalentFarmset [-Name] <String> [-AggregationGroupName] <String> [-PrimaryFarms] <String[]> [[-BackupFarms] <String[]>] [-LoadBalanceMode] <Failover | LoadBalanced> [[-FarmsAreIdentical] <Boolean>] [<CommonParameters>]

Detailed Description

An EquivalentFarmSet is a set of PrimaryFarms that provide applications and desktops. When the applications and desktops available from each farm are identical, the experience of using any of them would be equivalent to an end user, so the EquivalentFarmSet should be marked as identical. If any of the farms are not identical the applications and desktops available during enumeration and launch would vary, so the EquivalentFarmSet should be marked as not identical. During enumeration, where the farms are not marked as identical, each is queried in parallel, whereas for farms that are marked as identical, only one is queried. The enumerated resources are de-duplicated according to the AggregationGroupName setting of this and other EquivalentFarmSets available to the same user. During launch, the farms to use are selected by UserFarmMapping, EquivalentFarmSet and AggregationGroupName. Once selected they are ordered and requests are load balanced or failed over between them. EquivalentFarmSets also define BackupFarms, they will only be used should all PrimaryFarms and EquivalentFarmSets with identical AggregationGroupName become unavailable.


Name Description Required? Pipeline Input Default Value
Name The unique Name used to identify the EquivalentFarmSet. true false
AggregationGroupName The AggregationGroupName used to de-duplicate applications and desktops that are available on multiple EquivalentFarmSets. Where multiple EquivalentFarmSets are defined the AggregationGroup will prevent the user seeing the application multiple times if it exists in both places. true false
PrimaryFarms The PrimaryFarms. The farm names should match those defined in the Store service. true false
BackupFarms The BackupFarms. The farm names should match those defined in the Store Service. false false
LoadBalanceMode The load balance mode either Failover or LoadBalanced. true false
FarmsAreIdentical Whether the PrimaryFarms in the EquivalentFarmSet all publish identical resources. Set to true if all resources are identical on all primary farms. Set to false if the deployment has some unique resources per farm. false false

Input Type


Parameter Name: The .NET System.String reference type


Parameter AggregationGroupName: The .NET System.String reference type


Parameter PrimaryFarms: The .NET System.String reference type


Parameter BackupFarms: The .NET System.String reference type


Parameter LoadBalanceMode: The .NET Citrix.StoreFront.Model.Store.LoadBalanceMode value type


Parameter FarmsAreIdentical: The .NET System.Boolean value type

Return Values


The .NET Citrix.StoreFront.Model.Store.EquivalentFarmSet reference type


Must be added to a UserFarmMapping via the Set-STFUserFarmMapping cmdlet before it can be used.


EXAMPLE 1 Create a new EquivalentFarmSet

$eu1Farmset = New-STFEquivalentFarmset -Name "EU1" -AggregationGroupName "EUUsers" -PrimaryFarms XenApp1, XenApp2 -BackupFarms XenAppBackup -LoadBalanceMode LoadBalanced -FarmsAreIdentical $true


Creates a new EquivalentFarmSet with two servers XenApp1 and XenApp2 that are identical and will be load balanced. Should the primary server fail XenAppBackup will be used.