XenApp and XenDesktop

Migrieren von XenApp 6.x

Hinweis: Sie können Citrix Smart Migrate nicht mit dieser Version von XenApp und XenDesktop verwenden. Das Migrationstool ist jedoch verfügbar.

Mit dem hier beschriebenen Migrationstool können Sie eine Migration von XenApp 6.x auf XenApp 7.6 durchführen. Anschließend können Sie ein Upgrade von XenApp 7.6 auf ein unterstütztes LTSR oder die aktuelle Citrix Virtual Apps and Desktops-Version durchführen.

XenApp 6.x-Migrationstool

Das XenApp 6.x-Migrationstool ist eine Sammlung von PowerShell-Skripts und Cmdlets, die Richtliniendaten und Farmdaten für XenApp 6.x (6.0 und 6.5) migrieren. Dazu führen Sie auf dem XenApp 6.x-Controllerserver Export-Cmdlets aus, die die Daten in XML-Dateien zusammenfassen. Anschließend führen Sie vom XenApp 7.6-Controller aus die Import-Cmdlets aus, die mit den beim Export gesammelten Daten Objekte erstellen.

Unten ist die Abfolge des Migrationsvorgangs zusammengefasst. Einzelheiten werden später aufgeführt.

  1. Auf einem XenApp 6.0- oder 6.5-Controller:
    1. Importieren Sie die PowerShell-Exportmodule.
    2. Exportieren Sie mit den Export-Cmdlets die Richtlinien- und Farmdaten in XML-Dateien.
    3. Kopieren Sie die XML-Dateien (und den Ordner mit den Symbolen, wenn sie für den Export nicht in die XML-Dateien eingebettet werden) auf den XenApp 7.6-Controller.
  2. Auf dem XenApp 7.6-Controller:
    1. Importieren Sie die PowerShell-Importmodule.
    2. Importieren Sie mit den Import-Cmdlets die Richtlinien- und Farmdaten (Anwendungen), wobei Sie die XML-Dateien als Eingabe verwenden.
  3. Führen Sie die nach der Migration erforderlichen Schritte aus.

Vor der eigentlichen Migration können Sie die XenApp 6.x-Einstellungen exportieren und eine Exportvorschau in der XenApp 7.6-Site ausführen. Die Vorschau lässt mögliche Schwachstellen erkennen, damit Sie die Probleme vor der eigentlichen Migration beheben können. Bei einer Vorschau kann sich beispielsweise herausstellen, dass eine Anwendung mit dem gleichen Namen bereits in der neuen XenApp 7.6-Site vorhanden ist. Sie können die bei der Vorschau erstellten Protokolldateien bei der Migration als Leitfaden verwenden.

Sofern nicht anders angegeben, bezieht sich “6.x” auf XenApp 6.0 oder 6.5.

Neue Features in diesem Release

Dieses Dezember 2014-Release (Version 20141125) enthält die folgenden Updates:

  • Wenn mit den Migrationstools in einer XenApp 6.x-Farm Probleme auftreten, melden Sie dies an https://discussions.citrix.com/forum/1411-xenapp-7x/.
  • Neues Paketformat: Die Datei XAMigration.zip enthält jetzt zwei separate Pakete: ReadIMA.zip und ImportFMA.zip. Zum Exportieren von einem XenApp 6.x-Server benötigen Sie nur ReadIMA.zip. Zum Importieren auf einen XenApp 7.6.x-Server benötigen Sie nur ImportFMA.zip.
  • Das Cmdlet Export-XAFarm unterstützt einen neuen Parameter (EmbedIconData), durch den das Kopieren der Symboldaten in verschiedene Dateien nicht mehr nötig ist.
  • Das Cmdlet Import-XAFarm unterstützt drei neue Parameter:
    • MatchServer - Zum Importieren von Anwendungen von Servern, deren Namen mit einem Ausdruck übereinstimmen
    • NotMatchServer - Zum Importieren von Anwendungen von Servern, deren Namen nicht mit einem Ausdruck übereinstimmen
    • IncludeDisabledApps - Zum Importieren von deaktivierten Anwendungen
  • Vorab gestartete Anwendungen werden nicht importiert.
  • Das Cmdlet Export-Policy ist für XenDesktop 7.x.

Migrationstoolpaket

Das Migrationstool ist auf der Citrix Downloadsite für XenApp 7.6 verfügbar. Die Datei XAMigration.zip enthält zwei separate, unabhängige Pakete:

  • ReadIMA.zip - Enthält die Dateien zum Exportieren von Daten aus der XenApp 6.x-Farm sowie freigegebene Module.
Modul bzw. Datei Beschreibung
ExportPolicy.psm1 PowerShell-Skriptmodul zum Exportieren von XenApp 6.x-Richtlinien in eine XML-Datei.
ExportXAFarm.psm1 PowerShell-Skriptmodul zum Exportieren von XenApp 6.x-Farmeinstellungen in eine XML-Datei.
ExportPolicy.psd1 PowerShell-Manifestdatei für Skriptmodul ExportPolicy.psm1
ExportXAFarm.psd1 PowerShell-Manifestdatei für Skriptmodul ExportXAFarm.psm1
LogUtilities.psm1 Freigegebenes PowerShell-Skriptmodul mit Protokollierungsfunktionen
XmlUtilities.psd1 PowerShell-Manifestdatei für das Skriptmodul XmlUtilities.psm1.
XmlUtilities.psm1 Freigegebenes PowerShell-Skriptmodul mit XML-Funktionen
  • ImportFMA.zip - Enthält die Dateien zum Importieren von Daten aus der XenApp 7.6-Farm sowie freigegebene Module.
Modul bzw. Datei Beschreibung
ImportPolicy.psm1 PowerShell-Skriptmodul zum Importieren von Richtlinien nach XenApp 7.6.
ImportXAFarm.psm1 PowerShell-Skriptmodul zum Importieren von Richtlinien nach XenApp 7.6.
ImportPolicy.psd1 PowerShell-Manifestdatei für Skriptmodul ImportPolicy.psm1
ImportXAFarm.psd1 PowerShell-Manifestdatei für Skriptmodul ImportXAFarm.psm1
PolicyData.xsd XML-Schema für Richtliniendaten.
XAFarmData.xsd XML-Schema für XenApp-Farmdaten.
LogUtilities.psm1 Freigegebenes PowerShell-Skriptmodul mit Protokollierungsfunktionen
XmlUtilities.psd1 PowerShell-Manifestdatei für das Skriptmodul XmlUtilities.psm1.
XmlUtilities.psm1 Freigegebenes PowerShell-Skriptmodul mit XML-Funktionen

Einschränkungen

  • Nicht alle Richtlinieneinstellungen werden importiert. Siehe Nicht importierte Richtlinieneinstellungen. Einstellungen, die nicht unterstützt werden, werden ignoriert und in der Protokolldatei angegeben.
  • Zwar werden alle Anwendungsdetails während des Exportvorgangs in der XML-Ausgabedatei gesammelt, aber nur auf Servern installierte Anwendungen werden in die XenApp 7.6-Site importiert. Veröffentlichte Desktops, Inhalte und die meisten gestreamten Anwendungen werden nicht unterstützt (Informationen zu Ausnahmen finden Sie unter Schrittweise Anleitungen: Importieren von Daten) im Abschnitt zu den Import-XAFarm-Cmdlet-Parametern.
  • Anwendungsserver werden nicht importiert.
  • Viele Anwendungseigenschaften werden nicht importiert wegen der Unterschiede zwischen der XenApp 6.x Independent Management Architecture (IMA) und der XenApp 7.6 FlexCast Management Architecture (FMA). Siehe Zuordnung von Anwendungseigenschaften.
  • Während des Imports wird eine Bereitstellungsgruppe erstellt. Weitere Informationen zum Filtern des importierten Inhalts mit Parametern finden Sie unter Erweiterte Verwendung.
  • Nur Citrix-Richtlinieneinstellungen, die mit der AppCenter-Verwaltungskonsole erstellt wurden, werden importiert. Mit Windows-Gruppenrichtlinienobjekten (GPOs) erstellte Citrix-Richtlinieneinstellungen werden nicht importiert.
  • Die Migrationsskripts sind nur für die Migrationen von XenApp 6.x auf XenApp 7.6 vorgesehen.
  • Mehr als fünffach verschachtelte Ordner werden von Studio nicht unterstützt und werden nicht importiert. Wenn die Ordnerstruktur Ihrer Anwendung Ordner mit mehr als fünf Ebenen von Unterordnern enthält, reduzieren Sie vor dem Importieren die Anzahl der verschachtelten Ordnerebenen.

Sicherheitsüberlegungen

Die durch die Exportskripts erstellten XML-Dateien können vertrauliche Informationen über Ihre Umgebung und Organisation enthalten, z. B. Benutzer- und Servernamen und andere Farm-, Anwendungs- und Richtlinienkonfigurationsdaten. Speichern und verwenden Sie diese Dateien in einer sicheren Umgebung.

Prüfen Sie die XML-Dateien sorgfältig, bevor Sie sie als Eingabe für den Import von Richtlinien und Anwendungen verwenden, um sicherzustellen, dass sie keine unbefugten Änderungen enthalten.

