StoreFront

Módulos de PowerShell de StoreFront

July 2, 2026

Contribución de:

Citrix StoreFront proporciona varios módulos de Microsoft Windows PowerShell versión 2.0 que se incluyen al instalar StoreFront. Con los módulos, puede realizar las mismas tareas que haría con la consola de administración de StoreFront, junto con tareas que no puede realizar solo con la consola.

Nota:

Los módulos de PowerShell de StoreFront no son compatibles con PowerShell 6 o versiones posteriores.

Para consultar la referencia de los módulos de PowerShell, consulte la documentación para desarrolladores de StoreFront.

Primeros pasos

Asegúrese de que la consola de administración de StoreFront esté cerrada.
Inicie un símbolo del sistema de PowerShell o Windows PowerShell ISE como administrador.

Debe ejecutar el shell o el script utilizando un miembro del grupo de administradores locales en el servidor de StoreFront.
Para usar cmdlets en scripts, establezca la política de ejecución en PowerShell en RemoteSigned. Para obtener más información sobre la política de ejecución de PowerShell, consulte la documentación de Microsoft.
Puede usar los scripts de ejemplo como punto de partida.
Utilice el cmdlet Get-Help proporcionando el nombre del cmdlet y el parámetro -Full para obtener más información sobre un comando específico.

Ruta virtual

Los cmdlets para obtener o crear un almacén, un sitio web o servicios de autenticación toman un parámetro VirtualPath. Esta es la ruta donde se aloja la aplicación dentro de IIS. La ruta del almacén y del sitio web también se puede encontrar en la consola de administración de StoreFront. Normalmente, por convención, la ruta de autenticación es la misma que la ruta del almacén con el sufijo Auth y el sitio web es la misma que la ruta del almacén con el sufijo Web. Por ejemplo, para la ruta virtual del almacén /Citrix/Store, el servicio de autenticación tiene la ruta /Citrix/StoreAuth y el sitio web tiene la ruta /Citrix/StoreWeb.

Por ejemplo, para obtener un servicio de almacén cuya ruta es /Citrix/Store, ejecute el comando:

Get-STFStoreService -VirtualPath '/Citrix/Store'
<!--NeedCopy-->

Si omite VirtualPath, se devuelven todos los servicios. Si solo hay un servicio, PowerShell lo trata como un único objeto.

ID del sitio

Algunos cmdlets incluyen un parámetro SiteId. Si tiene varias implementaciones en el mismo servidor en diferentes sitios de IIS, debe especificar el SiteId. Si solo tiene un sitio, el parámetro no es necesario.

Scripts de ejemplo

StoreFront incluye algunos scripts de ejemplo que se encuentran en la carpeta %ProgramFiles%\Citrix\Receiver StoreFront\PowerShellSDK\Examples. Puede utilizarlos como plantillas para crear sus propios scripts.

-  Use the PowerShell ISE, Visual Studio Code or a similar tool to edit the script.
-  Use variables to assign values that are to be reused or modified.
-  Remove any commands that are not required.
-  Note that StoreFront cmdlets can be identified by the prefix STF.

Ejemplos	Descripción
Crear una implementación sencilla	Script: crea una implementación sencilla con un controlador de StoreFront configurado con un único sitio CVAD.
Crear una implementación de acceso remoto	Script: se basa en el script anterior para agregar acceso remoto a la implementación.
Crear una implementación de acceso remoto con Optimal Launch Gateway	Script: se basa en el script anterior para agregar puertas de enlace de inicio óptimo preferidas para una mejor experiencia de usuario.

Crear una implementación sencilla

El siguiente ejemplo muestra cómo crear una implementación sencilla configurada con un sitio CVAD.

Antes de empezar, asegúrese de seguir los pasos detallados en Introducción. Este ejemplo se puede personalizar para producir un script que automatice la implementación de StoreFront.

Esta sección explica lo que hace cada parte del script. Esto le ayudará a personalizar su propio script.

