Add-STFRoamingGateway¶
Add a new Gateway that can be used for remote access and authentication.
Syntax¶
Add-STFRoamingGateway [-RoamingGateway] <RoamingGateway> [[-RoamingService] <RoamingService>] [<CommonParameters>] Add-STFRoamingGateway [-Name] <String> [-LogonType] <UsedForHDXOnly | Domain | RSA | DomainAndRSA | SMS | GatewayKnows | SmartCard | None> [[-SmartCardFallbackLogonType] <UsedForHDXOnly | Domain | RSA | DomainAndRSA | SMS | GatewayKnows | SmartCard | None>] [[-Version] <Version10_0_69_4 | Version9x>] [-GatewayUrl] <Uri> [[-CallbackUrl] <Uri>] [[-SessionReliability] <SwitchParameter>] [[-RequestTicketTwoSTAs] <SwitchParameter>] [[-SubnetIPAddress] <String>] [[-SecureTicketAuthorityUrls] <Uri[]>] [[-StasUseLoadBalancing] <SwitchParameter>] [[-StasBypassDuration] <TimeSpan>] [[-PassThru] <SwitchParameter>] [[-GslbUrl] <Uri>] [[-RoamingService] <RoamingService>] [<CommonParameters>]
Detailed Description¶
Add a new Gateway to the global gateway list. Gateways for remote access and authentication are added to Stores from the globally managed list.
Related Commands¶
Parameters¶
| Name | Description | Required? | Pipeline Input | Default Value |
|---|---|---|---|---|
| RoamingGateway | The Gateway to add | true | true (ByValue) | |
| Name | The Gateway friendly name | true | true (ByValue) | |
| LogonType | The login type required and supported by the Gateway | true | false | |
| SmartCardFallbackLogonType | The login type to use when SmartCard fails | false | false | |
| Version | The Citrix NetScaler Gateway version | false | false | |
| GatewayUrl | The Gateway Url | true | false | |
| CallbackUrl | The Gateway authentication NetScaler call-back Url | false | false | |
| SessionReliability | Enable session reliability. Session Reliability keeps sessions active and on the user’s screen when network connectivity is interrupted. Users continue to see the application they are using until network connectivity resumes. | false | false | |
| RequestTicketTwoSTAs | Request STA tickets from two STA servers (Requires two STA servers) | false | false | |
| SubnetIPAddress | IP address | false | false | |
| SecureTicketAuthorityUrls | Secure Ticket Authority server Urls. The Secure Ticket Authority (STA) is responsible for issuing session tickets in response to connection requests for published resources on XenApp. These session tickets form the basis of authentication and authorization for access to published resources. | false | false | |
| StasUseLoadBalancing | Load balance between the configured STA servers (requires two or more STA servers) | false | false | |
| StasBypassDuration | Time before retrying a failed STA server | false | false | |
| PassThru | Output the added Gateway | false | false | |
| GslbUrl | An optional URL which corresponds to the GSLB domain used by multiple gateways | false | false | |
| RoamingService | The Roaming service | false | false |
Input Type¶
Citrix.StoreFront.Model.Roaming.RoamingGateway¶
Parameter RoamingGateway: The .NET Citrix.StoreFront.Model.Roaming.RoamingGateway reference type
System.String¶
Parameter Name: The .NET System.String reference type
Citrix.StoreFront.Model.Roaming.GatewayLogonType¶
Parameter LogonType: The .NET Citrix.StoreFront.Model.Roaming.GatewayLogonType value type
Citrix.StoreFront.Model.Roaming.GatewayLogonType¶
Parameter SmartCardFallbackLogonType: The .NET Citrix.StoreFront.Model.Roaming.GatewayLogonType value type
Citrix.StoreFront.Model.Roaming.GatewayVersion¶
Parameter Version: The .NET Citrix.StoreFront.Model.Roaming.GatewayVersion value type
System.Uri¶
Parameter GatewayUrl: The .NET System.Uri reference type
System.Uri¶
Parameter CallbackUrl: The .NET System.Uri reference type
System.Management.Automation.SwitchParameter¶
Parameter SessionReliability: The .NET System.Management.Automation.SwitchParameter value type
System.Management.Automation.SwitchParameter¶
Parameter RequestTicketTwoSTAs: The .NET System.Management.Automation.SwitchParameter value type
System.String¶
Parameter SubnetIPAddress: The .NET System.String reference type
System.Uri[]¶
Parameter SecureTicketAuthorityUrls: The .NET System.Uri reference type
System.Management.Automation.SwitchParameter¶
Parameter StasUseLoadBalancing: The .NET System.Management.Automation.SwitchParameter value type
System.TimeSpan¶
Parameter StasBypassDuration: The .NET System.TimeSpan value type
System.Management.Automation.SwitchParameter¶
Parameter PassThru: The .NET System.Management.Automation.SwitchParameter value type
System.Uri¶
Parameter GslbUrl: The .NET System.Uri reference type
Citrix.StoreFront.Model.Roaming.RoamingService¶
Parameter RoamingService: A .NET class representing the configuration of a StoreFront Roaming service
Return Values¶
None¶
Examples¶
EXAMPLE 1 Add Version 10x Gateway¶
Add-STFRoamingGateway -Name "Netscaler10x" -LogonType Domain -Version Version10_0_69_4 -GatewayUrl https://gateway.citrix.storefront -CallbackUrl https://gateway.citrix.storefront/callback -SessionReliability:$true -RequestTicketTwoSTAs:$true -SubnetIPAddress 10.80.5.170 -SecureTicketAuthorityUrls https://XenApp1STA,https://XenApp2STA -PassThru
REMARKS
Add a version 10 or greater Gateway.
EXAMPLE 2 Add Version 9 Gateway¶
Add-STFRoamingGateway -Name "Netscaler9" -LogonType SmartCard -SmartCardFallbackLogonType Domain -Version Version9x -GatewayUrl https://EuNetscaler -CallbackUrl https://EuNetscaler/Callback -SessionReliability -RequestTicketTwoSTAs -SubnetIPAddress 10.80.5.170 -SecureTicketAuthorityUrls https://myxs/STA -PassThru
REMARKS
Add a version 9 Gateway.
EXAMPLE 3 Add three GSLB Gateways¶
Add-STFRoamingGateway -Name "EMEAGateway" -LogonType DomainAndRSA -Version Version10_0_69_4 -GatewayUrl https://emeagateway.citrix.storefront -GslbUrl https://gslb.citrix.storefront -CallbackUrl https://emeagateway.citrix.storefront/callback -SessionReliability:$true -RequestTicketTwoSTAs:$true - SubnetIPAddress 10.80.5.170 - SecureTicketAuthorityUrls https://XenApp1STA.citrix.storefront,https://XenApp2STA.citrix.storefront -PassThru \n Add-STFRoamingGateway -Name "USGateway" -LogonType DomainAndRSA -Version Version10_0_69_4 -GatewayUrl https://usgateway.citrix.storefront -GslbUrl https://gslb.citrix.storefront -CallbackUrl https://usgateway.citrix.storefront/callback -SessionReliability:$true -RequestTicketTwoSTAs:$true - SubnetIPAddress 10.80.5.171 - SecureTicketAuthorityUrls https://XenApp1STA.citrix.storefront,https://XenApp2STA.citrix.storefront -PassThru \n Add-STFRoamingGateway -Name "APACGateway" -LogonType DomainAndRSA -Version Version10_0_69_4 -GatewayUrl https://apacgateway.citrix.storefront -GslbUrl https://gslb.citrix.storefront -CallbackUrl https://apacgateway.citrix.storefront/callback -SessionReliability:$true -RequestTicketTwoSTAs:$true - SubnetIPAddress 10.80.5.172 - SecureTicketAuthorityUrls https://XenApp1STA.citrix.storefront,https://XenApp2STA.citrix.storefront -PassThru
REMARKS
Add Multiple GSLB Gateways.