Documentation produit
StoreFront
Current Release 2402 LTSR 2203 LTSR 1912 LTSR 3.12
Voir PDF

Gérer les données d’abonnement

March 9, 2026
Contributeur: 
C

Si vous utilisez une base de données locale, vous pouvez gérer les favoris d’un magasin à l’aide des cmdlets PowerShell.

Purger les données d’abonnement

Un dossier et un magasin de données contenant les données de favoris existent pour chaque magasin de votre déploiement.

  1. Arrêtez le service Citrix Subscriptions Store sur le serveur StoreFront. Si le service Citrix Subscriptions Store est en cours d’exécution, il n’est pas possible de supprimer les données d’abonnement pour l’un de vos magasins.
  2. Localisez le dossier du magasin d’abonnements sur le serveur StoreFront : C:\Windows\ServiceProfiles\NetworkService\AppData\Roaming\Citrix\SubscriptionsStore\1__Citrix_<StoreName>
  3. Supprimez le contenu du dossier du magasin d’abonnements, mais ne supprimez pas le dossier lui-même.
  4. Redémarrez le service Citrix Subscriptions Store sur le serveur StoreFront.

Vous pouvez utiliser le script PowerShell suivant pour purger les données d’abonnement d’un magasin. Exécutez cette fonction PowerShell en tant qu’administrateur avec les droits d’arrêter ou de démarrer des services et de supprimer des fichiers. Cette fonction PowerShell permet d’obtenir le même résultat que les étapes manuelles décrites ci-dessus.

Pour exécuter les cmdlets avec succès, le service Citrix Subscriptions Store doit être en cours d’exécution sur le serveur.

function Remove-SubscriptionData
{
    [CmdletBinding()]

    [Parameter(Mandatory=$False)][String]$Store = "Store"

    $SubsService = "Citrix Subscriptions Store"

    # Path to Subscription Data in StoreFront version 2.6 or later

    $SubsPath = "C:\Windows\ServiceProfiles\NetworkService\AppData\Roaming\Citrix\SubscriptionsStore\1__Citrix_$Store\*"

    Stop-Service -displayname $SubsService

    Remove-Item $SubsPath -Force -Verbose

    Start-Service -displayname $SubsService

    Get-Service -displayname $SubsService
}

Remove-SubscriptionData -Store "YourStore"
<!--NeedCopy-->

Exporter les données d’abonnement

Vous pouvez obtenir une sauvegarde des données d’abonnement du magasin sous la forme d’un fichier .txt séparé par des tabulations à l’aide de la cmdlet Export-STFStoreSubscriptions, par exemple :

$StoreObject = Get-STFStoreService -SiteID 1 -VirtualPath "/citrix/<yourstore>"
Export-STFStoreSubscriptions -StoreService $StoreObject -FilePath "$env:USERPROFILE\Desktop\Subscriptions.txt"
<!--NeedCopy-->

Si vous gérez un déploiement multi-serveurs, vous pouvez exécuter cette cmdlet PowerShell sur n’importe quel serveur du groupe de serveurs StoreFront. Chaque serveur du groupe de serveurs conserve une copie synchronisée identique des données d’abonnement de ses pairs. Si vous pensez rencontrer des problèmes de synchronisation des abonnements entre les serveurs StoreFront, exportez les données de tous les serveurs du groupe et comparez-les pour voir les différences.

Restaurer les données d’abonnement

Utilisez Restore-STFStoreSubscriptions pour écraser vos données d’abonnement existantes. Vous pouvez restaurer les données d’abonnement d’un magasin à l’aide du fichier de sauvegarde .txt séparé par des tabulations que vous avez créé précédemment avec Export-STFStoreSubscriptions.

$StoreObject = Get-STFStoreService -SiteID 1 -VirtualPath "/citrix/<yourstore>"
Restore-STFStoreSubscriptions -StoreService $StoreObject -FilePath "$env:USERPROFILE\Desktop\Subscriptions.txt"
<!--NeedCopy-->

Pour plus d’informations sur Restore-STFStoreSubscriptions, consultez https://developer-docs.citrix.com/fr-fr/storefront-powershell-sdk/current-release/Restore-STFStoreSubscriptions/

Restauration des données sur un seul serveur StoreFront

Dans un déploiement à serveur unique, il n’est pas nécessaire d’arrêter le service Subscriptions Store. Il n’est pas non plus nécessaire de purger les données d’abonnement existantes avant de restaurer les données d’abonnement.

Restauration des données sur un groupe de serveurs StoreFront

Pour restaurer les données d’abonnement sur un groupe de serveurs, les étapes suivantes sont requises.