Establece los requisitos de gestión de errores e importa los módulos de StoreFront necesarios. Las importaciones no son necesarias en las versiones modernas de PowerShell.

 Param(
     [Parameter(Mandatory=$true)]
     [Uri]$HostbaseUrl,
     [long]$SiteId = 1,
     [ValidateSet("XenDesktop","XenApp","AppController","VDIinaBox")]
     [string]$Farmtype = "XenDesktop",
     [Parameter(Mandatory=$true)]
     [string[]]$FarmServers,
     [string]$StoreVirtualPath = "/Citrix/Store",
     [bool]$LoadbalanceServers = $false,
     [int]$Port = 80,
     [int]$SSLRelayPort = 443,
     [ValidateSet("HTTP","HTTPS","SSL")]
     [string]$TransportType = "HTTP"
     )
     # Import StoreFront modules. Required for versions of PowerShell earlier than 3.0 that do not support autoloading
     Import-Module Citrix.StoreFront
     Import-Module Citrix.StoreFront.Stores
     Import-Module Citrix.StoreFront.Authentication
     Import-Module Citrix.StoreFront.WebReceiver
 <!--NeedCopy-->

Automatiza la ruta virtual de los servicios de autenticación y Citrix Receiver para Web basándose en el $StoreVirtualPath suministrado. $StoreVirtualPath es equivalente a StoreIISPath porque las rutas virtuales son siempre la ruta en IIS. Por lo tanto, en PowerShell tienen un valor como /Citrix/Store, /Citrix/StoreWeb o /Citrix/StoreAuth.
```
 # Determine the Authentication and Receiver virtual path to use based of the Store
 $authenticationVirtualPath = "$($StoreIISPath.TrimEnd('/'))Auth"
 $receiverVirtualPath = "$($StoreVirtualPath.TrimEnd('/'))Web"
 
```

Crea una nueva implementación si no hay ninguna presente, en preparación para añadir los servicios de StoreFront necesarios. -Confirm:$false suprime el requisito de confirmar que la implementación puede continuar.

 # Determine if the deployment already exists
 $existingDeployment = Get-STFDeployment
 if(-not $existingDeployment)
 {
     # Install the required StoreFront components
     Add-STFDeployment -HostBaseUrl $HostbaseUrl -SiteId $SiteId -Confirm:$false
 }
 elseif($existingDeployment.HostbaseUrl -eq $HostbaseUrl)
 {
     # The deployment exists but it is configured to the desired hostbase url
     Write-Output "A deployment has already been created with the specified hostbase url on this server and will be used."
 }
 else
 {
     Write-Error "A deployment has already been created on this server with a different host base url."
 }
 <!--NeedCopy-->

Crea un nuevo servicio de autenticación si no existe uno en la ruta virtual especificada. Se habilita el método de autenticación predeterminado de nombre de usuario y contraseña.

 # Determine if the authentication service at the specified virtual path exists
 $authentication = Get-STFAuthenticationService -VirtualPath $authenticationVirtualPath
 if(-not $authentication)
 {
     # Add an Authentication service using the IIS path of the Store appended with Auth
     $authentication = Add-STFAuthenticationService $authenticationVirtualPath
 }
 else
 {
     Write-Output "An Authentication service already exists at the specified virtual path and will be used."
 }
 <!--NeedCopy-->

Crea el nuevo servicio de almacén configurado con un sitio (también conocido como granja) con los servidores definidos en la matriz $XenDesktopServers en la ruta virtual especificada si no existe ya uno.

 # Determine if the store service at the specified virtual path exists
 $store = Get-STFStoreService -VirtualPath $StoreVirtualPath
 if(-not $store)
 {
 # Add a Store that uses the new Authentication service configured to publish resources from the supplied servers
 $store = Add-STFStoreService -VirtualPath $StoreVirtualPath -AuthenticationService $authentication -FarmName $Farmtype -FarmType $Farmtype -Servers $FarmServers -LoadBalance $LoadbalanceServers `
         -Port $Port -SSLRelayPort $SSLRelayPort -TransportType $TransportType
 }
 else
 {
     Write-Output "A Store service already exists at the specified virtual path and will be used. Farm and servers will be appended to this store."
     # Get the number of farms configured in the store
     $farmCount = (Get-STFStoreFarmConfiguration $store).Farms.Count
     # Append the farm to the store with a unique name
     Add-STFStoreFarm -StoreService $store -FarmName "Controller$($farmCount + 1)" -FarmType $Farmtype -Servers $FarmServers -LoadBalance $LoadbalanceServers -Port $Port `
         -SSLRelayPort $SSLRelayPort -TransportType $TransportType
 }
 <!--NeedCopy-->

