Citrix StoreFront SDK PowerShell Modules

Add-STFStoreFarm

Add a farm to a Store

Syntax

Add-STFStoreFarm [-Farm] <Farm> [-StoreService] <StoreService> [[-Product] <String>] [[-RestrictPoPs] <String>] [[-FarmGuid] <String>] [<CommonParameters>]



Add-STFStoreFarm [-FarmName] <String> [-FarmType] <XenApp | XenDesktop | AppController | VDIinaBox | Store | SPA> [[-Servers] <String[]>] [[-ServiceUrls] <String[]>] [[-Port] <Int32>] [[-TransportType] <HTTP | HTTPS | SSL>] [[-SSLRelayPort] <Int32>] [[-LoadBalance] <Boolean>] [[-AllFailedBypassDuration] <Int32>] [[-BypassDuration] <Int32>] [[-TicketTimeToLive] <Int32>] [[-RadeTicketTimeToLive] <Int32>] [[-MaxFailedServersPerRequest] <Int32>] [[-Zones] <String[]>] [[-XMLValidationEnabled] <Boolean>] [[-XMLValidationSecret] <String>] [[-PassThru] <SwitchParameter>] [-StoreService] <StoreService> [[-Product] <String>] [[-RestrictPoPs] <String>] [[-FarmGuid] <String>] [<CommonParameters>]
<!--NeedCopy-->

Detailed Description

Add a XenApp \ XenDesktop farm to the specified Store service.

Parameters

Name Description Required? Pipeline Input Default Value
Farm The Farm object to add to the Store service true true (ByValue)  
StoreService Store service the farm will be added to true false  
FarmName The friendly name of the farm true false  
FarmType The type of farm to be added. XenDesktop or XenApp for example true false  
Servers The hostnames or IP addresses of the xml services false false  
ServiceUrls The url to the service location used to provide web and SaaS apps via this farm. false false  
Port Service communication port false false  
TransportType Type of transport to use. Http, Https, SSL for example false false  
SSLRelayPort The SSL Relay port false false  
LoadBalance Round robin load balance the xml service servers false false  
AllFailedBypassDuration Period of time to skip all xml service requests should all servers fail to respond false false  
BypassDuration Period of time to skip a server when is fails to respond false false  
TicketTimeToLive Period of time an ICA launch ticket is valid once requested on pre 7.0 XenApp and XenDesktop farms false false  
RadeTicketTimeToLive Period of time a RADE launch ticket is valid once requested on pre 7.0 XenApp and XenDesktop farms false false  
MaxFailedServersPerRequest Maximum number of servers within a single farm that can fail before aborting a request false false  
Zones The list of Zone names associated with the farm false false  
XMLValidationEnabled Enable XML service endpoint validation false false  
XMLValidationSecret XML service endpoint validation shared secret false false  
Product Cloud deployments only otherwise ignored. The product name of the farm configured false false  
RestrictPoPs Cloud deployments only otherwise ignored. Restricts GWaaS traffic to the specified POP false false  
FarmGuid Cloud deployments only otherwise ignored. A tag indicating the scope of the farm false false  
PassThru The resulting Store service false false  

Input Type

Citrix.StoreFront.Model.Store.Farm

Parameter Farm: A .NET class representing the configuration of a Farm in StoreFront Store service

Citrix.StoreFront.Model.Store.StoreService

Parameter StoreService: A .NET class representing the configuration of a StoreFront Store service

System.String

Parameter FarmName: The .NET System.String reference type

Citrix.StoreFront.Model.Store.FarmType

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

System.String[]

Parameter Servers: The .NET System.String reference type

System.String[]

Parameter ServiceUrls: The .NET System.String reference type

System.Int32

Parameter Port: The .NET System.Int32 value type

Citrix.StoreFront.Model.Store.TransportType

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

System.Int32

Parameter SSLRelayPort: The .NET System.Int32 value type

System.Boolean