Richtlinienobjektzuweisungen (bisher “Richtlinienfilter”) steuern die Anwendung von Richtlinien. Nach dem Importieren von Richtlinien prüfen Sie die Objektzuweisungen für jede Richtlinie sorgfältig, um sicherzustellen, dass durch den Import keine Sicherheitsrisiken entstanden sind. Nach dem Import können auf die Richtlinie verschiedene Gruppen von Benutzern, IP-Adressen oder Clientnamen angewendet werden. Die Einstellungen zum Zulassen und Verweigern haben möglicherweise nach dem Import eine andere Bedeutung.

Protokollierung und Fehlerbehandlung

Die Skripts sorgen für umfangreiche Protokollierung, wobei die Ausführung aller Cmdlets, informative Meldungen, die Ergebnisse der Cmdlet-Ausführung sowie Warnungen und Fehler aufgezeichnet werden.

  • Die Verwendung der Citrix PowerShell-Cmdlets wird größtenteils protokolliert. Alle PowerShell-Cmdlets in den Importskripts, die neue Siteobjekte erstellen, werden protokolliert.
  • Der Skriptausführungsverlauf wird protokolliert, einschließlich der Objekte, die verarbeitet werden.
  • Große Aktionen, die sich auf den Flussstatus auswirken, werden protokolliert, einschließlich über die Befehlszeile geleitete Flüsse.
  • Alle Meldungen, die auf der Konsole gedruckt werden, einschließlich Warnungen und Fehler werden protokolliert.
  • Jede Zeile wird mit einem Zeitstempel versehen, der auf die Millisekunde genau ist.

Citrix empfiehlt, dass Sie beim Ausführen der Export- und Import-Cmdlets jeweils eine Protokolldatei angeben.

Wenn Sie keinen Protokolldateinamen angeben, wird die Protokolldatei im Basisordner des aktuellen Benutzers (in der PowerShell-Variable $HOME angegeben) gespeichert. Wenn dieser Ordner nicht vorhanden ist, wird die Protokolldatei im aktuellen Ausführungsordner des Skripts gespeichert. Der Standardname der Protokolldatei ist XFarmYYYYMMDDHHmmSS-xxxxxx, wobei die letzten sechs Ziffern eine zufällige Zahl sind.

Standardmäßig werden die gesamten Fortschrittsinformationen angezeigt. Um die Anzeige zu unterdrücken, legen Sie den NoDetails-Parameter in den Export- und Import-Cmdlets fest.

Bei einem Fehler wird die Ausführung eines Skripts im Allgemeinen angehalten. Wenn der Fehler behoben ist, können Sie das Cmdlet noch einmal ausführen.

Bedingungen, die nicht als Fehler gelten, werden protokolliert. Viele werden als Warnungen gemeldet und das Ausführen des Skripts wird fortgesetzt. Beispielsweise werden nicht unterstützte Anwendungstypen als Warnung gemeldet und nicht importiert. Anwendungen, die bereits in der XenApp 7.6-Site vorhanden sind, werden nicht importiert. Richtlinieneinstellungen, die in XenApp 7.6 veraltet sind, werden nicht importiert.

Die Migrationsskripts verwenden viele PowerShell-Cmdlets und nicht alle möglichen Fehler werden protokolliert. Zusätzliche Protokollierungsfunktionen sind mit den PowerShell-Protokollierungsfeatures verfügbar. Beispielsweise wird alles, was auf dem Bildschirm gedruckt wird, in PowerShell-Aufzeichnungen protokolliert. Weitere Informationen finden Sie in der Hilfe zu den Cmdlets Start-Transcript und Stop-Transcript.

Anforderungen, Vorbereitungen und Best Practices

Zur Migration müssen Sie das Citrix XenApp 6.5-SDK verwenden. Laden Sie das SDK von https://www.citrix.com/downloads/xenapp/sdks/powershell-sdk.html herunter.

Lesen Sie den gesamten Artikel, bevor Sie mit der Migration beginnen.

Sie müssen grundlegende PowerShell-Konzepte verstehen. Obwohl umfangreiche Erfahrung mit dem Erstellen von Skripts nicht erforderlich ist, sollten Sie die ausgeführten Cmdlets verstehen. Mit dem Cmdlet Get-Help können Sie sich die Hilfe zu jedem Migrations-Cmdlet ansehen, bevor Sie es ausführen. Beispiel: Get-Help -full Import-XAFarm.

Geben Sie eine Protokolldatei in der Befehlszeile an und überprüfen Sie die Protokolldatei jedes Mal, nachdem Sie ein Cmdlet ausgeführt haben. Wenn ein Skript fehlschlägt, identifizieren Sie den Fehler mit der Protokolldatei und beheben Sie ihn. Führen Sie dann das Cmdlet noch einmal aus.

Nützliche Info:

  • Zur Vereinfachung der Bereitstellung von Anwendungen während der Ausführung beider Bereitstellungen (vorhandene XenApp 6.x-Farm und neue XenApp 7.6-Site) können Sie beide Bereitstellungen in StoreFront oder dem Webinterface aggregieren. Weitere Informationen zu Ihrem StoreFront- oder Webinterface-Release finden Sie in der Produktdokumentation (Verwalten > Store erstellen).
  • Für die Handhabung der Anwendungssymboldaten gibt es zwei Möglichkeiten:
  • Wenn Sie den Parameter EmbedIconData im Cmdlet Export-XAFarm angeben, werden exportierte Anwendungssymboldaten in der XML-Ausgabedatei eingebettet.
  • Wenn Sie den Parameter EmbedIconData im Cmdlet Export-XAFarm nicht angeben, werden exportierte Anwendungssymboldaten werden in einem Ordner gespeichert. Der Name des Ordners wird durch Anfügen der Zeichenfolge -icons an den Basisnamen der XML-Ausgabedatei erstellt. Wenn der Parameter XmlOutputFile beispielsweise FarmData.xml ist, wird der Ordner FarmData-icons zum Speichern der Anwendungssymbole erstellt.

    Bei den Symboldatendateien in diesem Ordner handelt es sich um .txt-Dateien, die mit dem Browsernamen der veröffentlichten Anwendung benannt wurden. Obwohl es .txt-Dateien sind, handelt es sich bei den gespeicherten Daten um codierte binäre Symboldaten, die vom Importskript gelesen werden können, um das Anwendungssymbol neu zu erstellen. Wenn der Symbolordner während des Importvorgangs nicht im selben Verzeichnis gefunden wird wie die XML-Importdatei, werden allgemeine Symbole für die importierten Anwendungen verwendet.

  • Die Namen der Skriptmodule, Manifestdateien, freigegebenen Module und Cmdlets sind ähnlich. Verwenden Sie die Tabulatortaste vorsichtig, damit es nicht zu Fehlern kommt. Zum Beispiel ist Export-XAFarm ein Cmdlet. ExportXAFarm.psd1 und ExportXAFarm.psm1 sind Dateien, die nicht ausgeführt werden können.
  • In den nachfolgenden Anleitungen sind die meisten Parameterwerte für <string> mit Anführungszeichen umschlossen. Diese sind optional für Zeichenfolgen, die nur aus einem Wort bestehen.

Für den Export des XenApp 6.x-Servers gilt Folgendes:

  • Der Export muss auf einem XenApp 6.x-Server ausgeführt werden, der mit dem Servermodus “Controller- und Sitzungshostmodus” (üblicherweise “Controller”) konfiguriert wurde.
  • Zum Ausführen der Export-Cmdlets müssen Sie XenApp-Administrator mit der Berechtigung zum Lesen von Objekten sein. Sie müssen auch über die erforderlichen Berechtigungen zum Ausführen von Windows-PowerShell-Skripts verfügen. Die schrittweisen Verfahren enthalten Anweisungen.
  • Stellen Sie sicher, dass die XenApp 6.x-Farm funktionsfähig ist, bevor Sie mit dem Export beginnen. Erstellen Sie ein Backup der Farmdatenbank. Überprüfen Sie die Integrität der Farm mit dem Hilfsprogramm “Citrix IMA Helper” (CTX133983): Führen Sie von der Registerkarte für den IMA Datastore aus einen Master Check aus (und lösen Sie alle ungültigen Einträge mit der Option DSCheck auf). Durch das Reparieren von Problemen vor der Migration werden Fehler beim Export vermieden.

    Wenn ein Server beispielsweise nicht richtig aus der Farm entfernt wird, bleiben seine Daten möglicherweise in der Datenbank vorhanden, was zu Fehlern bei den Cmdlets im Exportskript führen kann (z. B. Get-XAServer -ZoneName). Wenn die Cmdlets fehlschlagen, schlägt das Skript fehl.

  • Sie können die Export-Cmdlets in einer Farm mit aktiven Benutzerverbindungen ausführen. Die Exportskripte lesen nur die statische Farmkonfiguration und die Richtliniendaten.