Añade un sitio web en la ruta virtual de IIS especificada para acceder a las aplicaciones publicadas en el almacén creado anteriormente.

 # Determine if the receiver service at the specified virtual path exists
 $receiver = Get-STFWebReceiverService -VirtualPath $receiverVirtualPath
 if(-not $receiver)
 {
     # Add a Receiver for Web site so users can access the applications and desktops in the published in the Store
     $receiver = Add-STFWebReceiverService -VirtualPath $receiverVirtualPath -StoreService $store
 }
 else
 {
     Write-Output "A Web Receiver service already exists at the specified virtual path and will be used."
 }
 <!--NeedCopy-->

Habilita los servicios de XenApp para el almacén para que los clientes de Citrix Receiver o Citrix Workspace app más antiguos puedan conectarse a las aplicaciones publicadas.

 # Determine if PNA is configured for the Store service
 $storePnaSettings = Get-STFStorePna -StoreService $store
 if(-not $storePnaSettings.PnaEnabled)
 {
 # Enable XenApp services on the store and make it the default for this server
 Enable-STFStorePna -StoreService $store -AllowUserPasswordChange -DefaultPnaService
 }
 <!--NeedCopy-->

Ejemplo: Crear una implementación de acceso remoto

El siguiente ejemplo se basa en el script anterior para añadir una implementación con acceso remoto.

Antes de empezar, asegúrese de seguir los pasos detallados en Introducción. Este ejemplo se puede personalizar utilizando los métodos descritos para producir un script que automatice la implementación de StoreFront.

Esta sección explica lo que hace cada parte del script producido por StoreFront. Esto le ayudará a personalizar su propio script.

Establece los requisitos de gestión de errores e importa los módulos de StoreFront necesarios. Las importaciones no son necesarias en las versiones modernas de PowerShell.

 Param(
     [Parameter(Mandatory=$true)]
     [Uri]$HostbaseUrl,
     [Parameter(Mandatory=$true)]
     [long]$SiteId = 1,
     [string]$Farmtype = "XenDesktop",
     [Parameter(Mandatory=$true)]
     [string[]]$FarmServers,
     [string]$StoreVirtualPath = "/Citrix/Store",
     [bool]$LoadbalanceServers = $false,
     [int]$Port = 80,
     [int]$SSLRelayPort = 443,
     [ValidateSet("HTTP","HTTPS","SSL")]
     [string]$TransportType = "HTTP",
     [Parameter(Mandatory=$true)]
     [Uri]$GatewayUrl,
     [Parameter(Mandatory=$true)]
     [Uri]$GatewayCallbackUrl,
     [Parameter(Mandatory=$true)]
     [string[]]$GatewaySTAUrls,
     [string]$GatewaySubnetIP,
     [Parameter(Mandatory=$true)]
     [string]$GatewayName
 )
 Set-StrictMode -Version 2.0

 # Any failure is a terminating failure.
 $ErrorActionPreference = 'Stop'
 $ReportErrorShowStackTrace = $true
 $ReportErrorShowInnerException = $true
 # Import StoreFront modules. Required for versions of PowerShell earlier than 3.0 that do not support autoloading
 Import-Module Citrix.StoreFront
 Import-Module Citrix.StoreFront.Stores
 Import-Module Citrix.StoreFront.Roaming
 <!--NeedCopy-->

