StoreFront

Favoriten für einen Store verwalten

Sie können Abonnementdaten (Favoriten) für einen Store mithilfe von PowerShell-Cmdlets verwalten.

Hinweis:

Verwenden Sie entweder die StoreFront-Verwaltungskonsole oder PowerShell zum Verwalten von StoreFront. Verwenden Sie nicht beide Methoden zur gleichen Zeit. Schließen Sie immer erst die StoreFront-Verwaltungskonsole, bevor Sie PowerShell zum Ändern der StoreFront-Konfiguration öffnen. Citrix empfiehlt zudem, ein Backup aller Abonnementdaten zu erstellen, bevor Sie Änderungen vornehmen, damit bei Bedarf ein Rollback auf einen früheren Zustand möglich ist.

Löschen von Abonnementdaten

Für jeden Store in der Bereitstellung gibt es einen Ordner und Datenspeicher mit den Abonnementdaten.

  1. Halten Sie den Citrix Abonnementstoredienst auf dem StoreFront-Server an. Solange der Citrix Abonnementstoredienst ausgeführt wird, können keine Abonnementdaten für einen Store gelöscht werden.
  2. Navigieren Sie auf jedem StoreFront-Server zum Abonnementstoreordner: C:\Windows\ServiceProfiles\NetworkService\AppData\Roaming\Citrix\SubscriptionsStore\1__Citrix_<StoreName>
  3. Löschen Sie den Inhalt des Ordners für den Abonnementstore, jedoch nicht den Ordner selbst.
  4. Starten Sie den Citrix Abonnementstoredienst auf dem StoreFront-Server neu.

In StoreFront 3.5 oder höher können Sie mit dem folgenden PowerShell-Skript Abonnementdaten für einen Store löschen. Zum Ausführen dieser PowerShell-Funktion benötigen Sie Administratorrechte zum Beenden oder Starten von Diensten und zum Löschen von Dateien. Diese PowerShell-Funktion führt zum selben Ergebnis wie die oben beschriebene manuelle Schrittfolge.

Um die Cmdlets erfolgreich auszuführen, muss der Citrix Abonnementstoredienst auf dem Server ausgeführt werden.

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

Exportieren von Abonnementdaten

Mit dem folgenden PowerShell-Cmdlet können Sie Storeabonnementdaten in einer tabulatorgetrennten TXT-Backupdatei sichern.

$StoreObject = Get-STFStoreService -SiteID 1 -VirtualPath "/citrix/<yourstore>"

Export-STFStoreSubscriptions -StoreService $StoreObject -FilePath "$env:USERPROFILE\Desktop\Subscriptions.txt"

In einer Multiserverbereitstellung können Sie dieses PowerShell-Cmdlet auf einem beliebigen Server in der StoreFront-Servergruppe ausführen. Auf jedem Server in der Servergruppe ist eine identische synchronisierte Kopie der Abonnementdaten aller Peers gespeichert. Bei eventuellen Problemen mit der Abonnementsynchronisierung zwischen Storefront-Servern können Sie die Daten aller Server in der Gruppe exportieren und auf Unterschiede überprüfen.

Wiederherstellen von Abonnementdaten

Mit Restore-STFStoreSubscriptions können Sie vorhandene Abonnementdaten überschreiben. Sie können die Abonnementdaten eines Stores mit der tabulatorgetrennten TXT-Backupdatei wiederherstellen, die Sie zuvor mit Export-STFStoreSubscriptions erstellt haben.

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

Weitere Informationen zu Restore-STFStoreSubscriptions finden Sie unter https://developer-docs.citrix.com/en-us/storefront-powershell-sdk/1912/Restore-STFStoreSubscriptions/

Wiederherstellen von Daten auf einem einzelnen StoreFront-Server

In einer Einzelserverbereitstellung ist nicht erforderlich, den Abonnementstoredienst herunterzufahren. Sie müssen auch nicht die vorhandenen Abonnementdaten löschen, bevor Sie die Abonnementdaten wiederherstellen.

Wiederherstellen von Daten in einer StoreFront-Servergruppe

Zum Wiederherstellen von Abonnementdaten in einer Servergruppe sind folgende Schritte erforderlich.

