Configure user access
Sep 13, 2016
This article contains the following information:
Configure support for connections through XenApp Services URLs
Disable workspace control reconnect for all Citrix Receivers
Configure user subscriptions
Manage subscription data
Configure support for connections through XenApp Services URLs
Use the Configure XenApp Services Support task to configure access to your stores through XenApp Services URLs. Users of domain-joined desktop appliances and repurposed PCs running the Citrix Desktop Lock, along with users who have older
Citrix clients that cannot be upgraded, can access stores directly using the XenApp Services URL for the store. When you create a new store, the XenApp Services URL is enabled by default.
Important: In multiple server deployments, use only one server at a time to make changes to the configuration of the server group. Ensure that the Citrix StoreFront management console is not running on any of the other servers in the deployment. Once complete, propagate your configuration changes to the server group so that the other servers in the deployment are updated.
1. On the Windows Start screen or Apps screen, locate and click the Citrix StoreFront tile.
2. Select the Stores node in the left pane of the Citrix StoreFront management console and, in the results pane, select a store. In the Actions pane, click Configure XenApp Services Support.
3. Select or clear the Enable XenApp Services Support check box to, respectively, enable or disable user access to the store through the displayed XenApp Services URL.
The XenApp Services URL for a store has the form http[s]:
//serveraddress/Citrix/storename/PNAgent/config.xml
, where
serveraddress
is the fully qualified domain name of the server or load balancing environment for your StoreFront deployment and
storename
is the name specified for the store when it was created.
4. If you enable XenApp Services Support, optionally specify a default store in your StoreFront deployment for users with the Citrix Online Plug-in.
Specify a default store so that your users can configure the Citrix Online Plug-in with the server URL or load-balanced
URL of the StoreFront deployment, rather than the XenApp Services URL for a particular store.
Disable workspace control reconnect for all Citrix Receivers
Workspace control enables applications to follow users as they move between devices. This allows, for example, clinicians in hospitals to move from workstation to workstation without having to restart their applications on each device.
StoreFront contains a configuration to disable workspace control reconnect in the Store Service for all Citrix Receivers.
Manage this feature by using the StoreFront console or PowerShell.
Use the StoreFront management console
1. On the Windows Start screen or Apps screen, locate and click the Citrix StoreFront tile.
https://docs.citrix.com
© 1999-2017 Citrix Systems, Inc. All rights reserved.
p.117
2. Select the Stores node in the left pane of the Citrix StoreFront management console and, in the Actions pane, click Configure Store Settings.
3. Select Advanced Settings and check or uncheck Allow session reconnect.
Use PowerShell
Make sure that you close the Administration Console. Run the following code snippet to import the StoreFront PowerShell modules:
$dsInstallProp = Get-ItemProperty `
-Path HKLM:\SOFTWARE\Citrix\DeliveryServicesManagement -Name InstallDir
$dsInstallDir = $dsInstallProp.InstallDir
& $dsInstallDir\..\Scripts\ImportModules.ps1
Then the PowerShell command Set-DSAllowSessionReconnect turns Workspace control reconnect on or off.
Syntax
Set-DSAllowSessionReconnect [[-SiteId] <Int64>] [[-VirtualPath] <String> ] `
[[-IsAllowed] <Boolean>]
For example, to turn off workspace control reconnect for a store in /Citrix/Store, the following command configures the store:
Set-DSAllowSessionReconnect -SiteId 1 -VirtualPath /Citrix/Store ` -IsAllowed $false
Configure user subscriptions
Use the User Subscriptions task to require users to subscribe to applications before using them or to enable users to receive all applications when they connect to the store.
Important: In multiple server deployments, use only one server at a time to make changes to the configuration of the server group. Ensure that the Citrix StoreFront management console is not running on any of the other servers in the deployment. Once complete, propagate your configuration changes to the server group so that the other servers in the deployment are updated.
1. On the Windows Start screen or Apps screen, locate and click the Citrix StoreFront tile.
2. Select the Stores node in the left pane of the Citrix StoreFront management console and, in the results pane, select a store. In the Actions pane, click Configure Store Settings > User Subscriptions to toggle the user subscriptions feature off or on.
3. Choose Enable user subsciptions (Self Service Store) to make users subscribe to the applications to use them. Any previously specified subscriptions are still available.
4. Choose Disable user subsciptions (Mandatory Store) to make all applications published to the users available on the
Home screen without users subscribing to them. Their subscriptions are not deleted and they can recover them if you reenable the feature.
Manage subscription data
Manage subscription data for a store using PowerShell cmdlets.
Note: The StoreFront and PowerShell consoles cannot be open at the same time. Always close the StoreFront admin console before using the PowerShell console to administer your StoreFront configuration. Likewise, close all instances of https://docs.citrix.com
© 1999-2017 Citrix Systems, Inc. All rights reserved.
p.118
PowerShell before opening the StoreFront console.
Export subscription data
You can create a snapshot of a store's subscription data using the following PowerShell cmdlets to create a subscription data file:
Add-PSSnapin Citrix.DeliveryServices.SubscriptionsManagement.Commands
Export-DSStoreSubscriptions -StoreName StoreName -FilePath DataFile
When managing a multiple-server deployment, you can run these PowerShell cmdlets on any server within the StoreFront server group.
Restore subscription data
You can restore a store's subscription data to a previously saved snapshot using the following PowerShell cmdlets:
Add-PSSnapin Citrix.DeliveryServices.SubscriptionsManagement.Commands
Restore-DSStoreSubscriptions -StoreName StoreName -FilePath DataFile
This command restores the subscription data to the state when the export data file was produced, and it removes any existing subscriptions before adding the subscription data found in the data file.
When managing a multiple-server deployment, you can run these PowerShell cmdlets on any server within the StoreFront server group.
Import subscription data
You can update a store's subscription data from a previously exported data file using the following PowerShell cmdlets:
Add-PSSnapin Citrix.DeliveryServices.SubscriptionsManagement.Commands
Import-DSStoreSubscriptions -StoreName StoreName -FilePath FilePath
This command allows subscription data to be transferred from one store to another, and it retains existing subscriptions before adding/updating subscription data from the imported data file.
When managing a multiple-server deployment, you can run these PowerShell cmdlets on any server within the StoreFront server group.
Purge subscription data for a store
A folder and datastore containing subscription data exists for each store.
1. Stop the Citrix Subscriptions Store service on the StoreFront server.
2. Locate subscription store database folder on each StoreFront server in the new location.
C:\Windows\ServiceProfiles\NetworkService\AppData\Roaming\Citrix\SubscriptionsStore\1__Citrix_<
StoreName
>
3. Delete the contents of this folder, but do not delete the folder.
4. Restart the Citrix Subscriptions Store service on all StoreFront servers in the deployment.
Subscription data file details https://docs.citrix.com
© 1999-2017 Citrix Systems, Inc. All rights reserved.
p.119
The subscription data file is a text file containing one line per user subscription. Each line is a tab-separated sequence of values:
<user-identifier> <resource-id> <subscription-id> <subscription-status> <property-name> <property-value> <propertyname> <property-value>
...
where:
<
user-identifier
> - Required. A sequence of characters identifying the user. This is the user's Windows Security Identifier.
<
resource-id
> - Required. A sequence of characters identifying the subscribed resource.
<
subscription-id
> - Required. A sequence of characters uniquely identifying the subscription. This value is not used
(although, a value must be present in the data file).
<
subscription-status
> - Required. The status of the subscription: subscribed or unsubscribed.
<
property-name
> and <
property-value
> -Optional. A sequence of zero or more pairs of <property-name> and <propertyvalue> values. These represent properties associated with the subscription by a StoreFront client (typically a Citrix
Receiver). A property with multiple values that is represented by multiple name/value pairs with the same name (for example, "… MyProp A MyProp B …." represents the property MyProp with values A, B).
Example:
S-0-0-00-0000000000-0000000000-0000000000-0000 XenApp.Excel 21EC2020-3AEA-4069-A2DD-08002B30309D
Subscribed dazzle:position 1
Size of subscription data on the Storefront server's disk
Size of import and export .txt files https://docs.citrix.com
© 1999-2017 Citrix Systems, Inc. All rights reserved.
p.120
https://docs.citrix.com
© 1999-2017 Citrix Systems, Inc. All rights reserved.
p.121