Für den Import auf den XenApp 7.6-Server gilt Folgendes:

  • Sie können Daten in XenApp 7.6-Bereitstellungen (und höhere unterstützte Versionen) importieren. Sie müssen einen XenApp 7.6-Controller und Studio installieren und eine Site erstellen, bevor Sie die aus der XenApp 6.x-Farm exportierten Daten importieren. VDAs sind zwar zum Importieren von Einstellungen nicht erforderlich, sie gestatten jedoch das Verfügbarmachen von Anwendungsdateitypen.
  • Zum Ausführen der Import-Cmdlets müssen Sie XenApp-Administrator mit der Berechtigung zum Lesen und Erstellen von Objekten sein. Ein Volladministrator hat diese Berechtigungen. Sie müssen auch über die erforderlichen Berechtigungen zum Ausführen von Windows-PowerShell-Skripts verfügen. Die schrittweisen Verfahren enthalten Anweisungen.
  • Während eines Imports dürfen keine anderen Benutzerverbindungen aktiv sein. Die Importskripts erstellen viele neue Objekte und wenn andere Benutzer gleichzeitig Änderungen an der Konfiguration vornehmen, können Unterbrechungen auftreten.

Sie können Daten exportieren und dann den Parameter -Preview für das Import-Cmdlet verwenden, um eine Vorschau des Imports zu sehen, ohne dass tatsächliche Importvorgänge stattfinden. Die Protokolle zeigen genau an, was während eines Imports passieren würde. Wenn Fehler auftreten, können Sie sie beheben, bevor Sie den Import starten.

Schrittweise Anleitungen: Exportieren von Daten

Führen Sie die folgenden Schritte aus, um Daten aus einem XenApp 6.x-Controller in XML-Dateien zu exportieren.

  1. Laden Sie das Paket mit dem Migrationstool (XAMigration.zip) von der Citrix Downloadsite herunter. Speichern Sie es der Einfachheit halber in einer Netzwerkfreigabe, damit von der XenApp 6.x-Farm und der XenApp 7.6-Site darauf zugegriffen werden kann. Entzippen Sie XAMigration.zip in der Netzwerkfreigabe. Es gibt zwei ZIP-Dateien: ReadIMA.zip und ImportFMA.zip.

  2. Melden Sie sich am XenApp 6.x-Controller als XenApp-Administrator mit mindestens Lesezugriff und Windows-Berechtigung zum Ausführen von PowerShell-Skripts an.

  3. Kopieren Sie die Datei ReadIMA.zip von der Netzwerkfreigabe auf den XenApp 6.x-Controller. Entzippen und extrahieren Sie ReadIMA.zip auf dem Controller in einen Ordner (z. B. C:\XAMigration).

  4. Öffnen Sie eine PowerShell-Konsole und legen Sie das aktuelle Verzeichnis als Skriptspeicherort fest (z. B. cd C:\XAMigration).

  5. Überprüfen Sie die Skriptausführungsrichtlinie durch Ausführen von Get-ExecutionPolicy.

  6. Legen Sie die Skriptausführungsrichtlinie mindestens auf RemoteSigned fest, damit die Skripts ausgeführt werden können (z. B. Set-ExecutionPolicy RemoteSigned).

  7. Importieren Sie die Moduldefinitionsdateien ExportPolicy.psd1 und ExportXAFarm.psd1:

    Import-Module .\ExportPolicy.psd1

    Import-Module .\ExportXAFarm.psd1

    Nützliche Info:

    • Wenn Sie nur Richtliniendaten exportieren möchten, können Sie nur die Moduldefinitionsdatei ExportPolicy.psd1 importieren. Genauso gilt, wenn Sie nur Farmdaten importieren möchten, importieren Sie nur ExportXAFarm.psd1.
    • Beim Importieren der Moduldefinitionsdateien werden auch die erforderlichen PowerShell-Snap-Ins hinzugefügt.
    • Importieren Sie nicht die Skriptdateien mit der Erweiterung .psm1.
  8. Führen Sie zum Exportieren von Richtliniendaten das Cmdlet Export-Policy aus.

    Parameter Beschreibung
    -XmlOutputFile “.xml" XML-Ausgabedateiname. Diese Datei enthält die exportierten Daten. Sie muss die Erweiterung .xml haben. Die Datei darf nicht vorhanden sein, aber wenn Sie den Pfad angeben, muss der übergeordnete Pfad vorhanden sein. Standard: Ohne. Dieser Parameter ist erforderlich.
    -LogFile “" Name der Protokolldatei. Eine Erweiterung ist optional. Die Datei wird erstellt, wenn sie nicht vorhanden ist. Wenn die Datei vorhanden ist und der Parameter “NoClobber” angegeben ist, wird ein Fehler generiert. Andernfalls wird der Inhalt der Datei überschrieben. Standardwert: siehe Protokollierung und Fehlerbehandlung.
    -NoLog Keine Protokollausgabe erstellen. Dieser Parameter überschreibt den Parameter “LogFile”, wenn er ebenfalls angegeben ist. Standard: False Die Protokollausgabe wird generiert.
    -NoClobber Vorhandene Protokolldatei, die im Parameter “LogFile” angegeben wurde, nicht überschreiben. Wenn die Protokolldatei nicht vorhanden ist, hat dieser Parameter keine Auswirkung. Standard: False Eine vorhandene Protokolldatei wird überschrieben.
    -NoDetails Keine ausführlichen Berichte zur Skriptausführung an die Konsole senden. Standard: False Ausführliche Berichte werden an die Konsole gesendet.
    -SuppressLogo Drucken Sie die Meldung XenApp 6.x to XenApp/XenDesktop 7.6 Migration Tool Version #yyyyMMdd-hhmm# nicht zu der Konsole. Diese Meldung, in der die Skriptversion angegeben wird, kann bei der Problembehandlung hilfreich sein. Citrix empfiehlt daher, diesen Parameter wegzulassen. Standard: False Die Meldung wird zu der Konsole gedruckt.

    Beispiel: Das folgende Cmdlet exportiert Richtlinieninformationen in die XML-Datei MyPolicies. Der Vorgang wird in der Datei MyPolicies.log protokolliert.

    Export-Policy -XmlOutputFile ".\MyPolicies.XML" -LogFile ".\MyPolicies.Log"
    <!--NeedCopy-->
    
  9. Führen Sie zum Exportieren von Farmdaten das Cmdlet Export-XAFarm aus und geben Sie dabei eine Protokolldatei und eine XML-Datei an.

Parameter Beschreibung
-XmlOutputFile “.xml" XML-Ausgabedateiname. Diese Datei enthält die exportierten Daten. Sie muss die Erweiterung .xml haben. Die Datei darf nicht vorhanden sein, aber wenn Sie den Pfad angeben, muss der übergeordnete Pfad vorhanden sein. Standard: Ohne. Dieser Parameter ist erforderlich.
-LogFile “" Name der Protokolldatei. Eine Erweiterung ist optional. Die Datei wird erstellt, wenn sie nicht vorhanden ist. Wenn die Datei vorhanden ist und der Parameter “NoClobber” angegeben ist, wird ein Fehler generiert. Andernfalls wird der Inhalt der Datei überschrieben. Standardwert: siehe Protokollierung und Fehlerbehandlung.
-NoLog Keine Protokollausgabe erstellen. Dieser Parameter überschreibt den Parameter “LogFile”, wenn er ebenfalls angegeben ist. Standard: False Die Protokollausgabe wird generiert.
-NoClobber Vorhandene Protokolldatei, die im Parameter “LogFile” angegeben wurde, nicht überschreiben. Wenn die Protokolldatei nicht vorhanden ist, hat dieser Parameter keine Auswirkung. Standard: False Eine vorhandene Protokolldatei wird überschrieben.
-NoDetails Keine ausführlichen Berichte zur Skriptausführung an die Konsole senden. Standard: False Ausführliche Berichte werden an die Konsole gesendet.
-SuppressLogo Drucken Sie die Meldung XenApp 6.x to XenApp/XenDesktop 7.6 Migration Tool Version #yyyyMMdd-hhmm# nicht zu der Konsole. Diese Meldung, in der die Skriptversion angegeben wird, kann bei der Problembehandlung hilfreich sein. Citrix empfiehlt daher, diesen Parameter wegzulassen. Standard: False Die Meldung wird zu der Konsole gedruckt.
-IgnoreAdmins Administratorinformationen nicht exportieren. Informationen zur Verwendung finden Sie unter Erweiterte Verwendung. Standard: False Administratorinformationen werden exportiert.
-IgnoreApps Anwendungsinformationen nicht exportieren. Informationen zur Verwendung finden Sie unter Erweiterte Verwendung. Standard: False Anwendungsinformationen werden exportiert.
-IgnoreServers Serverinformationen nicht exportieren. Standard: False Serverinformationen werden exportiert.
-IgnoreZones Zoneninformationen nicht exportieren. Standard: False Zoneninformationen werden exportiert.
-IgnoreOthers Daten wie Folgende nicht exportieren: Konfigurationsprotokollierung, Lastauswertungsprogramme, Lastausgleichsrichtlinien, Druckertreiber und Workergruppen. Standard: False Andere Informationen werden exportiert. Hinweis: Mit diesem Schalter können Sie mit einem Export fortfahren, wenn ein Fehler auftritt, der sich nicht auf die tatsächlichen Daten auswirkt, die für den Export- oder Importvorgang verwendet werden.
-AppLimit Anzahl der Anwendungen, die exportiert werden. Informationen zur Verwendung finden Sie unter Erweiterte Verwendung. Standardwert: Alle Anwendungen werden exportiert.
-EmbedIconData Anwendungssymboldaten in die gleiche XML-Datei einbetten wie die anderen Objekte. Standard: Symbole werden separat gespeichert. Einzelheiten finden Sie unter Anforderungen, Vorbereitungen und Best Practices.
-SkipApps Anzahl der Anwendungen, die übersprungen werden. Informationen zur Verwendung finden Sie unter Erweiterte Verwendung. Standardwert: Keine Anwendungen werden übersprungen.
Example: The following cmdlet exports farm information to the XML file named MyFarm.xml. The operation is logged to the file MyFarm.log. A folder named "MyFarm-icons" is created to store the application icon data files. This folder is at the same location as MyFarm.XML.

