Citrix StoreFront SDK PowerShell Modules

Import-STFNetScalerConfiguration

Import a NetScaler remote access configuration

Syntax

Import-STFNetScalerConfiguration [-Configuration] <NetScalerConfigurationDocument> [[-PropagateChanges] <SwitchParameter>] [[-RoamingGatewaysToOverwrite] <RoamingGateway[]>] [[-CreateNew] <SwitchParameter>] [[-LogonType] <Domain | RSA | DomainAndRSA | SMS | SmartCard | SmartCardDomain | SmartCardRSA | SmartCardDomainAndRSA | SmartCardSMS>] [[-CallbackUrl] <String>] [[-GatewayIndex] <Int32>] [<CommonParameters>]
<!--NeedCopy-->

Detailed Description

Import a NetScaler remote access configuration supplied by a NetScaler administrator.

Parameters

Name Description Required? Pipeline Input
Configuration A NetScaler configuration to be imported into StoreFront. true true (ByValue)
PropagateChanges Propagate configuration changes to other members of the cluster. false false
RoamingGatewaysToOverwrite Specify gateways that should be overwritten if the import finds more than one matching gateway that will be overwritten by the import. false false
CreateNew Specify that a new gateway should be created rather than update an existing gateway. false false
LogonType Specify the logon type for a gateway overriding whatever is specified in the configuration document. false false
CallbackUrl Optional callback url to replace the suggested url if it cannot be resolved. false false
GatewayIndex Optional ability to specify which gateway from the configuration which will be imported. false false

Input Type

Citrix.StoreFront.Model.Roaming.NetScalerConfiguration.NetScalerConfigurationDocument

Parameter Configuration: The .NET ‘Citrix.StoreFront.Model.Roaming.NetScalerConfiguration.NetScalerConfigurationDocument’ reference type

System.Management.Automation.SwitchParameter

Parameter PropagateChanges: The .NET ‘System.Management.Automation.SwitchParameter’ value type

Citrix.StoreFront.Model.Roaming.RoamingGateway[]

Parameter RoamingGatewaysToOverwrite: The .NET ‘Citrix.StoreFront.Model.Roaming.RoamingGateway’ reference type

System.Management.Automation.SwitchParameter

Parameter CreateNew: The .NET ‘System.Management.Automation.SwitchParameter’ value type

Citrix.StoreFront.Model.Roaming.NetScalerConfiguration.ImportLogonType

Parameter LogonType: The .NET ‘Citrix.StoreFront.Model.Roaming.NetScalerConfiguration.ImportLogonType’ value type

System.String

Parameter CallbackUrl: The .NET ‘System.String’ reference type

System.Int32

Parameter GatewayIndex: The .NET ‘System.Int32’ value type

Return Values

DocumentValidation

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

Notes

-WhatIf parameter can be used to verify the configuration consistency.

Examples

EXAMPLE 1 Import a NetScaler remote access configuration

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

REMAR

KS




The example reads in a NetScaler configuration package, validates that the Secure Ticket Authorities can be resolved
and imports the configuration.

If validation errors are found they are output to the pipeline. If propagating to the cluster the progress can be
monitored with Wait-STFPublishServerGroupConfiguration
<!--NeedCopy-->

EXAMPLE 2 Import specific vServer from NetScaler remote access configuration file.

$ImportedGateways = Read-STFNetScalerConfiguration -path "$env: USERPROFILE\desktop\GatewayConfig.zip"
Import-STFNetScalerConfiguration -Configuration $ImportedGateways -GatewayIndex 0
Import-STFNetScalerConfiguration -Configuration $ImportedGateways -GatewayIndex 1
Import-STFNetScalerConfiguration -Configuration $ImportedGateways -GatewayIndex 2
<!--NeedCopy-->

REMARKS

The example reads in a NetScaler configuration package and then imports the first gateway defined in the package, followed by the second and the third.

Import-STFNetScalerConfiguration