Skip to content


Update a NetScaler gateway STA configuration


Update-STFSecureTicketAuthority [-StaConfigurationObject] <IStaServerData> [-StaServers] <Hashtable> [<CommonParameters>]

Detailed Description

Update a PowerShell object populated with a NetScaler gateway STA configuration. The cmdlet can be used to update invalid or uncontactable STA servers.

Read-STFNetScalerConfiguration Test-STFSecureTicketAuthority


Name Description Required? Pipeline Input
StaConfigurationObject A configuration object supporting validation of STA servers. true true (ByValue)
StaServers A hashtable of STA urls present in the configuration mapped to the required STA urls. true false

Input Type


Parameter StaConfigurationObject: The .NET 'Citrix.StoreFront.Model.Roaming.NetScalerConfiguration.IStaServerData' reference type


Parameter StaServers: The .NET 'System.Collections.Hashtable' reference type

Return Values


EXAMPLE 1 Update a NetScaler gateway STA configuration

$netscalerConfiguration = Read-STFNetScalerConfiguration –Path C:\NSG\
# Test cmdlet returns two invalid STA servers that cannot be resolved
$results = Test-STFSecureTicketAuthority -StaConfigurationObject
# Update the invalid STA servers
Update-STFSecureTicketAuthority -StaConfigurationObject $netscalerConfiguration –StaServers @{ “” = “”, “” = “” }


Updates STA server urls within the configuration object with new STA urls. An STA url provided by NetScaler may not resolve on an internal network so will need updating to a StoreFront local address.

Was this article helpful?