`Export-XAFarm -XmlOutputFile ".\MyFarm.XML" -LogFile ".\MyFarm.Log"`

Nachdem die Ausführung der Exportskripts abgeschlossen ist, enthalten die in den Befehlszeilen angegebenen XML-Dateien die Richtliniendaten und die XenApp-Farmdaten. Die Anwendungssymboldateien enthalten die Symboldatendateien und die Protokolldatei gibt an, was sich beim Export ereignet hat.

Schrittweise Anleitungen: Importieren von Daten

Denken Sie daran, dass Sie einen Vorschauimport ausführen können (indem Sie das Cmdlet Import-Policy oder Import-XAFarm mit dem Parameter Preview ausführen). Sie können dann die Protokolldateien überprüfen, bevor Sie einen tatsächlichen Import durchführen.

Führen Sie die folgenden Schritte aus, um Daten mit den beim Export erstellten XML-Dateien in eine XenApp 7.6-Site zu importieren.

  1. Melden Sie sich als Administrator mit Lese- und Schreibrechten und Windows-Berechtigung zum Ausführen von PowerShell-Skripts am XenApp 7.6-Controller an.

  2. Wenn Sie das Paket mit dem Migrationstool (XAMigration) noch nicht in der Netzwerkfreigabe entzippt haben, führen Sie den Vorgang nun aus. Kopieren Sie die Datei ImportFMA.zip von der Netzwerkfreigabe auf den XenApp 7.6-Controller. Entzippen und extrahieren Sie ImportFMA.zip auf dem Controller in einen Ordner (z. B. C:\XAMigration).

  3. Kopieren Sie die XML-Dateien (die während des Exports erstellten Ausgabedateien) vom XenApp 6.x-Controller in den Speicherort auf dem XenApp 7.6-Controller, wo Sie die Dateien aus ImportFMA.zip extrahiert haben.

    Wenn Sie die Anwendungssymboldaten beim Ausführen des Cmdlets Export-XAFarm nicht in die XML-Ausgabedatei eingebettet haben, kopieren Sie den Ordner mit den Symboldaten in den gleichen Speicherort auf dem XenApp 7.6-Controller, in den Sie die XML-Ausgabedateien kopiert haben und in dem die extrahierten Dateien aus ImportFMA.zip sind.

  4. Öffnen Sie eine PowerShell-Konsole und legen Sie das aktuelle Verzeichnis als Skriptspeicherort fest (z. B. cd C:\XAMigration).

  5. Überprüfen Sie die Skriptausführungsrichtlinie durch Ausführen von Get-ExecutionPolicy.

  6. Legen Sie die Skriptausführungsrichtlinie mindestens auf RemoteSigned fest, damit die Skripts ausgeführt werden können (z. B. Set-ExecutionPolicy RemoteSigned).

  7. Importieren Sie die PowerShell-Moduldefinitionsdateien ImportPolicy.psd1 und ImportXAFarm.psd1:

    Import-Module .\ImportPolicy.psd1

    Import-Module .\ImportXAFarm.psd1

    Nützliche Info:

    • Wenn Sie nur Richtliniendaten importieren möchten, können Sie nur die Moduldefinitionsdatei ImportPolicy.psd1 importieren. Genauso gilt, wenn Sie nur Farmdaten importieren möchten, importieren Sie nur ImportXAFarm.psd1.
    • Beim Importieren der Moduldefinitionsdateien werden auch die erforderlichen PowerShell-Snap-Ins hinzugefügt.
    • Importieren Sie nicht die Skriptdateien mit der Erweiterung .psm1.
  8. Wenn Sie Richtliniendaten importieren, führen Sie das Cmdlet Import-Policy aus. Geben Sie dabei die XML-Datei mit den exportierten Richtliniendaten an.

    Parameter Beschreibung
    -XmlInputFile “.xml" XML-Eingabedateiname. Diese Datei enthält Daten, die beim Ausführen des Cmdlets Export-Policy gesammelt wurden. Die Erweiterung muss .xml sein. Standard: Ohne. Dieser Parameter ist erforderlich.
    -XsdFile “" Name der XSD-Datei. Mit dieser Datei überprüfen die Importskripts die Syntax der XML-Eingabedatei. Informationen zur Verwendung finden Sie unter Erweiterte Verwendung. Standardwert: PolicyData.XSD
    -LogFile “" Name der Protokolldatei. Wenn Sie Exportprotokolldateien auf diesen Server kopiert haben, sollten Sie einen anderen Namen für die Protokolldatei des Import-Cmdlets verwenden. Standardwert: siehe Protokollierung und Fehlerbehandlung.
    -NoLog Keine Protokollausgabe erstellen. Dieser Parameter überschreibt den Parameter “LogFile”, wenn er ebenfalls angegeben ist. Standard: False Die Protokollausgabe wird generiert.
    -NoClobber Vorhandene Protokolldatei, die im Parameter “LogFile” angegeben wurde, nicht überschreiben. Wenn die Protokolldatei nicht vorhanden ist, hat dieser Parameter keine Auswirkung. Standard: False Eine vorhandene Protokolldatei wird überschrieben.
    -NoDetails Keine ausführlichen Berichte zur Skriptausführung an die Konsole senden. Standard: False Ausführliche Berichte werden an die Konsole gesendet.
    -SuppressLogo Drucken Sie die Meldung XenApp 6.x to XenApp/XenDesktop 7.6 Migration Tool Version #yyyyMMdd-hhmm# nicht zu der Konsole. Diese Meldung, in der die Skriptversion angegeben wird, kann bei der Problembehandlung hilfreich sein. Citrix empfiehlt daher, diesen Parameter wegzulassen. Standard: False Die Meldung wird zu der Konsole gedruckt.
    -Preview Führen Sie eine Importvorschau aus: Daten werden aus der XML-Eingabedatei gelesen, aber es werden keine Objekte in die Site importiert. In der Protokolldatei und Konsole wird protokolliert, was während der Importvorschau vorgegangen ist. Eine Vorschau zeigt Administratoren, was während eines echten Imports passieren würde. Standard: False Es findet ein echter Import statt.

    Beispiel: Mit dem folgenden Cmdlet werden Richtliniendaten aus der XML-Datei MyPolcies.xml importiert. Der Vorgang wird in der Datei MyPolicies.log protokolliert.

    Import-Policy -XmlInputFile ".\MyPolicies.XML"
    -LogFile ".\MyPolicies.Log"
    <!--NeedCopy-->
    
  9. Wenn Sie Anwendungen importieren, führen Sie das Cmdlet Import-XAFarm aus. Geben Sie dabei eine Protokolldatei und die XML-Datei mit den exportierten Farmdaten an.

    Parameter Beschreibung
    -XmlInputFile “.xml" XML-Eingabedateiname. Diese Datei enthält Daten, die mit dem Cmdlet “Export-XAFarm” gesammelt wurden. Sie muss die Erweiterung .xml haben. Standard: Ohne. Dieser Parameter ist erforderlich.
    -XsdFile “" Name der XSD-Datei. Mit dieser Datei überprüfen die Importskripts die Syntax der XML-Eingabedatei. Informationen zur Verwendung finden Sie unter Erweiterte Verwendung. Standardwert: XAFarmData.XSD
    -LogFile “" Name der Protokolldatei. Wenn Sie Exportprotokolldateien auf diesen Server kopiert haben, sollten Sie einen anderen Namen für die Protokolldatei des Import-Cmdlets verwenden. Standardwert: siehe Protokollierung und Fehlerbehandlung.
    -NoLog Keine Protokollausgabe erstellen. Dieser Parameter überschreibt den Parameter “LogFile”, wenn er ebenfalls angegeben ist. Standard: False Die Protokollausgabe wird generiert.
    -NoClobber Vorhandene Protokolldatei, die im Parameter “LogFile” angegeben wurde, nicht überschreiben. Wenn die Protokolldatei nicht vorhanden ist, hat dieser Parameter keine Auswirkung. Standard: False Eine vorhandene Protokolldatei wird überschrieben.
    -NoDetails Keine ausführlichen Berichte zur Skriptausführung an die Konsole senden. Standard: False Ausführliche Berichte werden an die Konsole gesendet.
    -SuppressLogo Drucken Sie die Meldung XenApp 6.x to XenApp/XenDesktop 7.6 Migration Tool Version #yyyyMMdd-hhmm# nicht zu der Konsole. Diese Meldung, in der die Skriptversion angegeben wird, kann bei der Problembehandlung hilfreich sein. Citrix empfiehlt daher, diesen Parameter wegzulassen. Standard: False Die Meldung wird zu der Konsole gedruckt.
    -Preview Führen Sie eine Importvorschau aus: Daten werden aus der XML-Eingabedatei gelesen, aber es werden keine Objekte in die Site importiert. In der Protokolldatei und Konsole wird protokolliert, was während der Importvorschau vorgegangen ist. Eine Vorschau zeigt Administratoren, was während eines echten Imports passieren würde. Standard: False Es findet ein echter Import statt.
    -DeliveryGroupName “" Bereitstellungsgruppenname für alle importierten Anwendungen. Informationen zur Verwendung finden Sie unter Erweiterte Verwendung. Standard: “ -Delivery Group”
    -MatchFolder “" Import von Anwendungen in Ordnern, deren Namen mit der Zeichenfolge (String) übereinstimmen. Informationen zur Verwendung finden Sie unter Erweiterte Verwendung. Standardwert: Keine Übereinstimmung.
    -NotMatchFolder “" Import von Anwendungen in Ordnern, deren Namen mit der Zeichenfolge (String) nicht übereinstimmen. Informationen zur Verwendung finden Sie unter Erweiterte Verwendung. Standardwert: Keine Übereinstimmung.
    -MatchServer “" Import von Anwendungen auf Servern, deren Namen mit der Zeichenfolge (String) übereinstimmen. Informationen zur Verwendung finden Sie unter Erweiterte Verwendung.
    -NotMatchServer “" Import von Anwendungen auf Servern, deren Namen nicht mit der Zeichenfolge (String) übereinstimmen. Informationen zur Verwendung finden Sie unter Erweiterte Verwendung. Standardwert: Keine Übereinstimmung.
    -MatchWorkerGroup “" Import von Anwendungen, die für Workergruppen veröffentlicht wurden und deren Namen mit der Zeichenfolge (String) übereinstimmen. Informationen zur Verwendung finden Sie unter Erweiterte Verwendung. Standardwert: Keine Übereinstimmung.
    -NotMatchWorkerGroup “" Import von Anwendungen, die für Workergruppen veröffentlicht wurden und deren Namen nicht mit der Zeichenfolge (String) übereinstimmen. Informationen zur Verwendung finden Sie unter Erweiterte Verwendung. Standardwert: Keine Übereinstimmung.
    -MatchAccount “" Import von Anwendungen, die für Benutzerkonten veröffentlicht wurden und deren Namen mit der Zeichenfolge (String) übereinstimmen. Informationen zur Verwendung finden Sie unter Erweiterte Verwendung. Standardwert: Keine Übereinstimmung.
    -NotMatchAccount “" Import von Anwendungen, die für Benutzerkonten veröffentlicht wurden und deren Namen nicht mit der Zeichenfolge (String) übereinstimmen. Informationen zur Verwendung finden Sie unter Erweiterte Verwendung. Standardwert: Keine Übereinstimmung.
    -IncludeStreamedApps Importieren Sie Anwendungen des Typs StreamedToClientOrServerInstalled. (Es werden keine anderen gestreamten Anwendungen importiert.) Standardwert: Gestreamte Anwendungen werden nicht importiert.
    -IncludeDisabledApps Import von Anwendungen, die als deaktiviert markiert sind. Standard: Deaktivierte Anwendungen werden nicht importiert.

    Beispiel: Das folgende Cmdlet importiert Anwendungen aus der XML-Datei MyFarm.xml. Der Vorgang wird in der Datei MyFarm.log protokolliert.

    Import-XAFarm -XmlInputFile ".\MyFarm.XML"
    -LogFile ".\MyFarm.Log"
    
    <!--NeedCopy-->
    
  10. Führen Sie nach dem Abschluss des Imports die nach der Migration erforderlichen Aufgaben durch.