Cree una implementación de StoreFront de acceso interno llamando al script de ejemplos anterior. La implementación base se ampliará para admitir el acceso remoto.

 # Create a simple deployment by invoking the SimpleDeployment example
 $scriptDirectory = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
 $scriptPath = Join-Path $scriptDirectory "SimpleDeployment.ps1"
 & $scriptPath -HostbaseUrl $HostbaseUrl -SiteId $SiteId -FarmServers $FarmServers -StoreVirtualPath $StoreVirtualPath -Farmtype $Farmtype \`
     -LoadbalanceServers $LoadbalanceServers -Port $Port  -SSLRelayPort $SSLRelayPort -TransportType $TransportType
 <!--NeedCopy-->

Obtiene los servicios creados en la implementación simple, ya que deben actualizarse para admitir el escenario de acceso remoto.

 # Determine the Authentication and Receiver sites based on the Store
 $store = Get-STFStoreService -VirtualPath $StoreVirtualPath
 $authentication = Get-STFAuthenticationService -StoreService $store
 $receiverForWeb = Get-STFWebReceiverService -StoreService $store
 <!--NeedCopy-->

Habilita CitrixAGBasic en el servicio Citrix Receiver™ para Web, necesario para el acceso remoto mediante Citrix Gateway. Obtenga el método de autenticación CitrixAGBasic y ExplicitForms de Citrix Receiver para Web de los protocolos admitidos.

 # Get the Citrix Receiver for Web CitrixAGBasic and ExplicitForms authentication method from the supported protocols
 # Included for demonstration purposes as the protocol name can be used directly if known
 $receiverMethods = Get-STFWebReceiverAuthenticationMethodsAvailable | Where-Object { $_ -match "Explicit" -or $_ -match "CitrixAG" }
 # Enable CitrixAGBasic in Receiver for Web (required for remote access)
 Set-STFWebReceiverService $receiverForWeb -AuthenticationMethods $receiverMethods
 <!--NeedCopy-->

Habilita CitrixAGBasic en el servicio de autenticación. Esto es necesario para el acceso remoto.

 # Get the CitrixAGBasic authentication method from the protocols installed.
 # Included for demonstration purposes as the protocol name can be used directly if known
 $citrixAGBasic = Get-STFAuthenticationProtocolsAvailable | Where-Object { $_ -match "CitrixAGBasic" }
 # Enable CitrixAGBasic in the Authentication service (required for remote access)
 Enable-STFAuthenticationServiceProtocol -AuthenticationService $authentication -Name $citrixAGBasic
 <!--NeedCopy-->

Agrega una nueva puerta de enlace de acceso remoto, se proporciona la dirección IP de subred opcional y la registra en el almacén para que se acceda a ella de forma remota.

 # Add a new Gateway used to access the new store remotely
 Add-STFRoamingGateway -Name "NetScaler10x" -LogonType Domain -Version Version10_0_69_4 -GatewayUrl $GatewayUrl `
     -CallbackUrl $GatewayCallbackUrl -SecureTicketAuthorityUrls $GatewaySTAUrls
 # Get the new Gateway from the configuration (Add-STFRoamingGateway will return the new Gateway if -PassThru is supplied as a parameter)
 $gateway = Get-STFRoamingGateway -Name $GatewayName
 # If the gateway subnet was provided then set it on the gateway object
 if($GatewaySubnetIP)
 {
     Set-STFRoamingGateway -Gateway $gateway -SubnetIPAddress $GatewaySubnetIP
 }
 # Register the Gateway with the new Store
 Register-STFStoreGateway -Gateway $gateway -StoreService $store -DefaultGateway
 <!--NeedCopy-->

Ejemplo: Crear una implementación de acceso remoto con puerta de enlace de inicio óptimo

El siguiente ejemplo se basa en el script anterior para agregar una implementación con acceso remoto a la puerta de enlace de inicio óptimo.

Antes de empezar, asegúrese de seguir los pasos detallados en Introducción. Este ejemplo se puede personalizar utilizando los métodos descritos para producir un script para automatizar la implementación de StoreFront.

Comprender el script

Esta sección explica lo que hace cada parte del script producido por StoreFront. Esto le ayudará con la personalización de su propio script.