Parameter LoadBalance: The .NET System.Boolean value type

System.Int32

Parameter AllFailedBypassDuration: The .NET System.Int32 value type

System.Int32

Parameter BypassDuration: The .NET System.Int32 value type

System.Int32

Parameter TicketTimeToLive: The .NET System.Int32 value type

System.Int32

Parameter RadeTicketTimeToLive: The .NET System.Int32 value type

System.Int32

Parameter MaxFailedServersPerRequest: The .NET System.Int32 value type

System.String[]

Parameter Zones: The .NET System.String reference type

System.Boolean

Parameter XMLValidationEnabled: The .NET System.Boolean value type

System.String

Parameter XMLValidationSecret: The .NET System.String reference type

System.String

Parameter Product: The .NET System.String reference type

System.String

Parameter RestrictPoPs: The .NET System.String reference type

System.String

Parameter FarmGuid: The .NET System.String reference type

System.Management.Automation.SwitchParameter

Parameter PassThru: The .NET System.Management.Automation.SwitchParameter value type

Return Values

Farm

A .NET class representing the configuration of a Farm in StoreFront Store service

Examples

EXAMPLE 1 Add a farm to the only Store service

$store = Get-STFStoreService
Add-STFStoreFarm -StoreService $store -FarmName "XenDesktop75" -FarmType XenDesktop -Port 80 -TransportType HTTP -Servers Xen1
<!--NeedCopy-->

REMARKS

Adds the Xen1 XenDesktop server to the XenDesktop75 farm

EXAMPLE 2 Add a farm to the Store service at /Citrix/Store

$store = Get-STFStoreService -VirtualPath /Citrix/Store
Add-STFStoreFarm -StoreService $store -FarmName "XenDesktop75" -FarmType XenDesktop -Port 80 -TransportType HTTP -Servers Xen1
<!--NeedCopy-->

REMARKS

Adds the Xen1 XenDesktop server to the XenDesktop75 farm

EXAMPLE 3 Copy a farm from the Store service at /Citrix/Store1 to the Store service at /Citrix/Store2

$store1 = Get-STFStoreService -VirtualPath /Citrix/Store1
$farm = $store1.FarmsConfiguration.Farms[0]
$store2 = Get-STFStoreService -VirtualPath /Citrix/Store2
Add-STFStoreFarm -StoreService $store2 -Farm $farm
<!--NeedCopy-->

REMARKS

Adds a new farm to $store2 with the same properties as the first farm from $store1. The farm object ($farm) is not changed by this operation.

EXAMPLE 4 Add a Secure Private Access farm to the Store service

$store = Get-STFStoreService
Add-STFStoreFarm -StoreService $store -FarmName "SPA Apps" -FarmType SPA -ServiceUrls http://spa-service.com/secureAccess/enumeration/aHR0cHM6Ly9zdG9yZWZyb250L0NpdHJpeC9TdG9yZTE
<!--NeedCopy-->

REMARKS

Adds the spa-service.com SPA server to the SPA Apps farm. Since this URL has a path specified, the ServiceUrl will be configured exactly as specified

EXAMPLE 5 Add a Secure Private Access farm to the Store service

$store = Get-STFStoreService
Add-STFStoreFarm -StoreService $store -FarmName "SPA Apps" -FarmType SPA -ServiceUrls https://spa-service.com
<!--NeedCopy-->

REMARKS

Adds the spa-service.com SPA server to the SPA Apps farm. Since this URL has no path, the SPA endpoint path and an encoded $store service URL will be appended ServiceUrl

EXAMPLE 6 Add an App Controller farm to the Store service

$store = Get-STFStoreService
Add-STFStoreFarm -StoreService $store -FarmName "App Controller Farm" -FarmType AppController -ServiceUrls https://appcontroller.com
<!--NeedCopy-->

REMARKS

Adds the https://appcontroller.com app controller server to the App Controller Farm farm.

Add-STFStoreFarm