Aufgaben nach der Migration

Nach dem erfolgreichen Import von XenApp 6.x-Richtlinien und Farmeinstellungen in eine XenApp 7.6-Site stellen Sie mit den folgenden Richtlinien sicher, dass die Daten richtig importiert wurden.

Richtlinien und Richtlinieneinstellungen

Das Importieren von Richtlinien ist im Prinzip ein Kopiervorgang mit Ausnahme von veralteten Einstellungen und Richtlinien, die nicht importiert werden. Mit der Prüfung nach der Migration werden die beiden Seiten verglichen.

  1. In der Protokolldatei werden alle importierten und ignorierten Richtlinien und Einstellungen aufgeführt. Überprüfen Sie zuerst die Protokolldatei und identifizieren Sie die Einstellungen und Richtlinien, die nicht importiert wurden.

  2. Vergleichen Sie die XenApp 6.x-Richtlinien mit den nach XenApp 7.6 importierten Richtlinien. Behalten Sie die Werte der Einstellungen bei (außer bei veralteten Richtlinieneinstellungen, siehe nächster Schritt).

    • Bei einer kleinen Anzahl von Richtlinien können Sie einen visuellen Vergleich der Richtlinien im XenApp 6.x AppCenter und in XenApp 7.6 Studio durchführen.
    • Wenn Sie viele Richtlinien haben, ist ein visueller Vergleich eventuell nicht möglich. Verwenden Sie in solchen Fällen das Export-Cmdlet (Export-Policy), um die XenApp 7.6-Richtlinien in eine andere XML-Datei zu exportieren. Vergleichen Sie dann mit einem Textvergleichsprogramm (z. B. windiff) die Daten der Datei mit den Daten in der XML-Datei, die zum Richtlinienexport aus XenApp 6.x verwendet wurde.
  3. Der Abschnitt Nicht importierte Richtlinieneinstellungen enthält Informationen dazu, was sich beim Import geändert haben könnte. Wenn eine XenApp 6.x-Richtlinie nur veralteten Einstellungen enthält, wird die gesamte Richtlinie nicht importiert. Beispiel: Wenn eine XenApp 6.x-Richtlinie nur HMR-Testeinstellungen enthält, wird die Richtlinie ignoriert, da es keine entsprechende Einstellung in XenApp 7.6 gibt.

    Einige XenApp 6.x-Richtlinieneinstellungen werden nicht mehr unterstützt, aber vergleichbare Funktionen wurden in XenApp 7.6 implementiert. In XenApp 7.6 können Sie beispielsweise einen Neustartzeitplan für Serverbetriebssystemmaschinen konfigurieren, indem Sie eine Bereitstellungsgruppe bearbeiten. Diese Funktionalität wurde zuvor über Richtlinieneinstellungen implementiert.

  4. Prüfen Sie, wie Filter für die XenApp 7.6-Site im Vergleich zu der XenApp 6.x angewendet werden. Signifikante Unterschiede zwischen der XenApp 6.x-Farm und der XenApp 7.6-Site können die Wirkung von Filtern verändern.

Filter

Überprüfen Sie sorgfältig die Filter für die einzelnen Richtlinien. Damit sie in XenApp 7.6 weiterhin genauso funktionieren wie in XenApp 6.x, sind möglicherweise Änderungen erforderlich.

Filter Überlegungen
Zugriffssteuerung Die Zugriffssteuerung enthält in der Regel die gleichen Werte wie die ursprünglichen XenApp 6.x-Filter und funktioniert ohne Änderungen.
Citrix CloudBridge Ein einfacher boolescher Wert. Funktioniert normalerweise ohne Änderungen. (Dieses Produkt heißt jetzt NetScaler SD-WAN.)
Client-IP-Adresse Listet Client-IP-Adressbereiche auf. Jeder Bereich ist entweder erlaubt oder gesperrt. Das Importskript behält die Werte bei, aber Änderungen können erforderlich sein, wenn sich andere Clients mit den XenApp 7.6-VDA-Maschinen verbinden.
Clientname Ähnlich wie beim Client-IP-Adressenfilter behält das Importskript die Werte bei. Es können jedoch Änderungen erforderlich sein, wenn sich andere Clients mit den XenApp 7.6-VDA-Maschinen verbinden.
Organisationseinheit Die Werte werden beibehalten, wenn die Organisationseinheiten beim Import aufgelöst werden können. Überprüfen Sie diesen Filter sorgfältig, besonders wenn die XenApp 6.x- und XenApp 7.6-Maschinen in unterschiedlichen Domänen sind. Wenn Sie die Filterwerte nicht richtig konfigurieren, wird die Richtlinie möglicherweise auf einen falschen Satz Organisationseinheiten angewendet. Die Organisationseinheiten werden nur durch Namen dargestellt, daher ist es möglich, dass eine Organisationseinheit zu einer Organisationseinheit aufgelöst wird, die andere Mitglieder enthält als die Organisationseinheit in der XenApp 6.x-Domäne. Selbst wenn einige Werte des Organisationseinheitsfilters beibehalten werden, prüfen Sie die Werte sorgfältig.
Benutzer oder Gruppe Die Werte werden beibehalten, wenn die Konten beim Import aufgelöst werden können. Ähnlich wie Organisationseinheiten werden die Konten nur nach Namen aufgelöst. Wenn die XenApp 7.6-Site eine Domäne mit den gleichen Domänen- und Benutzernamen enthält, wobei es sich aber tatsächlich um zwei verschiedene Domänen und Benutzer handelt, entsprechen die aufgelösten Konten möglicherweise nicht den Domänenbenutzern in XenApp 6.x. Wenn Sie die Filterwerte nicht richtig überprüfen und ändern, kann es zur falschen Anwendung von Richtlinien kommen.
Workergruppe Workergruppen werden in XenApp 7.6 nicht unterstützt. Verwenden Sie die Bereitstellungsgruppe, den Bereitstellungsgruppentyp und die Tagfilter, die in XenApp 7.6 unterstützt werden (nicht in XenApp 6.x). Bereitstellungsgruppe: Ermöglicht das Anwenden von Richtlinien basierend auf Bereitstellungsgruppen. Jeder Filtereintrag gibt eine Bereitstellungsgruppe an und kann zugelassen oder verweigert werden. Bereitstellungsgruppentyp: Ermöglicht das Anwenden von Richtlinien basierend auf den Bereitstellungsgruppentypen. Jeder Filter gibt einen Bereitstellungsgruppentyp an und kann zugelassen oder verweigert werden. Tag: Gibt Richtlinienanwendung basierend auf Tags an, die für die VDA-Maschinen erstellt wurden. Jedes Tag kann zugelassen oder verweigert werden.

