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 Default Value
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