Beispiel einer Servergruppenbereitstellung mit drei StoreFront-Servern.

  • StoreFrontA
  • StoreFrontB
  • StoreFrontC
  1. Erstellen Sie ein Backup der vorhandenen Abonnementdaten von einem der drei Server.
  2. Beenden Sie den Abonnementstoredienst auf den Servern StoreFrontB und C, damit diese Server während der Aktualisierung von StoreFrontA keine Abonnementdaten senden oder empfangen.
  3. Löschen Sie die Abonnementdaten der Server StoreFrontB und C, um Unterschiede zu den wiederhergestellten Abonnementdaten zu vermeiden.
  4. Stellen Sie die Daten auf StoreFrontA mit dem Cmdlet Restore-STFStoreSubscriptions wieder her. Hierfür ist es nicht erforderlich, den Abonnementstoredienst anzuhalten oder Abonnementdaten auf StoreFrontA zu löschen, da diese beim Wiederherstellen überschrieben werden.
  5. Starten Sie den Abonnementstoredienst auf den Servern StoreFrontB und StoreFrontC neu. Die Server können dann eine Kopie der Daten von StoreFrontA erhalten.
  6. Warten Sie, bis die Synchronisierung zwischen allen Servern erfolgt. Die erforderliche Zeit hängt von der Anzahl der Datensätze auf StoreFrontA ab. Wenn alle Server in einem lokalen Netzwerk sind, geschieht die Synchronisierung normalerweise schnell. Die Synchronisierung von Abonnements über eine WAN-Verbindung kann länger dauern.
  7. Exportieren Sie die Daten von StoreFrontB und C, um den Abschluss der Synchronisierung zu bestätigen oder die Gesamtanzahl an Storeabonnements anzuzeigen.

Importieren von Abonnementdaten

Verwenden Sie Import-STFStoreSubscriptions, wenn keine Abonnementdaten für den Store vorhanden sind. Mit diesem Cmdlet können Sie Abonnementdaten auch von einem Store auf einen anderen übertragen oder auf neu bereitgestellte StoreFront-Server importieren.

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

Weitere Informationen zu Import-STFStoreSubscriptions finden Sie unter https://developer-docs.citrix.com/en-us/storefront-powershell-sdk/1912/Import-STFStoreSubscriptions/

Details in der Abonnementdatendatei

Die Abonnementdatendatei ist eine Textdatei mit einer Zeile für jedes Benutzerabonnement. Jede Zeile besteht aus einer Reihe tabulatorgetrennter Werte:

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

Wobei:

  • <user-identifier> - Erforderlich. Zeichenfolge zur Identifizierung des Benutzers. Dies ist die Windows-Sicherheits-ID des Benutzers.
  • <resource-id> - Erforderlich. Zeichenfolge zur Identifizierung der abonnierten Ressource.
  • <subscription-id> - Erforderlich. Zeichenfolge zur eindeutigen Identifizierung des Abonnements. Dieser Wert wird nicht verwendet (er muss jedoch in der Datendatei vorhanden sein).
  • <subscription-status> - Erforderlich. Status des Abonnements: abonniert/nicht abonniert.
  • <property-name> und <property-value> - Optional. Null oder mehr property-name-/property-value-Wertepaare. Diese repräsentieren Eigenschaften eines Abonnements durch einen StoreFront-Client (normalerweise eine Citrix Workspace-App). Eine Eigenschaft mit mehreren Werten, die durch mehrere Namen-/Wert-Paare mit dem gleichen Namen dargestellt wird (z. B. “… MyProp A MyProp B ….” stellt die Eigenschaft “MyProp” mit den Werten “A”, “B” dar).

Beispiel

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

Größe der Abonnementdaten auf dem Datenträger des StoreFront-Servers

Anzahl Datensätze Größe (MB)
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

Größe der TXT-Dateien für den Import und Export

Anzahl Datensätze Größe (MB)
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 1128,00
1.300.000 166,00
1.500.000 192,00
1.700.000 218,00
2.000.000 256,00

Leistungsindikatoren für Storeabonnements

Mit dem Systemmonitor von Microsoft Windows (Start > Ausführen > Perfmon) können Sie die Gesamtanzahl aller Abonnementsdatensätze auf einem Server oder die Zahl der zwischen StoreFront-Servergruppen synchronisierten Datensätze anzeigen.

Anzeige der Abonnementzähler mit 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-->