Establece los requisitos de gestión de errores e importa los módulos de StoreFront necesarios. Las importaciones no son necesarias en las versiones modernas de PowerShell.

 Param(
     [Parameter(Mandatory=$true)]
     [Uri]$HostbaseUrl,
     [long]$SiteId = 1,
     [string]$Farmtype = "XenDesktop",
     [Parameter(Mandatory=$true)]
     [string[]]$FarmServers,
     [string]$StoreVirtualPath = "/Citrix/Store",
     [bool]$LoadbalanceServers = $false,
     [int]$Port = 80,
     [int]$SSLRelayPort = 443,
     [ValidateSet("HTTP","HTTPS","SSL")]
     [string]$TransportType = "HTTP",
     [Parameter(Mandatory=$true)]
     [Uri]$GatewayUrl,
     [Parameter(Mandatory=$true)]
     [Uri]$GatewayCallbackUrl,
     [Parameter(Mandatory=$true)]
     [string[]]$GatewaySTAUrls,
     [string]$GatewaySubnetIP,
     [Parameter(Mandatory=$true)]
     [string]$GatewayName,
     [Parameter(Mandatory=$true)]
     [Uri]$OptimalGatewayUrl,
     [Parameter(Mandatory=$true)]
     [string[]]$OptimalGatewaySTAUrls,
     [Parameter(Mandatory=$true)]
     [string]$OptimalGatewayName
 )
 Set-StrictMode -Version 2.0
 # Any failure is a terminating failure.
 $ErrorActionPreference = 'Stop'
 $ReportErrorShowStackTrace = $true
 $ReportErrorShowInnerException = $true
 # Import StoreFront modules. Required for versions of PowerShell earlier than 3.0 that do not support autoloading
 Import-Module Citrix.StoreFront
 Import-Module Citrix.StoreFront.Stores
 Import-Module Citrix.StoreFront.Roaming
 <!--NeedCopy-->

Llama al script de implementación de acceso remoto para configurar la implementación básica y agregar acceso remoto.

 # Create a remote access deployment
 $scriptDirectory = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
 $scriptPath = Join-Path $scriptDirectory "RemoteAccessDeployment.ps1"
 & $scriptPath -HostbaseUrl $HostbaseUrl -SiteId $SiteId -FarmServers $FarmServers -StoreVirtualPath $StoreVirtualPath -Farmtype $Farmtype `
     -LoadbalanceServers $LoadbalanceServers -Port $Port  -SSLRelayPort $SSLRelayPort -TransportType $TransportType `
     -GatewayUrl $GatewayUrl -GatewayCallbackUrl $GatewayCallbackUrl -GatewaySTAUrls $GatewaySTAUrls -GatewayName $GatewayName
 <!--NeedCopy-->

Agrega la puerta de enlace de inicio óptimo preferida y la obtiene de la lista de puertas de enlace configuradas.

 # Add a new Gateway used for remote HDX access to desktops and apps
 $gateway = Add-STFRoamingGateway -Name $OptimalGatewayName -LogonType UsedForHDXOnly -GatewayUrl $OptimalGatewayUrl -SecureTicketAuthorityUrls $OptimalGatewaySTAUrls -PassThru
 <!--NeedCopy-->

Obtiene el servicio de almacén para usar la puerta de enlace óptima, lo registra asignándolo a los inicios desde el sitio nombrado.

 # Get the Store configured by SimpleDeployment.ps1
 $store = Get-STFStoreService -VirtualPath $StoreVirtualPath
 # Register the Gateway with the new Store for launch against all of the farms (currently just one)
 $farmNames = @($store.FarmsConfiguration.Farms | foreach { $_.FarmName })
 Register-STFStoreOptimalLaunchGateway -Gateway $gateway -StoreService $store -FarmName $farmNames
 <!--NeedCopy-->

La documentación oficial de este producto está en inglés. Las versiones en otros idiomas se ofrecen solo como referencia y pueden incluir contenido traducido de forma automática. Para obtener más información, consulte la cláusula de exención de responsabilidad sobre traducción automática en Cloud Software Group home.

¿Le ha resultado útil?

Módulos de PowerShell de StoreFront

July 2, 2026

Contribución de:

July 2, 2026

Contribución de:

¿Le ha resultado útil?