Exemple de déploiement de groupe de serveurs contenant trois serveurs StoreFront.

  • StoreFrontA
  • StoreFrontB
  • StoreFrontC
  1. Sauvegardez les données d’abonnement existantes de l’un des trois serveurs.
  2. Arrêtez le service Subscriptions Store sur les serveurs StoreFrontB et C. Cette action empêche les serveurs d’envoyer ou de recevoir des données d’abonnement pendant la mise à jour de StoreFrontA.
  3. Purgez les données d’abonnement des serveurs StoreFrontB et C. Cela évite toute non-concordance des données d’abonnement restaurées.
  4. Restaurez les données sur StoreFrontA à l’aide de la cmdlet Restore-STFStoreSubscriptions. Il n’est pas nécessaire d’arrêter le service Subscriptions Store, ni de purger les données d’abonnement sur StoreFrontA (elles sont écrasées pendant l’opération de restauration).
  5. Redémarrez le service Subscriptions Store sur les serveurs StoreFrontB et StoreFrontC. Les serveurs peuvent alors recevoir une copie des données de StoreFrontA.
  6. Attendez que la synchronisation se produise entre tous les serveurs. Le temps requis dépend du nombre d’enregistrements existant sur StoreFrontA. Si tous les serveurs sont sur une connexion réseau locale, la synchronisation se produit normalement rapidement. La synchronisation des abonnements via une connexion WAN peut prendre plus de temps.
  7. Exportez les données de StoreFrontB et C pour confirmer que la synchronisation est terminée, ou consultez les compteurs d’abonnement du magasin.

Importer les données d’abonnement

Utilisez Import-STFStoreSubscriptions lorsqu’il n’y a pas de données d’abonnement pour le magasin. Cette cmdlet permet également de transférer des données d’abonnement d’un magasin à un autre ou d’importer des données d’abonnement vers des serveurs StoreFront nouvellement provisionnés.

$StoreObject = Get-STFStoreService -SiteID 1 -VirtualPath "/citrix/<yourstore>"
Import-STFStoreSubscriptions -StoreService $StoreObject -FilePath "$env:USERPROFILE\Desktop\Subscriptions.txt"
<!--NeedCopy-->

Pour plus d’informations sur Import-STFStoreSubscriptions, consultez https://developer-docs.citrix.com/fr-fr/storefront-powershell-sdk/current-release/Import-STFStoreSubscriptions/

Détails du fichier de données d’abonnement

Le fichier de données d’abonnement est un fichier texte contenant une ligne par abonnement utilisateur. Chaque ligne est une séquence de valeurs séparées par des tabulations :

<user-identifier> <resource-id> <subscription-id> <subscription-status> <property-name> <property-value> <property-name> <property-value> ...

où :

  • <user-identifier> - Obligatoire. Une séquence de caractères identifiant l’utilisateur. Cet identifiant est l’identifiant de sécurité Windows de l’utilisateur.
  • <resource-id> - Obligatoire. Une séquence de caractères identifiant la ressource abonnée.
  • <subscription-id> - Obligatoire. Une séquence de caractères identifiant de manière unique l’abonnement. Cette valeur n’est pas utilisée (bien qu’une valeur doive être présente dans le fichier de données).
  • <subscription-status> - Obligatoire. Le statut de l’abonnement : abonné ou désabonné.
  • <property-name> et <property-value> - Facultatif. Une séquence de zéro ou plusieurs paires nom/valeur de propriété. Celles-ci représentent les propriétés associées à l’abonnement par un client StoreFront (généralement une application Citrix Workspace). Une propriété avec plusieurs valeurs est représentée par plusieurs paires nom/valeur ayant le même nom (par exemple, « … MyProp A MyProp B … » représente la propriété MyProp avec les valeurs A, B).

Exemple

S-0-0-00-0000000000-0000000000-0000000000-0000 XenApp.Excel 21EC2020-3AEA-4069-A2DD-08002B30309D Subscribed dazzle:position 1

Taille des données d’abonnement sur le disque du serveur StoreFront

Nombre d’enregistrements Taille en Mo
0 6.02
1,000 7.02
10,000 40.00
100,000 219.00
200,000 358.00
500,000 784.00
800,000 1213.02
1,000,000 1597.15
1,300,000 1919.15
1,500,000 2205.15
2,000,000 2915.15

Taille des fichiers .txt d’importation et d’exportation

Nombre d’enregistrements Taille en Mo
0 0.00
1,000 0.13
10,000 1.30
100,000 12.80
200,000 25.60
500,000 64.10
800,000 102.00
1,000,000 128.00
1,300,000 166.00
1,500,000 192.00
1,700,000 218.00
2,000,000 256.00

Compteurs d’abonnement du magasin

Vous pouvez utiliser les compteurs du Moniteur de performances Microsoft Windows (Démarrer > Exécuter > perfmon) pour afficher, par exemple, le nombre total d’enregistrements d’abonnement sur le serveur ou le nombre d’enregistrements synchronisés entre les groupes de serveurs StoreFront.

Afficher les compteurs d’abonnement à l’aide de PowerShell

Get-Counter -Counter "\Citrix Subscription Store(1__citrix_store)\Subscription Entries Count (including unpurged deleted records)"

Get-Counter -Counter "\Citrix Subscription Store Synchronization\Subscriptions Store Synchronizing"

Get-Counter -Counter "\Citrix Subscription Store Synchronization\Number Subscriptions Synchronized"

Get-Counter -Counter "\Citrix Subscription Store Synchronization\Number Subscriptions Transferred"
<!--NeedCopy-->
Gérer les données d’abonnement
March 9, 2026
Contributeur: 
C
March 9, 2026
Contributeur: 
C

Dans cet article

Commentaires sur le site | Your privacy choices footer linkVos préférences de confidentialité | Confidentialité et conditions légales | Préférences de cookies | Paramètres de consentement | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.