Developer Documentation
Citrix StoreFront SDK PowerShell Modules
Current release 2402 2311 2308 2203 1912 3.12

Test-STFSecureTicketAuthority

June 28, 2023
Contributed by: 
C

Validate a NetScaler gateway STA configuration

Syntax

Test-STFSecureTicketAuthority [-StaConfigurationObject] <IStaServerData> [<CommonParameters>]
<!--NeedCopy-->

Detailed Description

Validate a PowerShell object populated with a NetScaler gateway STA configuration.

Parameters

Name Description Required? Pipeline Input
StaConfigurationObject A configuration object supporting validation of STA servers. true true (ByValue)

Input Type

Citrix.StoreFront.Model.Roaming.NetScalerConfiguration.IStaServerData

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

Return Values

StaValidationStatus

The .NET ‘Citrix.StoreFront.Model.Roaming.NetScalerConfiguration.StaValidationStatus’ reference type

Notes

Any specified STA servers will be contacted during validation. A Secure Ticket Authority id is used to uniquely identify an STA server used for remote access.

Examples

EXAMPLE 1 Validate a NetScaler gateway STA configuration 

$netscalerConfiguration = Read-STFNetScalerConfiguration –Path C:\NSG\Configuration.zip
$stasToUpdate = Test-STFSecureTicketAuthority -StaConfigurationObject $netscalerConfiguration
<!--NeedCopy-->

REMARKS

Returns a list of STA servers with a validation status indicating success or failure including incorrect STA authorities. The STA url provided by NetScaler may not resolve on an internal network so will need updating to a StoreFront local address. The STA authority must match that provided in the NetScaler configuration export.

EXAMPLE 2 Validate a NetScaler gateway STA configuration with incorrect Authority Id 

$netscalerConfiguration = Read-STFNetScalerConfiguration –Path C:\NSG\Configuration.zip
$stasToUpdate = Test-STFSecureTicketAuthority -StaConfigurationObject $netscalerConfiguration
<!--NeedCopy-->

REMARKS

Returns a list of STA servers with a validation status indicating success or failure including incorrect STA authorities. The STA url provided by NetScaler may not resolve on an internal network so will need updating to a StoreFront local address. The STA authority must match that provided in the NetScaler configuration export. The expected output in the example shows both a valid and invalid STA url location. OUTPUT

WARNING: Cannot resolve the Sta server 'http://www.example.com/scripts/ctxsta.dll' to the authority id
'STA0000'.


StaUrl                      : http://www.example.com/scripts/ctxsta.dll
ConfigurationStaAuthorityId : STA0000
DetectedStaAuthorityId      : STACB1DA97D3546
ResultCode                  : AuthorityId Mismatch
IsValid                     : False

StaUrl                      : http://xendesktop.company.com/scripts/ctxsta.dll
ConfigurationStaAuthorityId :
DetectedStaAuthorityId      : STA578994219
ResultCode                  : Success
IsValid                     : True
<!--NeedCopy-->
Test-STFSecureTicketAuthority
June 28, 2023
Contributed by: 
C
June 28, 2023
Contributed by: 
C

In this article

Site feedback | Your privacy choices footer linkYour Privacy Choices | Privacy and legal terms | Cookie preferences | Consent settings | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.