Filter, die Domänenbenutzeränderungen umfassen, müssen besonders sorgfältig überprüft werden, wenn die XenApp 6.x-Farm in einer anderen Domäne ist als die XenApp 7.6-Site. Da das Importskript nur die Zeichenfolgen von Domänen- und Benutzernamen verwendet, um Benutzer in der neuen Domäne aufzulösen, werden möglicherweise nur ein Teil der Konten aufgelöst. Obwohl nicht sehr wahrscheinlich ist, dass verschiedene Domänen und Benutzer den gleichen Namen haben, prüfen Sie die Filter sorgfältig, um sicherzustellen, dass sie korrekte Werte enthalten.

Anwendungen

Die Skripts zum Import von Anwendungen importieren nicht nur Anwendungen. Sie erstellen auch Objekte wie Bereitstellungsgruppen. Wenn der Anwendungsimport mehrere Durchläufe umfasst, können sich die Originalhierarchien der Anwendungsordner erheblich ändern.

  1. Lesen Sie als Erstes die Migrationsprotokolldateien, die Informationen dazu enthalten, welche Anwendungen importiert oder ignoriert wurden und welche Cmdlets zum Erstellen der Anwendungen verwendet wurden.
  2. Für jede Anwendung gilt Folgendes:
    • Sehen Sie sich das Protokoll an und prüfen Sie, ob die grundlegenden Eigenschaften beim Importieren beibehalten wurden. Bestimmen Sie mit den Informationen unter Zuordnung von Anwendungseigenschaften, welche Eigenschaften ohne Änderungen importiert, nicht importiert oder mit den XenApp 6.x-Anwendungsdaten initialisiert wurden.
    • Überprüfen Sie die Benutzerliste. Das Importskript importiert automatisch die explizite Liste der Benutzer in die Liste “Sichtbarkeit beschränken” der Anwendung in XenApp 7.6. Stellen Sie sicher, dass die Liste unverändert ist.
  3. Anwendungsserver werden nicht importiert. Dies bedeutet, dass auf keine der importierten Anwendungen zugegriffen werden kann. Den Bereitstellungsgruppen, die diese Anwendungen enthalten, müssen Maschinenkataloge mit den Maschinen zugewiesen werden, auf denen die ausführbaren Images der veröffentlichten Anwendungen sind. Für jede Anwendung gilt Folgendes:
    • Stellen Sie sicher, dass der Name der ausführbaren Datei und das Arbeitsverzeichnis auf eine ausführbare Datei verweisen, die auf den Maschinen vorhanden ist, die der Bereitstellungsgruppe (über die Maschinenkataloge) zugewiesen sind.
    • Überprüfen Sie einen Befehlszeilenparameter (dies kann ein beliebiges Objekt sein, z. B. Dateiname, Umgebungsvariable oder der Name einer ausführbaren Datei). Stellen Sie sicher, dass der Parameter für alle Maschinen in den Maschinenkatalogen, die der Bereitstellungsgruppe zugewiesen sind, gültig ist.

Protokolldateien

Die Protokolldateien sind die wichtigsten Referenzressourcen beim Import und Export. Aus diesem Grund werden bestehende Protokolldateien standardmäßig nicht überschrieben und Standardprotokolldateien haben eindeutige Namen.

Im Abschnitt Protokollierung und Fehlerbehandlung wurde bereits erwähnt, dass die Ausgabe und die Protokolldatei, die Sie erhalten, wenn Sie die verfügbaren zusätzlichen Protokollierungsfunktionen für die PowerShell-Cmdlets Start-Transcript und Stop-Transcript verwenden (sie protokollieren alles, was in die Konsole eingegeben und gedruckt wird), eine vollständige Referenz der Import- und Exportaktivitäten bieten.

Mit den Zeitstempeln in den Protokolldateien können Sie bestimmte Probleme diagnostizieren. Wenn beispielsweise ein Export oder Import lange gedauert hat, können Sie feststellen, ob eine fehlerhafte Datenbankverbindung oder das Auflösen von Benutzerkonten viel Zeit in Anspruch genommen haben.

Aus den in den Protokolldateien aufgezeichneten Befehlen lässt sich auch ermitteln, wie manche Objekte gelesen oder erstellt werden. Beispielsweise werden zum Erstellen einer Bereitstellungsgruppe mehrere Befehle ausgeführt, und zwar nicht nur, um das Bereitstellungsgruppenobjekt zu erstellen, sondern auch andere Objekte, wie die Zugriffsrichtlinienregeln, mit denen Anwendungsobjekte Bereitstellungsgruppen zugewiesen werden.

Mit der Protokolldatei kann auch ein fehlgeschlagener Export oder Import diagnostiziert werden. Normalerweise ist in den letzten Zeilen der Protokolldatei angegeben, was den Fehler verursacht hat. Die Fehlermeldung wird auch in der Protokolldatei gespeichert. Mit der Protokolldatei und der XML-Datei zusammen können Sie bestimmen, welches Objekt an dem Fehler beteiligt war.

Nach der Überprüfung und dem Test der Migration haben Sie folgende Möglichkeiten:

  1. Upgrade der XenApp 6.5-Workerserver auf aktuelle Virtual Delivery Agents (VDAs) durch Ausführen des Installers für 7.6 auf den Servern. Der Installer entfernt die XenApp 6.5-Software und installiert dann automatisch einen aktuellen VDA. Anweisungen finden Sie unter Upgrade eines XenApp 6.5-Workers auf einen neuen VDA für Windows-Serverbetriebssysteme.

    Bei XenApp 6.0-Workerservern müssen Sie die XenApp 6.0-Software manuell vom Server deinstallieren. Danach können Sie mit dem Installer für 7.6 den aktuellen VDA installieren. Sie können mit dem Installer für 7.6 nicht automatisch die XenApp 6.0-Software entfernen.

  2. Erstellen von Maschinenkatalogen (oder Bearbeiten von vorhandenen Katalogen) für die aktualisierten Worker in der neuen XenApp-Site mit Studio.

  3. Hinzufügen der aktualisierten Maschinen aus dem Maschinenkatalog zu den Bereitstellungsgruppen, die die auf den VDAs für Windows-Serverbetriebssysteme installierten Anwendungen enthalten.

Erweiterte Verwendung

Standardmäßig exportiert das Cmdlet Export-Policy alle Richtliniendaten in eine XML-Datei. Analog exportiert das Cmdlet Export-XAFarm alle Farmdaten in eine XML-Datei. Sie können mit Befehlszeilenparametern genauer steuern, was importiert und exportiert wird.

Teilweises Exportieren von Anwendungen

Wenn Sie viele Anwendungen haben und steuern möchten, wie viele in die XML-Datei exportiert werden, verwenden Sie die folgenden Parameter:

  • AppLimit - Gibt die Anzahl der zu exportierenden Anwendungen an.
  • SkipApps - Gibt die Anzahl der zu überspringenden Anwendungen an, bevor Anwendungen exportiert werden.

Sie können beide Parameter verwenden, um große Mengen von Anwendungen in praktischen Segmenten zu exportieren. Beispiel: Wenn Sie das erste Mal “Export-XAFarm” ausführen, möchten Sie nur die ersten 200 Anwendungen exportieren und geben daher den Wert im Parameter “AppLimit” an.

Export-XAFarm -XmlOutputFile "Apps1-200.xml"
-AppLimit "200"
<!--NeedCopy-->

Wenn Sie das nächste Mal Export-XAFarm ausführen, möchten Sie die nächsten 100 Anwendungen exportieren. Sie verwenden den Parameter SkipApps, um die bereits exportierten Anwendungen (die ersten 200) zu ignorieren, und exportieren mit dem Parameter AppLimit die nächsten 100 Anwendungen.

Export-XAFarm -XmlOutputFile "Apps201-300.xml"
-AppLimit "100" -SkipApps "200"
<!--NeedCopy-->

Ausschließen von Objekten aus dem Export

Einige Objekte brauchen nicht exportiert zu werden, weil sie ignoriert werden können. Dazu zählen besonders Objekte, die nicht importiert werden. Siehe Nicht importierte Richtlinieneinstellungen und Zuordnung von Anwendungseigenschaften. Mit den folgenden Parametern können Sie den Export unnötiger Objekte verhindern:

  • IgnoreAdmins - Administratorobjekte werden nicht exportiert
  • IgnoreServers - Serverobjekte werden nicht exportiert
  • IgnoreZones - Zonenobjekte werden nicht exportiert
  • IgnoreOthers - Konfigurationsprotokollierungs-, Lastauswertungsprogramm-, Lastausgleichsrichtlinien-, Druckertreiber- und Workergruppenobjekte werden nicht exportiert
  • IgnoreApps - Anwendungen werden nicht exportiert. Mit diesem Parameter können Sie andere Daten in eine XML-Ausgabedatei exportieren und dann den Export neu ausführen, um die Anwendungen in eine andere XML-Ausgabedatei zu exportieren.

Sie können mit diesen Parametern auch Probleme umgehen, die zum Fehlschlagen des Exports führen können. Wenn Sie beispielsweise einen fehlerhaften Server in einer Zone haben, schlägt der Zonenexport möglicherweise fehl. Wenn Sie den Parameter IgnoreZones einschließen, wird der Export mit anderen Objekten fortgesetzt.

Bereitstellungsgruppennamen

Wenn nicht alle Anwendungen in einer Bereitstellungsgruppe platziert werden sollen (z. B. weil verschiedene Benutzergruppen auf sie zugreifen und sie auf verschiedenen Servern veröffentlicht werden), führen Sie Import-XAFarm mehrmals aus und geben Sie dabei jedes Mal unterschiedliche Anwendungen und eine andere Bereitstellungsgruppe an. Sie können Anwendungen nach der Migration zwar mit PowerShell-Cmdlets von einer Bereitstellungsgruppe in eine andere verschieben, jedoch kann das Verschieben von Anwendungen durch selektives Importieren in eindeutige Bereitstellungsgruppen reduziert oder eliminiert werden.

  • Verwenden Sie den Parameter DeliveryGroupName mit dem Cmdlet Import-XAFarm. Das Skript erstellt die angegebene Bereitstellungsgruppe, wenn sie nicht vorhanden ist.
  • Verwenden Sie die folgenden Parameter mit regulären Ausdrücken, um die Anwendungen, die in die Bereitstellungsgruppe importiert werden sollen, basierend auf Ordner, Workergruppe Benutzerkontonamen und Servernamen zu filtern. Es empfiehlt sich, den regulären Ausdruck in einzelne oder doppelte Anführungszeichen zu setzen. Informationen zu regulären Ausdrücken finden Sie unter https://docs.microsoft.com/en-us/dotnet/standard/base-types/regular-expressions.

    • MatchWorkerGroup und NotMatchWorkerGroup - Zum Beispiel bei Anwendungen, die auf Workergruppen veröffentlicht wurden, importiert das folgende Cmdlet Anwendungen in der Workergruppe Productivity Apps in eine XenApp 7.6-Bereitstellungsgruppe mit demselben Namen:

       Import-XAFarm –XmlInputFile XAFarm.xml –LogFile XAFarmImport.log –MatchWorkerGroup ‘Productivity Apps’ –DeliveryGroupName ‘Productivity Apps
       <!--NeedCopy-->
      
    • MatchFolder und NotMatchFolder - Zum Beispiel bei Anwendungen, die in Anwendungsordnern organisiert sind, importiert das folgende Cmdlet Anwendungen im Ordner Productivity Apps in eine XenApp 7.6-Bereitstellungsgruppe mit dem gleichen Namen.

       Import-XAFarm –XmlInputFile XAFarm.xml –LogFile XAFarmImport.log –MatchFolder ‘Productivity Apps’ –DeliveryGroupName ‘Productivity Apps’
       <!--NeedCopy-->
      

      Beispielsweise importiert das folgende Cmdlet Anwendungen in Ordnern, deren Name MS Office Apps enthält, in die Standardbereitstellungsgruppe.

       Import-XAFarm -XmlInputFile .\THeFarmApps.XML -MatchFolder ".\*/MS Office Apps/.\*"
       <!--NeedCopy-->
      
    • MatchAccount und NotMatchAccount - Zum Beispiel bei Anwendungen, die für Active Directory-Benutzer oder -Benutzergruppen veröffentlicht wurden, importiert das folgende Cmdlet Anwendungen, die für die Benutzergruppe Finance Group veröffentlicht wurden, in eine XenApp 7.6-Bereitstellungsgruppe mit dem Namen Finance.

       Import-XAFarm –XmlInputFile XAFarm.xml –LogFile XAFarmImport.log –MatchAccount ‘DOMAIN\Finance Group’ –DeliveryGroupName ‘Finance’
       <!--NeedCopy-->
      
    • MatchServer und NotMatchServer - Zum Beispiel bei Anwendungen, die auf Servern organisiert sind, importiert das folgende Cmdlet Anwendungen von Servern, deren Name nicht Current ist, in eine Bereitstellungsgruppe mit dem Namen Legacy.

       Import-XAFarm -XmlInputFile XAFarm.xml -LogFile XAFarmImport.log -NotMatchServer 'Current' -DeliveryGroupName 'Legacy'
       <!--NeedCopy-->
      

Anpassung

PowerShell-Programmierer können eigene Tools erstellen. Sie können z. B. das Exportskript als Bestandstool verwenden und damit die Änderungen in einer XenApp 6.x-Farm verfolgen. Sie können auch die XSD-Dateien ändern oder Ihre eigenen XSD-Dateien erstellen, um zusätzliche Daten oder Daten in unterschiedlichen Formaten in den XML-Dateien zu speichern. Sie können eine nicht standardmäßige XSD-Datei mit jedem der Import-Cmdlets angeben.

Obwohl Sie Skriptdateien für bestimmte oder höhere Migrationsanforderungen ändern können, ist der Support auf unveränderte Skripts beschränkt. Der technische Support von Citrix empfiehlt, die Skripts in den Originalzustand zurückzuversetzen, um bei Bedarf erwartetes Verhalten ermitteln und Support bereitstellen zu können.

Problembehandlung

  • Wenn Sie PowerShell 2.0 verwenden und das PowerShell-Anbieter-Snap-In für Citrix Gruppenrichtlinien oder das Citrix Common Commands Snap-In mit dem Cmdlet Add-PSSnapIn hinzugefügt haben, wird möglicherweise die folgende Fehlermeldung angezeigt, wenn Sie Cmdlets zum Exportieren oder Importieren ausführen: Object reference not set to an instance of an object Dieser Fehler wirkt sich nicht auf die Skriptausführung aus und kann bedenkenlos ignoriert werden.
  • Vermeiden Sie es, das PowerShell-Anbieter-Snap-In für Citrix Gruppenrichtlinien in der gleichen Konsolensitzung hinzuzufügen oder zu entfernen, in der Sie die Export- und Importskriptmodule verwenden, da diese Skriptmodule das Snap-In automatisch hinzufügen. Wenn Sie das Snap-In separat hinzufügen oder entfernen, wird u. U. einer der folgenden Fehler angezeigt:

    • A drive with the name 'LocalGpo' already exists. Dieser Fehler tritt auf, wenn das Snap-In zweimal hinzugefügt wird. Beim Laden versucht das Snap-In, das Laufwerk “LocalGpo” bereitzustellen und meldet dann den Fehler.
    • A parameter cannot be found that matches parameter name 'Controller'. Dieser Fehler wird angezeigt, wenn das Snap-In nicht hinzugefügt wurde und das Skript versucht, das Laufwerk bereitzustellen. Das Skript erkennt nicht, dass das Snap-In entfernt wurde. Schließen Sie die Konsole und starten Sie eine neue Sitzung. Importieren Sie in der neuen Sitzung die Skriptmodule. Fügen Sie das Snap-In nicht separat hinzu oder entfernen es.
  • Wenn Sie beim Importieren der Module mit der rechten Maustaste auf eine .psd1-Datei klicken und Öffnen oder Mit PowerShell öffnen auswählen, wird das PowerShell-Konsolenfenster schnell geöffnet und geschlossen, bis Sie den Prozess beenden. Sie vermeiden diesen Fehler, indem Sie den vollständigen Namen des PowerShell-Skriptmoduls direkt im PowerShell-Konsolenfenster eingeben (z. B. Import-Module .\ExportPolicy.psd1).
  • Wenn beim Ausführen eines Exports oder Imports ein Berechtigungsfehler angezeigt wird, stellen Sie sicher, dass Sie ein XenApp-Administrator mit der Berechtigung zum Lesen von Objekten (beim Export) oder zum Lesen und Erstellen von Objekten (beim Import) sind. Sie müssen auch über die erforderlichen Berechtigungen zum Ausführen von Windows-PowerShell-Skripts verfügen.
  • Wenn ein Export fehlschlägt, prüfen Sie, ob die XenApp 6.x-Farm funktionsfähig ist, indem Sie die Dienstprogramme DSMAINT und DSCHECK auf dem XenApp 6.x Controller-Server ausführen.
  • Wenn Sie mit den Import-Cmdlets eine Importvorschau ausführen und später bei der tatsächlichen Migration nichts importiert wird, prüfen Sie, ob Sie den Parameter “Preview” aus den Import-Cmdlets entfernt haben.

Nicht importierte Richtlinieneinstellungen

Die folgenden Computer- und Benutzerrichtlinieneinstellungen werden nicht importiert, da sie nicht mehr unterstützt werden. Ungefilterte Richtlinien werden nie importiert. Die Features und Komponenten, die diese Einstellungen unterstützen, wurden entweder durch neue Technologien und Komponenten ersetzt oder sind aufgrund von Änderungen an Architektur oder Plattform nicht relevant.

Nicht importierte Computerrichtlinieneinstellungen

  • Verbindungszugriffssteuerung
  • CPU-Managementserverstufe
  • DNS-Adressauflösung
  • Farm name
  • Vollständige Symbolzwischenspeicherung
  • Systemüberwachung, Systemüberwachungstests
  • Hostname des Lizenzservers, den Lizenzserverport
  • Limit für Benutzersitzungen, Limits für Administratorsitzungen
  • Lastauswertungsprogrammname
  • Protokollierung von Anmeldelimitereignissen
  • Maximaler Prozentsatz von Servern mit Anmeldesteuerung
  • Speicheroptimierung, Speicheroptimierung - Anwendungsausschlussliste, Speicheroptimierung - Intervall, Speicheroptimierung - Tag des Monats, Speicheroptimierung - Wochentag, Speicheroptimierung - Zeit
  • Offlineanwendungsclient vertrauen, Ereignisprotokollierung für Offlineanwendungen, Offlineanwendungslizenzzeitraum, Offlineanwendungsbenutzer
  • Zur Kennworteingabe auffordern
  • Benutzerdefinierte Neustartwarnung, Text für benutzerdefinierte Neustartwarnung, Anmeldungen vor Neustart deaktivieren (Zeit), Neustarthäufigkeit, Willkürliches Neustartintervall, Neustartbeginn, Neustartzeit, Neustartwarnungsintervall, Neustartwarnung - Startzeit, Neustartwarnung an Benutzer, Geplante Neustarts
  • Spiegeln von Sitzungen *
  • XML-Anfragen vertrauen (Konfiguration in StoreFront)
  • Virtuelle IP - Adapteradressenfilterung, Virtuelle IP - Liste kompatibler Programme, Virtuelle IP - Erweiterte Kompatibilität, Virtuelle IP - Adapteradressenprogrammliste
  • Arbeitslastname
  • XenApp-Produktedition, XenApp-Produktmodell
  • Port für XML-Dienst

* Ersetzt durch Windows-Remoteunterstützung

Nicht importierte Benutzerrichtlinieneinstellungen

  • Client-COM-Ports automatisch verbinden, Client-LPT-Ports automatisch verbinden
  • Client-COM-Portumleitung, Client-LPT-Portumleitung
  • Clientdruckernamen
  • Limit für gleichzeitige Anmeldungen
  • Eingaben in gespiegelten Verbindungen *
  • Trennentimerintervall - Fortbestehen, Beendentimerintervall - Fortbestehen
  • Spiegelungsversuche protokollieren *
  • Benutzer bei ausstehenden Spiegelungsverbindungen benachrichtigen *
  • PreLaunch-Trennentimerintervall, PreLaunch-Beendentimerintervall
  • Sitzungspriorität
  • Single Sign-On, Zentraler Speicher für Single Sign-On
  • Benutzer, die andere Benutzer spiegeln können; Benutzer, die andere Benutzer nicht spiegeln können *

* Ersetzt durch Windows-Remoteunterstützung

Nicht importierte Anwendungstypen

Die folgenden Anwendungstypen werden nicht importiert:

  • Serverdesktops
  • Inhalt
  • Gestreamte Anwendungen (App-V ist die neue Methode für das Streaming von Anwendungen)

Zuordnung von Anwendungseigenschaften

Das Importskript für Farmdaten importiert nur Anwendungen. Die folgenden Anwendungseigenschaften werden ohne Änderungen importiert.

IMA-Eigenschaft FMA-Eigenschaft
AddToClientDesktop ShortcutAddedToDesktop
AddToClientStartMenu ShortcutAddedToStartMenu
ClientFolder ClientFolder
CommandLineExecutable CommandLineExecutable
CpuPriorityLevel CpuPriorityLevel
Beschreibung Beschreibung
DisplayName PublishedName
Aktiviert Aktiviert
StartMenuFolder StartMenuFolder
WaitOnPrinterCreation WaitForPrinterCreation
WorkingDirectory WorkingDirectory
FolderPath AdminFolderName

IMA und FMA haben unterschiedliche Beschränkungen bei der Länge der Ordnernamen. In IMA ist die Länge der Ordnernamen auf 256 Zeichen beschränkt. Das FMA-Limit ist 64 Zeichen. Anwendungen, deren Ordnerpfad einen Ordnernamen mit mehr als 64 Zeichen enthält, werden beim Import übersprungen. Das Limit gilt nur für den Ordnernamen im Ordnerpfad. Der gesamte Ordnerpfad kann länger als die angegebenen Grenzwerte sein. Damit Anwendungen beim Importieren nicht übersprungen werden, empfiehlt Citrix, die Länge der Anwendungsordnernamen zu prüfen und bei Bedarf vor dem Export zu kürzen.

Die folgenden Anwendungseigenschaften sind standardmäßig initialisiert oder nicht initialisiert oder auf die in den XenApp 6.x-Daten bereitgestellten Werte festgelegt:

FMA-Eigenschaft Wert
Name Initialisiert auf den vollständigen Pfadnamen, der die IMA-Eigenschaften “FolderPath” und “DisplayName” enthält, aber die voranstehende Zeichenfolge “Applications\” wurde gekürzt
ApplicationType HostedOnDesktop
CommandLineArguments Initialisiert mit den XenApp 6.x-Befehlszeilenargumenten
IconFromClient Nicht initialisiert, Standardwert = false
IconUid Initialisiert auf ein Symbolobjekt, das mit XenApp 6.x-Symboldaten erstellt wurde
SecureCmdLineArgumentsEnabled Nicht initialisiert, Standardwert = true
UserFilterEnabled Nicht initialisiert, Standardwert = false
UUID Schreibgeschützt, vom Controller zugewiesen
Sichtbar Nicht initialisiert, Standardwert = true

Die folgenden Anwendungseigenschaften werden teilweise migriert:

IMA-Eigenschaft Anmerkungen
FileTypes Nur in der neuen XenApp-Site existierende Dateitypen werden migriert. Dateitypen, die in der neuen Site nicht existieren, werden ignoriert. Dateitypen werden erst importiert, wenn die Dateitypen in der neuen Site aktualisiert wurden.
IconData Neue Symbolobjekte werden erstellt, wenn die Symboldaten für die exportierten Anwendungen angegeben wurden.
Konten Die Benutzerkonten einer Anwendung werden zwischen der Benutzerliste für die Bereitstellungsgruppe und der Anwendung aufgeteilt. Explizite Benutzer werden zur Initialisierung der Benutzerliste für die Anwendung verwendet. Zudem wird der Benutzerliste für die Bereitstellungsgruppe das Konto “Domänenbenutzer” für die Domäne der Benutzerkonten hinzugefügt.

Die folgenden XenApp 6.x-Eigenschaften werden nicht importiert:

IMA-Eigenschaft Anmerkungen
ApplicationType Wird ignoriert.
HideWhenDisabled Wird ignoriert.
AccessSessionConditions Ersetzt durch Bereitstellungsgruppenzugriffsrichtlinien.
AccessSessionConditionsEnabled Ersetzt durch Bereitstellungsgruppenzugriffsrichtlinien.
ConnectionsThroughAccessGatewayAllowed Ersetzt durch Bereitstellungsgruppenzugriffsrichtlinien.
OtherConnectionsAllowed Ersetzt durch Bereitstellungsgruppenzugriffsrichtlinien.
AlternateProfiles FMA unterstützt keine gestreamten Anwendungen.
OfflineAccessAllowed FMA unterstützt keine gestreamten Anwendungen.
ProfileLocation FMA unterstützt keine gestreamten Anwendungen.
ProfileProgramArguments FMA unterstützt keine gestreamten Anwendungen.
ProfileProgramName FMA unterstützt keine gestreamten Anwendungen.
RunAsLeastPrivilegedUser FMA unterstützt keine gestreamten Anwendungen.
AnonymousConnectionsAllowed FMA verwendet eine andere Technologie für die Unterstützung nicht authentifizierter (anonymer) Verbindungen.
ApplicationId, SequenceNumber IMA-eigene Daten.
AudioType FMA unterstützt keine erweiterten Clientverbindungsoptionen.
EncryptionLevel SecureICA ist in Bereitstellungsgruppen aktiviert/deaktiviert.
EncryptionRequired SecureICA ist in Bereitstellungsgruppen aktiviert/deaktiviert.
SslConnectionEnabled FMA verwendet eine andere TLS-Implementierung.
ContentAddress FMA unterstützt keinen veröffentlichten Inhalt.
ColorDepth FMA unterstützt keine erweiterten Fensterformen.
MaximizedOnStartup FMA unterstützt keine erweiterten Fensterformen.
TitleBarHidden FMA unterstützt keine erweiterten Fensterformen.
WindowsType FMA unterstützt keine erweiterten Fensterformen.
InstanceLimit FMA unterstützt keine Anwendungslimits.
MultipleInstancesPerUserAllowed FMA unterstützt keine Anwendungslimits.
LoadBalancingApplicationCheckEnabled FMA verwendet eine andere Technologie für den Lastausgleich.
PreLaunch FMA verwendet eine andere Technologie für den Sitzungsvorabstart.
CachingOption FMA verwendet eine andere Technologie für den Sitzungsvorabstart.
ServerNames FMA verwendet eine andere Technologie.
WorkerGroupNames FMA unterstützt keine Workergruppen.