XenApp 6.x migrieren

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

Sie können das in diesem Artikel beschriebene Migrationstool verwenden, um von XenApp 6.x auf XenApp 7.6 zu migrieren. Anschließend können Sie von XenApp 7.6 auf eine unterstützte LTSR-Version oder die aktuelle Citrix Virtual Apps and Desktops-Version aktualisieren.

XenApp 6.x Migrationstool

Das XenApp 6.x Migrationstool ist eine Sammlung von PowerShell-Skripts, die Cmdlets enthalten, die Richtlinien- und Farmdaten von XenApp 6.x (6.0 oder 6.5) migrieren. Auf dem XenApp 6.x Controller-Server führen Sie Export-Cmdlets aus, die diese Daten in XML-Dateien sammeln. Anschließend führen Sie vom XenApp 7.6 Controller aus Import-Cmdlets aus, die Objekte unter Verwendung der während des Exports gesammelten Daten erstellen.

Die folgende Reihenfolge fasst den Migrationsprozess zusammen. Details werden später bereitgestellt.

1. Auf einem XenApp 6.0- oder 6.5-Controller:
   1. Importieren Sie die PowerShell-Exportmodule.
   2. Führen Sie die Export-Cmdlets aus, um Richtlinien- und Farmdaten in XML-Dateien zu exportieren.
   3. Kopieren Sie die XML-Dateien (und den Symbolordner, falls Sie sich entschieden haben, sie während des Exports nicht in die XML-Dateien einzubetten) auf den XenApp 7.6 Controller.
2. Auf dem XenApp 7.6 Controller:
   1. Importieren Sie die PowerShell-Importmodule.
   2. Führen Sie die Import-Cmdlets aus, um Richtlinien- und Farmdaten (Anwendungen) unter Verwendung der XML-Dateien als Eingabe zu importieren.
3. Schließen Sie die Schritte nach der Migration ab.

Bevor Sie eine tatsächliche Migration durchführen, können Sie Ihre XenApp 6.x-Einstellungen exportieren und dann einen Vorschauimport auf der XenApp 7.6-Site durchführen. Die Vorschau identifiziert mögliche Fehlerquellen, sodass Sie Probleme beheben können, bevor Sie den eigentlichen Import ausführen. Eine Vorschau könnte beispielsweise erkennen, dass eine Anwendung mit demselben Namen bereits in der neuen XenApp 7.6-Site vorhanden ist. Sie können die aus der Vorschau generierten Protokolldateien auch als Migrationsleitfaden verwenden.

Sofern nicht anders angegeben, bezieht sich der Begriff 6.x auf XenApp 6.0 oder 6.5.

Neu in dieser Version

Diese Version vom Dezember 2014 (Version 20141125) enthält die folgenden Updates:

• Wenn bei der Verwendung des Migrationstools in einer XenApp 6.x-Farm Probleme auftreten, melden Sie diese an https://discussions.citrix.com/forum/1411-xenapp-7x/.
• Neue Paketierung – die Datei XAMigration.zip enthält jetzt zwei separate, unabhängige 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-Server benötigen Sie nur ImportFMA.zip.
• Das Cmdlet Export-XAFarm unterstützt einen neuen Parameter (EmbedIconData), der das Kopieren von Symboldaten in separate Dateien überflüssig macht.
• Das Cmdlet Import-XAFarm unterstützt drei neue Parameter:
  • MatchServer – Importieren von Anwendungen von Servern, deren Namen einem Ausdruck entsprechen
  • NotMatchServer – Importieren von Anwendungen von Servern, deren Namen keinem Ausdruck entsprechen
  • IncludeDisabledApps – Importieren deaktivierter Anwendungen
• Vorgestartete Anwendungen werden nicht importiert.
• Das Cmdlet Export-Policy funktioniert unter XenDesktop 7.x.

Migrationstool-Paket

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

• ReadIMA.zip – enthält die Dateien, die zum Exportieren von Daten aus Ihrer XenApp 6.x-Farm verwendet werden, sowie freigegebene Module.

• ImportFMA.zip – enthält die Dateien, die zum Importieren von Daten in Ihre XenApp 7.6 Farm verwendet werden, sowie freigegebene Module.

Einschränkungen

• Nicht alle Richtlinieneinstellungen werden importiert. Siehe Nicht importierte Richtlinieneinstellungen. Nicht unterstützte Einstellungen werden ignoriert und in der Protokolldatei vermerkt.
• Obwohl alle Anwendungsdetails während des Exportvorgangs in der XML-Ausgabedatei gesammelt werden, werden nur auf dem Server installierte Anwendungen in die XenApp 7.6-Site importiert. Veröffentlichte Desktops, Inhalte und die meisten gestreamten Anwendungen werden nicht unterstützt (Ausnahmen finden Sie unter den Import-XAFarm Cmdlet-Parametern in Schritt-für-Schritt: Daten importieren).
• Anwendungsserver werden nicht importiert.
• Viele Anwendungseigenschaften werden aufgrund von Unterschieden zwischen der XenApp 6.x Independent Management Architecture (IMA) und den XenApp 7.6 FlexCast Management Architecture (FMA)-Technologien nicht importiert. Siehe Anwendungseigenschaftszuordnung.
• Während des Imports wird eine Delivery Group erstellt. Weitere Informationen zur Verwendung von Parametern zum Filtern der zu importierenden Daten finden Sie unter Erweiterte Nutzung.
• Es werden nur Citrix-Richtlinieneinstellungen importiert, die mit der AppCenter-Verwaltungskonsole erstellt wurden. Citrix-Richtlinieneinstellungen, die mit Windows-Gruppenrichtlinienobjekten (GPOs) erstellt wurden, werden nicht importiert.
• Die Migrationsskripte sind nur für Migrationen von XenApp 6.x zu XenApp 7.6 vorgesehen.
• Verschachtelte Ordner, die tiefer als fünf Ebenen sind, werden von Studio nicht unterstützt und nicht importiert. Wenn Ihre Anwendungsordnerstruktur Ordner enthält, die tiefer als fünf Ebenen sind, sollten Sie die Anzahl der verschachtelten Ordnerebenen vor dem Import reduzieren.

Sicherheitsüberlegungen

Die von den Exportskripten erstellten XML-Dateien können vertrauliche Informationen über Ihre Umgebung und Organisation enthalten, wie z. B. Benutzer- und Servernamen sowie andere Farm-, Anwendungs- und Richtlinienkonfigurationsdaten. Speichern und behandeln Sie diese Dateien in sicheren Umgebungen.

Überprüfen Sie die XML-Dateien sorgfältig, bevor Sie sie als Eingabe beim Importieren von Richtlinien und Anwendungen verwenden, um sicherzustellen, dass sie keine unbefugten Änderungen enthalten.

Richtlinienobjektzuweisungen (früher als Richtlinienfilter bekannt) steuern, wie Richtlinien angewendet werden. Überprüfen Sie nach dem Import der Richtlinien die Objektzuweisungen für jede Richtlinie sorgfältig, um sicherzustellen, dass durch den Import keine Sicherheitslücken entstehen. Nach dem Import können unterschiedliche Benutzergruppen, IP-Adressen oder Clientnamen auf die Richtlinie angewendet werden. Die Zulassungs- und Verweigerungseinstellungen können nach dem Import unterschiedliche Bedeutungen haben.

Protokollierung und Fehlerbehandlung

Die Skripte bieten eine umfassende Protokollierung, die alle Cmdlet-Ausführungen, informative Meldungen, Cmdlet-Ausführungsergebnisse, Warnungen und Fehler verfolgt.

• Die meisten Verwendungen von Citrix PowerShell-Cmdlets werden protokolliert. Alle PowerShell-Cmdlets in den Importskripten, die neue Site-Objekte erstellen, werden protokolliert.
• Der Fortschritt der Skriptausführung wird protokolliert, einschließlich der verarbeiteten Objekte.
• Wichtige Aktionen, die den Status des Ablaufs beeinflussen, werden protokolliert, einschließlich Abläufe, die über die Befehlszeile gesteuert werden.
• Alle in der Konsole ausgegebenen Meldungen, einschließlich Warnungen und Fehler, werden protokolliert.
• Jede Zeile ist mit einem Zeitstempel im Millisekundenbereich versehen.

Citrix empfiehlt, bei der Ausführung jedes Export- und Import-Cmdlets eine Protokolldatei anzugeben.

Wenn Sie keinen Protokolldateinamen angeben, wird die Protokolldatei im Home-Ordner des aktuellen Benutzers (angegeben in der PowerShell-Variable $HOME) gespeichert, falls dieser Ordner existiert. Andernfalls wird die Datei im aktuellen Ausführungsordner des Skripts abgelegt. Der Standardprotokollname ist XFarmYYYYMMDDHHmmSS-xxxxxx, wobei die letzten sechs Ziffern eine Zufallszahl sind.

Standardmäßig werden alle Fortschrittsinformationen angezeigt. Um die Anzeige zu unterdrücken, geben Sie den Parameter NoDetails im Export- und Import-Cmdlet an.

Im Allgemeinen stoppt ein Skript die Ausführung, wenn ein Fehler auftritt, und Sie können das Cmdlet erneut ausführen, nachdem Sie die Fehlerbedingungen behoben haben.

Bedingungen, die nicht als Fehler betrachtet werden, werden protokolliert. Viele werden als Warnungen gemeldet, und die Skriptausführung wird fortgesetzt. Beispielsweise werden nicht unterstützte Anwendungstypen als Warnungen 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 Migrationsskripte verwenden viele PowerShell-Cmdlets, und möglicherweise werden nicht alle möglichen Fehler protokolliert. Für eine umfassendere Protokollierung verwenden Sie die PowerShell-Protokollierungsfunktionen. Beispielsweise protokollieren PowerShell-Transkripte alles, was auf dem Bildschirm ausgegeben wird. Weitere Informationen finden Sie in der Hilfe zu den Cmdlets Start-Transcript und Stop-Transcript.

Anforderungen, Vorbereitung und Best Practices

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

Lesen Sie diesen gesamten Artikel, bevor Sie mit einer Migration beginnen.

Sie müssen grundlegende PowerShell-Konzepte verstehen. Obwohl keine umfassenden Skriptkenntnisse erforderlich sind, müssen Sie die Cmdlets verstehen, die Sie ausführen. Verwenden Sie das Cmdlet Get-Help, um die Hilfe jedes Migrations-Cmdlets vor der Ausführung zu überprüfen. Beispiel: Get-Help -full Import-XAFarm.

Geben Sie eine Protokolldatei in der Befehlszeile an und überprüfen Sie die Protokolldatei immer, nachdem Sie ein Cmdlet ausgeführt haben. Wenn ein Skript fehlschlägt, überprüfen und beheben Sie den in der Protokolldatei identifizierten Fehler und führen Sie das Cmdlet dann erneut aus.

Gut zu wissen:

• Um die Anwendungsbereitstellung zu erleichtern, während zwei Bereitstellungen ausgeführt werden (die XenApp 6.x-Farm und die neue XenApp 7.6-Site), können Sie beide Bereitstellungen in StoreFront oder Web Interface aggregieren. Siehe die Produktdokumentation für Ihre StoreFront- oder Web Interface-Version (Verwalten > Store erstellen).
• Anwendungssymbol-Daten werden auf eine von zwei Arten behandelt:
• Wenn Sie den Parameter EmbedIconData im Cmdlet Export-XAFarm angeben, werden exportierte Anwendungssymbol-Daten in die Ausgabe-XML-Datei eingebettet.

• Wenn Sie den Parameter EmbedIconData im Cmdlet Export-XAFarm nicht angeben, werden exportierte Anwendungssymbol-Daten in einem Ordner gespeichert, dessen Name durch Anhängen der Zeichenfolge -icons an den Basisnamen der Ausgabe-XML-Datei gebildet wird. Wenn beispielsweise der Parameter XmlOutputFile FarmData.xml ist, wird der Ordner FarmData-icons erstellt, um die Anwendungssymbole zu speichern.

  Die Symboldateien in diesem Ordner sind .txt-Dateien, die nach dem Browsernamen der veröffentlichten Anwendung benannt sind. Obwohl es sich um .txt-Dateien handelt, sind die gespeicherten Daten kodierte binäre Symboldaten, die vom Importskript gelesen werden können, um das Anwendungssymbol neu zu erstellen. Wenn der Symbolordner während des Importvorgangs nicht am selben Speicherort wie die Import-XML-Datei gefunden wird, werden generische Symbole für jede importierte Anwendung verwendet.

• Die Namen der Skriptmodule, Manifestdateien, des freigegebenen Moduls und der Cmdlets ähneln sich. Verwenden Sie die Tab-Vervollständigung mit Vorsicht, um Fehler zu vermeiden. Zum Beispiel ist Export-XAFarm ein Cmdlet. ExportXAFarm.psd1 und ExportXAFarm.psm1 sind Dateien, die nicht ausgeführt werden können.
• In den Schritt-für-Schritt-Abschnitten zeigen die meisten <string> Parameterwerte umgebende Anführungszeichen. Diese sind optional für einwortige Zeichenfolgen.

Zum Exportieren vom XenApp 6.x-Server:

• Der Export muss auf einem XenApp 6.x-Server ausgeführt werden, der mit dem Controller- und Sitzungshost-Servermodus (allgemein als Controller bekannt) konfiguriert ist.
• Um die Export-Cmdlets auszuführen, müssen Sie ein XenApp®-Administrator mit Leseberechtigung für Objekte sein. Sie müssen außerdem über ausreichende Windows-Berechtigungen zum Ausführen von PowerShell-Skripten verfügen. Die Schritt-für-Schritt-Anleitungen enthalten Anweisungen.

• Stellen Sie sicher, dass die XenApp 6.x-Farm in einem fehlerfreien Zustand ist, bevor Sie einen Export starten. Sichern Sie die Farm-Datenbank. Überprüfen Sie die Integrität der Farm mit dem Citrix IMA Helper-Dienstprogramm (CTX133983): Führen Sie auf der Registerkarte IMA Datastore einen Master Check aus (und verwenden Sie dann die Option DSCheck, um ungültige Einträge zu beheben). Das Beheben von Problemen vor der Migration hilft, Exportfehler zu vermeiden.

  Wenn beispielsweise ein Server unsachgemäß aus der Farm entfernt wurde, könnten seine Daten in der Datenbank verbleiben; dies könnte dazu führen, dass Cmdlets im Exportskript fehlschlagen (zum Beispiel Get-XAServer -ZoneName). Wenn die Cmdlets fehlschlagen, schlägt das Skript fehl.

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

Zum Importieren auf den XenApp 7.6-Server:

• Sie können Daten in XenApp 7.6-Bereitstellungen (und später unterstützte Versionen) importieren. Sie müssen einen XenApp 7.6 Controller und Studio installieren und eine Site erstellen, bevor Sie die Daten importieren, die Sie von der XenApp 6.x-Farm exportiert haben. Obwohl VDAs für den Import von Einstellungen nicht erforderlich sind, ermöglichen sie die Bereitstellung von Anwendungsdateitypen.
• Um die Import-Cmdlets auszuführen, müssen Sie ein XenApp-Administrator mit Lese- und Erstellungsberechtigung für Objekte sein. Ein Volladministrator verfügt über diese Berechtigungen. Sie müssen außerdem über ausreichende Windows-Berechtigungen zum Ausführen von PowerShell-Skripten verfügen. Die Schritt-für-Schritt-Anleitungen enthalten Anweisungen.
• Haben Sie während eines Imports keine anderen aktiven Benutzerverbindungen. Die Importskripte erstellen viele neue Objekte, und es könnten Störungen auftreten, wenn andere Benutzer gleichzeitig die Konfiguration ändern.

Denken Sie daran, dass Sie Daten exportieren und dann den Parameter -Preview mit den Import-Cmdlets verwenden können, um zu sehen, was während eines tatsächlichen Imports passieren würde, ohne tatsächlich etwas zu importieren. Die Protokolle zeigen genau an, was während eines tatsächlichen Imports passieren würde. Wenn Fehler auftreten, können Sie diese beheben, bevor Sie einen tatsächlichen Import starten.

Schritt für Schritt: Daten exportieren

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

1. Laden Sie das Migrationswerkzeugpaket XAMigration.zip von der Citrix Download-Site herunter. Legen Sie es der Einfachheit halber auf einer Netzwerkfreigabe ab, auf die sowohl die XenApp 6.x-Farm als auch die XenApp 7.6-Site zugreifen können. Entpacken Sie XAMigration.zip auf der Netzwerkfreigabe. Es gibt zwei Zip-Dateien: ReadIMA.zip und ImportFMA.zip.

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

3. Kopieren Sie ReadIMA.zip von der Netzwerkfreigabe auf den XenApp 6.x Controller. Entpacken und extrahieren Sie ReadIMA.zip auf dem Controller in einen Ordner (zum Beispiel: C:\XAMigration).

4. Öffnen Sie eine PowerShell-Konsole und legen Sie das aktuelle Verzeichnis auf den Skriptspeicherort fest (zum Beispiel: cd C:\XAMigration).

5. Überprüfen Sie die Skriptausführungsrichtlinie, indem Sie Get-ExecutionPolicy ausführen.

6. Legen Sie die Skriptausführungsrichtlinie auf mindestens RemoteSigned fest, um die Ausführung der Skripts zu ermöglichen (zum Beispiel: Set-ExecutionPolicy RemoteSigned).

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

   Import-Module .\ExportPolicy.psd1

   Import-Module .\ExportXAFarm.psd1

   Gut zu wissen:

   • Wenn Sie nur Richtliniendaten exportieren möchten, können Sie nur die Moduldefinitionsdatei ExportPolicy.psd1 importieren. Wenn Sie nur Farmdaten exportieren möchten, importieren Sie nur ExportXAFarm.psd1.
   • Das Importieren der Moduldefinitionsdateien fügt auch die erforderlichen PowerShell-Snap-Ins hinzu.
   • Importieren Sie die Skriptdateien .psm1 nicht.

8. Um Richtliniendaten zu exportieren, führen Sie das Cmdlet Export-Policy aus.

   Parameter	Beschreibung
   -XmlOutputFile “.xml"	Name der XML-Ausgabedatei. Diese Datei enthält die exportierten Daten. Muss die Erweiterung .xml haben. Die Datei darf nicht existieren, aber wenn ein Pfad angegeben wird, muss der übergeordnete Pfad existieren. Standard: Keine. Dieser Parameter ist erforderlich.
   -Protokolldatei “"	Name der Protokolldatei. Eine Erweiterung ist optional. Die Datei wird erstellt, wenn sie nicht existiert. Wenn die Datei existiert und der Parameter NoClobber ebenfalls angegeben ist, wird ein Fehler generiert. Andernfalls wird der Inhalt der Datei überschrieben. Standard: Siehe Protokollierung und Fehlerbehandlung.
   -NoLog	Keine Protokollausgabe generieren. Dies überschreibt den Parameter LogFile, falls dieser ebenfalls angegeben ist. Standard: False. Protokollausgabe wird generiert.
   -NoClobber	Eine vorhandene Protokolldatei, die im Parameter LogFile angegeben ist, nicht überschreiben. Wenn die Protokolldatei nicht existiert, hat dieser Parameter keine Auswirkung. Standard: False. Eine vorhandene Protokolldatei wird überschrieben.
   -NoDetails	Keine detaillierten Berichte über die Skriptausführung an die Konsole senden. Standard: False. Detaillierte Berichte werden an die Konsole gesendet.
   -SuppressLogo	Die Meldung XenApp 6.x to XenApp/XenDesktop 7.6 Migration Tool Version #yyyyMMdd-hhmm# nicht an die Konsole ausgeben. Diese Meldung, die die Skriptversion identifiziert, kann bei der Fehlerbehebung hilfreich sein. Daher empfiehlt Citrix, diesen Parameter wegzulassen. Standard: False. Die Meldung wird an die Konsole ausgegeben.

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

   Export-Policy -XmlOutputFile ".\MyPolicies.XML" -LogFile ".\MyPolicies.Log"
   <!--NeedCopy-->
   

9. Um Farmdaten zu exportieren, führen Sie das Cmdlet Export-XAFarm aus und geben Sie eine Protokolldatei und eine XML-Datei an.

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

Nach Abschluss der Exportskripte enthalten die in den Befehlszeilen angegebenen XML-Dateien die Richtlinien- und XenApp-Farmdaten. Die Anwendungssymbol-Dateien enthalten Symboldaten, und die Protokolldatei gibt an, was während des Exports geschehen ist.

Schritt-für-Schritt: Daten importieren

Denken Sie daran, dass Sie einen Vorschauimport ausführen können (indem Sie das Import-Policy- oder Import-XAFarm-Cmdlet 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 in eine XenApp 7.6-Site zu importieren, indem Sie die aus dem Export generierten XML-Dateien verwenden.

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

2. Wenn Sie das Migrations-Tool-Paket XAMigration auf der Netzwerkfreigabe noch nicht entpackt haben, tun Sie dies jetzt. Kopieren Sie ImportFMA.zip von der Netzwerkfreigabe auf den XenApp 7.6 Controller. Entpacken und extrahieren Sie ImportFMA.zip auf dem Controller in einen Ordner (zum Beispiel C:\XAMigration).

3. Kopieren Sie die XML-Dateien (die während des Exports generierten Ausgabedateien) vom XenApp 6.x Controller an denselben Speicherort auf dem XenApp 7.6 Controller, an dem Sie die ImportFMA.zip-Dateien extrahiert haben.

   Wenn Sie sich entschieden haben, die Anwendungs-Icon-Daten nicht in die XML-Ausgabedatei einzubetten, als Sie Export-XAFarm ausgeführt haben, kopieren Sie den Icon-Datenordner und die Dateien an denselben Speicherort auf dem XenApp 7.6 Controller wie die XML-Ausgabedatei, die die Anwendungsdaten und die extrahierten ImportFMA.zip-Dateien enthält.

4. Öffnen Sie eine PowerShell-Konsole und legen Sie das aktuelle Verzeichnis auf den Skriptspeicherort fest (zum Beispiel: cd C:\XAMigration).

5. Überprüfen Sie die Skriptausführungsrichtlinie, indem Sie Get-ExecutionPolicy ausführen.

6. Legen Sie die Skriptausführungsrichtlinie auf mindestens RemoteSigned fest, um die Ausführung der Skripte zu ermöglichen (zum Beispiel: Set-ExecutionPolicy RemoteSigned).

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

   Import-Module .\ImportPolicy.psd1

   Import-Module .\ImportXAFarm.psd1

   Gut zu wissen:

   • Wenn Sie nur Richtliniendaten importieren möchten, können Sie nur die Moduldefinitionsdatei ImportPolicy.psd1 importieren. Wenn Sie nur Farmdaten importieren möchten, importieren Sie nur ImportXAFarm.psd1.
   • Das Importieren der Moduldefinitionsdateien fügt auch die erforderlichen PowerShell-Snap-Ins hinzu.
   • Importieren Sie die .psm1 Skriptdateien nicht.

8. Um Richtliniendaten zu importieren, führen Sie das Import-Policy Cmdlet aus, wobei Sie die XML-Datei angeben, die die exportierten Richtliniendaten enthält.

   Parameter	Beschreibung
   -XmlInputFile “.xml"	Name der XML-Eingabedatei. Diese Datei enthält Daten, die durch Ausführen des Export-Policy Cmdlets gesammelt wurden. Muss eine .xml Erweiterung haben. Standard: Keine. Dieser Parameter ist erforderlich.
   -XsdDatei “"	Name der XSD-Datei. Die Importskripte verwenden diese Datei, um die Syntax der XML-Eingabedatei zu validieren. Siehe Erweiterte Nutzung für Informationen zur Verwendung. Standard: PolicyData.XSD
   -LogDatei “"	Name der Protokolldatei. Wenn Sie die Export-Protokolldateien auf diesen Server kopiert haben, sollten Sie einen anderen Protokolldateinamen mit dem Import-Cmdlet verwenden. Standard: Siehe Protokollierung und Fehlerbehandlung.
   -NoLog	Keine Protokollausgabe generieren. Dies überschreibt den Parameter LogFile, falls dieser ebenfalls angegeben ist. Standard: Falsch. Protokollausgabe wird generiert.
   -NoClobber	Eine vorhandene Protokolldatei, die im Parameter LogFile angegeben ist, nicht überschreiben. Wenn die Protokolldatei nicht existiert, hat dieser Parameter keine Auswirkung. Standard: Falsch. Eine vorhandene Protokolldatei wird überschrieben.
   -NoDetails	Senden Sie keine detaillierten Berichte über die Skriptausführung an die Konsole. Standard: Falsch. Detaillierte 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 auf der Konsole aus. Diese Meldung, die die Skriptversion identifiziert, kann bei der Fehlerbehebung hilfreich sein. Daher empfiehlt Citrix, diesen Parameter wegzulassen. Standard: Falsch. Die Meldung wird auf der Konsole ausgegeben.
   -Preview	Führen Sie einen Vorschauimport durch: Lesen Sie Daten aus der XML-Eingabedatei, importieren Sie jedoch keine Objekte in die Site. Die Protokolldatei und die Konsole zeigen an, was während des Vorschauimports geschehen ist. Eine Vorschau zeigt Administratoren, was bei einem echten Import passieren würde. Standard: Falsch. Ein echter Import findet statt.

   Beispiel: Das folgende Cmdlet importiert Richtliniendaten aus der XML-Datei mit dem Namen MyPolcies.xml. Der Vorgang wird in der Datei mit dem Namen MyPolicies.log protokolliert.

   Import-Policy -XmlInputFile ".\MyPolicies.XML"
   -LogFile ".\MyPolicies.Log"
   <!--NeedCopy-->
   

9. Um Anwendungen zu importieren, führen Sie das Cmdlet Import-XAFarm aus und geben Sie eine Protokolldatei sowie die XML-Datei an, die die exportierten Farmdaten enthält.

   Parameter	Beschreibung
   -XmlInputFile “.xml"	Name der XML-Eingabedatei. Diese Datei enthält Daten, die beim Ausführen des Cmdlets Export-XAFarm gesammelt wurden. Muss die Erweiterung .xml haben. Standard: Keine. Dieser Parameter ist erforderlich.
   -XsdDatei “"	XSD-Dateiname. Die Importskripte verwenden diese Datei, um die Syntax der XML-Eingabedatei zu validieren. Informationen zur Verwendung finden Sie unter Erweiterte Nutzung. Standard: XAFarmData.XSD
   -Protokolldatei “"	Protokolldateiname. Wenn Sie die Export-Protokolldateien auf diesen Server kopiert haben, sollten Sie einen anderen Protokolldateinamen mit dem Import-Cmdlet verwenden. Standard: Siehe Protokollierung und Fehlerbehandlung.
   -NoLog	Keine Protokollausgabe generieren. Dies überschreibt den Parameter LogFile, falls dieser ebenfalls angegeben ist. Standard: False. Protokollausgabe wird generiert.
   -NoClobber	Eine vorhandene Protokolldatei, die im Parameter LogFile angegeben ist, nicht überschreiben. Wenn die Protokolldatei nicht existiert, hat dieser Parameter keine Auswirkung. Standard: False. Eine vorhandene Protokolldatei wird überschrieben.
   -NoDetails	Keine detaillierten Berichte über die Skriptausführung an die Konsole senden. Standard: False. Detaillierte Berichte werden an die Konsole gesendet.
   -SuppressLogo	Die Meldung XenApp 6.x to XenApp/XenDesktop 7.6 Migration Tool Version #yyyyMMdd-hhmm# nicht an die Konsole ausgeben. Diese Meldung, die die Skriptversion identifiziert, kann bei der Fehlerbehebung hilfreich sein. Daher empfiehlt Citrix, diesen Parameter wegzulassen. Standard: False. Die Meldung wird an die Konsole ausgegeben.
   -Preview	Einen Vorschau-Import durchführen: Daten aus der XML-Eingabedatei lesen, aber keine Objekte in die Site importieren. Die Protokolldatei und die Konsole zeigen an, was während des Vorschau-Imports passiert ist. Eine Vorschau zeigt Administratoren, was bei einem echten Import passieren würde. Standard: False. Ein echter Import findet statt.
   -Bereitstellungsgruppenname “"	Name der Bereitstellungsgruppe für alle importierten Anwendungen. Siehe Erweiterte Nutzung für Informationen zur Verwendung. Standard: “ -Delivery Group”
   -OrdnerAbgleichen “"	Nur die Anwendungen in Ordnern importieren, deren Namen der Zeichenfolge entsprechen. Siehe Erweiterte Nutzung für Informationen zur Verwendung. Standard: Es findet keine Übereinstimmung statt.
   -OrdnerNichtAbgleichen “"	Importieren Sie nur die Anwendungen in Ordnern, deren Namen nicht mit der Zeichenfolge übereinstimmen. Informationen zur Verwendung finden Sie unter Erweiterte Nutzung. Standard: Es erfolgt keine Übereinstimmung.
   -ServerAbgleichen “"	Importieren Sie nur die Anwendungen von Servern, deren Namen mit der Zeichenfolge übereinstimmen. Informationen zur Verwendung finden Sie unter Erweiterte Nutzung.
   -ServerNichtAbgleichen “"	Importieren Sie nur die Anwendungen von Servern, deren Namen nicht mit der Zeichenfolge übereinstimmen. Informationen zur Verwendung finden Sie unter Erweiterte Nutzung. Standard: Es erfolgt keine Übereinstimmung.
   -WorkerGruppeAbgleichen “"	Importieren Sie nur die Anwendungen, die für Worker-Gruppen veröffentlicht wurden, deren Namen mit der Zeichenfolge übereinstimmen. Informationen zur Verwendung finden Sie unter Erweiterte Nutzung. Standard: Es erfolgt keine Übereinstimmung.
   -WorkerGruppeNichtAbgleichen “"	Importieren Sie nur die Anwendungen, die für Worker-Gruppen veröffentlicht wurden, deren Namen nicht mit der Zeichenfolge übereinstimmen. Informationen zur Verwendung finden Sie unter Erweiterte Nutzung. Standard: Es erfolgt keine Übereinstimmung.
   -KontoAbgleichen “"	Importieren Sie nur die Anwendungen, die für Benutzerkonten veröffentlicht wurden, deren Namen mit der Zeichenfolge übereinstimmen. Informationen zur Verwendung finden Sie unter Erweiterte Nutzung. Standard: Es erfolgt keine Übereinstimmung.
   -KontoNichtAbgleichen “"	Importieren Sie nur die Anwendungen, die für Benutzerkonten veröffentlicht wurden, deren Namen nicht mit der Zeichenfolge übereinstimmen. Informationen zur Verwendung finden Sie unter Erweiterte Nutzung. Standard: Es erfolgt keine Übereinstimmung.
   -IncludeStreamedApps	Anwendungen vom Typ StreamedToClientOrServerInstalled importieren. (Keine anderen gestreamten Anwendungen werden importiert.) Standard: Gestreamte Anwendungen werden nicht importiert.
   -IncludeDisabledApps	Anwendungen importieren, die als deaktiviert markiert wurden. Standard: Deaktivierte Anwendungen werden nicht importiert.

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

   Import-XAFarm -XmlInputFile ".\MyFarm.XML"
   -LogFile ".\MyFarm.Log"
   
   <!--NeedCopy-->
   

10. Nachdem der Import erfolgreich abgeschlossen wurde, führen Sie die Aufgaben nach der Migration aus.

Aufgaben nach der Migration

Nachdem Sie XenApp 6.x-Richtlinien und Farm-Einstellungen erfolgreich in eine XenApp 7.6-Site importiert haben, verwenden Sie die folgende Anleitung, um sicherzustellen, dass die Daten korrekt importiert wurden.

Richtlinien und Richtlinieneinstellungen

Das Importieren von Richtlinien ist im Wesentlichen ein Kopiervorgang, mit Ausnahme von veralteten Einstellungen und Richtlinien, die nicht importiert werden. Die Überprüfung nach der Migration beinhaltet im Wesentlichen den Vergleich der beiden Seiten.

1. Die Protokolldatei listet alle importierten und ignorierten Richtlinien und Einstellungen auf. Überprüfen Sie zunächst die Protokolldatei und identifizieren Sie, welche Einstellungen und Richtlinien nicht importiert wurden.

2. Vergleichen Sie die XenApp 6.x-Richtlinien mit den in XenApp 7.6 importierten Richtlinien. Behalten Sie die Einstellungswerte bei (außer bei veralteten Richtlinieneinstellungen, wie im nächsten Schritt beschrieben).

   • Wenn Sie nur wenige Richtlinien haben, können Sie einen visuellen Vergleich der im XenApp 6.x AppCenter angezeigten Richtlinien mit den im XenApp 7.6 Studio angezeigten Richtlinien nebeneinander durchführen.
   • Wenn Sie viele Richtlinien haben, ist ein visueller Vergleich möglicherweise nicht praktikabel. Verwenden Sie in solchen Fällen das Richtlinienexport-Cmdlet (Export-Policy), um die XenApp 7.6-Richtlinien in eine andere XML-Datei zu exportieren, und verwenden Sie dann ein Textvergleichstool (wie windiff), um die Daten dieser Datei mit den Daten in der XML-Datei zu vergleichen, die beim Richtlinienexport aus XenApp 6.x verwendet wurde.

3. Verwenden Sie die Informationen im Abschnitt Nicht importierte Richtlinieneinstellungen, um festzustellen, was sich während des Imports möglicherweise geändert hat. Wenn eine XenApp 6.x-Richtlinie als gesamte Richtlinie nur veraltete Einstellungen enthält, wird sie nicht importiert. Wenn eine XenApp 6.x-Richtlinie beispielsweise nur HMR-Testeinstellungen enthält, wird diese Richtlinie ignoriert, da in XenApp 7.6 keine entsprechende Einstellung unterstützt wird.

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

4. Überprüfen und bestätigen Sie, wie Filter auf Ihre XenApp 7.6 Site angewendet werden, im Vergleich zu ihrer Verwendung in XenApp 6.x. Erhebliche Unterschiede zwischen der XenApp 6.x Farm und der XenApp 7.6 Site könnten die Wirkung der Filter verändern.

Filter

Überprüfen Sie die Filter für jede Richtlinie sorgfältig. Möglicherweise sind Änderungen erforderlich, um sicherzustellen, dass sie in XenApp 7.6 weiterhin wie ursprünglich in XenApp 6.x beabsichtigt funktionieren.

Zusammenfassend lässt sich sagen, dass Filter, die Änderungen an Domänenbenutzern betreffen, die größte Aufmerksamkeit erfordern, wenn die XenApp 6.x-Farm und die XenApp 7.6-Site in verschiedenen Domänen liegen. Da das Importskript nur Zeichenfolgen von Domänen- und Benutzernamen verwendet, um Benutzer in der neuen Domäne aufzulösen, werden möglicherweise nur einige Konten aufgelöst. Obwohl die Wahrscheinlichkeit gering ist, dass verschiedene Domänen und Benutzer denselben Namen haben, überprüfen Sie diese Filter sorgfältig, um sicherzustellen, dass sie korrekte Werte enthalten.

Anwendungen

Die Skripte zum Importieren von Anwendungen importieren nicht nur Anwendungen. Sie erstellen auch Objekte wie Delivery Groups. Wenn der Anwendungsimport mehrere Iterationen umfasst, können sich die ursprünglichen Anwendungsordnerhierarchien erheblich ändern.

1. Lesen Sie zunächst die Migrationsprotokolldateien, die Details darüber enthalten, welche Anwendungen importiert, welche Anwendungen ignoriert wurden und welche Cmdlets zum Erstellen der Anwendungen verwendet wurden.
2. Für jede Anwendung:
   • Überprüfen Sie visuell, ob die grundlegenden Eigenschaften während des Imports beibehalten wurden. Verwenden Sie die Informationen im Abschnitt Anwendungseigenschaftszuordnung, um festzustellen, welche Eigenschaften unverändert importiert, nicht importiert oder mithilfe der XenApp 6.x-Anwendungsdaten initialisiert wurden.
   • Überprüfen Sie die Benutzerliste. Das Importskript importiert die explizite Benutzerliste automatisch in die Sichtbarkeitsbeschränkungsliste der Anwendung in XenApp 7.6. Überprüfen Sie, ob die Liste gleich bleibt.
3. Anwendungsserver werden nicht importiert. Das bedeutet, dass noch keine der importierten Anwendungen zugänglich ist. Die Delivery Groups, die diese Anwendungen enthalten, müssen Maschinenkatalogen zugewiesen werden, die die Maschinen mit den ausführbaren Images der veröffentlichten Anwendungen enthalten. Für jede Anwendung:
   • Stellen Sie sicher, dass der ausführbare Name und das Arbeitsverzeichnis auf eine ausführbare Datei verweisen, die auf den Maschinen vorhanden ist, die der Delivery Group zugewiesen sind (über die Maschinenkataloge).
   • Überprüfen Sie einen Befehlszeilenparameter (der alles sein kann, z. B. Dateiname, Umgebungsvariable oder ausführbarer Name). Vergewissern Sie sich, dass der Parameter für alle Maschinen in den Maschinenkatalogen, die der Delivery Group zugewiesen sind, gültig ist.

Protokolldateien

Die Protokolldateien sind die wichtigsten Referenzressourcen für einen Import und Export. Aus diesem Grund werden vorhandene Protokolldateien standardmäßig nicht überschrieben, und die Standardnamen der Protokolldateien sind eindeutig.

Wie unter Protokollierung und Fehlerbehandlung beschrieben, bietet die Ausgabe, zusammen mit der Protokolldatei, eine vollständige Referenz der Import- und Exportaktivitäten, wenn Sie zusätzliche Protokollierungsabdeckung mit den PowerShell-Cmdlets Start-Transcript und Stop-Transcript verwenden (die alles aufzeichnen, was eingegeben und in der Konsole ausgegeben wird).

Mithilfe der Zeitstempel 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 die Auflösung von Benutzerkonten die meiste Zeit in Anspruch genommen hat.

Die in den Protokolldateien aufgezeichneten Befehle zeigen Ihnen auch, wie einige Objekte gelesen oder erstellt werden. Um beispielsweise eine Bereitstellungsgruppe zu erstellen, erstellen mehrere Befehle nicht nur das Bereitstellungsgruppenobjekt, sondern auch andere Objekte wie Zugriffsrichtlinienregeln, die die Zuweisung von Anwendungsobjekten zur Bereitstellungsgruppe ermöglichen.

Die Protokolldatei kann auch zur Diagnose eines fehlgeschlagenen Exports oder Imports verwendet werden. Typischerweise geben die letzten Zeilen der Protokolldatei an, was den Fehler verursacht hat. Die Fehlermeldung wird ebenfalls in der Protokolldatei gespeichert. Zusammen mit der XML-Datei kann die Protokolldatei verwendet werden, um festzustellen, welches Objekt an dem Fehler beteiligt war.

Nachdem Sie die Migration überprüft und getestet haben, können Sie Folgendes tun:

1. Aktualisieren Sie Ihre XenApp 6.5 Worker-Server auf aktuelle Virtual Delivery Agents (VDAs), indem Sie das 7.6-Installationsprogramm auf dem Server ausführen, das die XenApp 6.5-Software entfernt und dann automatisch einen aktuellen VDA installiert. Anweisungen finden Sie unter Aktualisieren eines XenApp 6.5 Workers auf einen neuen VDA für Windows Server OS.

   Bei XenApp 6.0 Worker-Servern müssen Sie die XenApp 6.0-Software manuell vom Server deinstallieren. Anschließend können Sie das 7.6-Installationsprogramm verwenden, um den aktuellen VDA zu installieren. Sie können das 7.6-Installationsprogramm nicht verwenden, um die XenApp 6.0-Software automatisch zu entfernen.

2. Erstellen Sie in Studio auf der neuen XenApp-Site Maschinenkataloge (oder bearbeiten Sie vorhandene Kataloge) für die aktualisierten Worker.

3. Fügen Sie die aktualisierten Maschinen aus dem Maschinenkatalog den Bereitstellungsgruppen hinzu, die die auf diesen VDAs für Windows Server OS installierten Anwendungen enthalten.

Erweiterte Nutzung

Standardmäßig exportiert das Cmdlet Export-Policy alle Richtliniendaten in eine XML-Datei. Ebenso exportiert Export-XAFarm alle Farmdaten in eine XML-Datei. Sie können Befehlszeilenparameter verwenden, um genauer zu steuern, was exportiert und importiert wird.

Anwendungen teilweise exportieren

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 Anwendungen an, die übersprungen werden sollen, bevor nachfolgende Anwendungen exportiert werden.

Sie können beide Parameter verwenden, um große Mengen von Anwendungen in überschaubaren Blöcken zu exportieren. Wenn Sie beispielsweise Export-XAFarm zum ersten Mal ausführen, möchten Sie nur die ersten 200 Anwendungen exportieren. Daher geben Sie diesen Wert im Parameter AppLimit an.

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

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

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

Bestimmte Objekte nicht exportieren

Einige Objekte können ignoriert werden und müssen daher nicht exportiert werden, insbesondere solche Objekte, die nicht importiert werden. Siehe Nicht importierte Richtlinieneinstellungen und Anwendungseigenschaftszuordnung. Verwenden Sie die folgenden Parameter, um den Export nicht benötigter Objekte zu verhindern:

• IgnoreAdmins – Administratorobjekte nicht exportieren
• IgnoreServers – Serverobjekte nicht exportieren
• IgnoreZones – Zonenobjekte nicht exportieren
• IgnoreOthers – Konfigurationsprotokollierung, Lastauswerter, Lastenausgleichsrichtlinie, Druckertreiber und Worker-Gruppenobjekte nicht exportieren
• IgnoreApps – Anwendungen nicht exportieren. Dieser Parameter ermöglicht es Ihnen, andere Daten in eine XML-Ausgabedatei zu exportieren und den Export dann erneut auszuführen, um Anwendungen in eine andere XML-Ausgabedatei zu exportieren.

Sie können diese Parameter auch verwenden, um Probleme zu umgehen, die zum Fehlschlagen des Exports führen könnten. Wenn Sie beispielsweise einen fehlerhaften Server in einer Zone haben, kann der Zonenexport fehlschlagen. Wenn Sie den Parameter IgnoreZones einschließen, wird der Export mit anderen Objekten fortgesetzt.

Namen von Bereitstellungsgruppen

Wenn Sie nicht alle Ihre Anwendungen in eine Bereitstellungsgruppe aufnehmen möchten (z. B. weil sie von verschiedenen Benutzergruppen aufgerufen und auf verschiedenen Servergruppen veröffentlicht werden), können Sie Import-XAFarm mehrmals ausführen und jedes Mal andere Anwendungen und eine andere Bereitstellungsgruppe angeben. Obwohl Sie PowerShell-Cmdlets verwenden können, um Anwendungen nach der Migration von einer Bereitstellungsgruppe in eine andere zu verschieben, kann der selektive Import in eindeutige Bereitstellungsgruppen den Aufwand für das spätere Verschieben der Anwendungen reduzieren oder eliminieren.

• Verwenden Sie den Parameter DeliveryGroupName mit dem Cmdlet Import-XAFarm. Das Skript erstellt die angegebene Bereitstellungsgruppe, falls sie nicht existiert.

• Verwenden Sie die folgenden Parameter mit regulären Ausdrücken, um die in die Bereitstellungsgruppe zu importierenden Anwendungen basierend auf Ordner-, Worker-Gruppen-, Benutzerkonto- und Servernamen zu filtern. Es wird empfohlen, den regulären Ausdruck in einfache oder doppelte Anführungszeichen zu setzen. Informationen zu regulären Ausdrücken finden Sie unter https://docs.microsoft.com/de-de/dotnet/standard/base-types/regular-expressions.

  • MatchWorkerGroup und NotMatchWorkerGroup – Wenn Anwendungen beispielsweise für Worker-Gruppen veröffentlicht werden, importiert das folgende Cmdlet Anwendungen in der Worker-Gruppe mit dem Namen Productivity Apps in eine XenApp 7.6 Delivery Group mit demselben Namen:

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

  • MatchFolder und NotMatchFolde – Wenn Anwendungen beispielsweise in Anwendungsordnern organisiert sind, importiert das folgende Cmdlet Anwendungen im Ordner mit dem Namen Productivity Apps in eine XenApp 7.6 Delivery Group mit demselben Namen.

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

    Das folgende Cmdlet importiert beispielsweise Anwendungen in jedem Ordner, dessen Name MS Office Apps enthält, in die Standard-Delivery Group.

     Import-XAFarm -XmlInputFile .\THeFarmApps.XML -MatchFolder ".*/MS Office Apps/.*"
     <!--NeedCopy-->
    

  • MatchAccount und NotMatchAccount – Wenn Anwendungen beispielsweise für Active Directory-Benutzer oder Benutzergruppen veröffentlicht werden, importiert das folgende Cmdlet Anwendungen, die für die Benutzergruppe mit dem Namen Finance Group veröffentlicht wurden, in eine XenApp 7.6 Delivery Group mit dem Namen Finance.

     Import-XAFarm –XmlInputFile XAFarm.xml –LogFile XAFarmImport.log –MatchAccount ‘DOMAIN\\Finance Group’ –DeliveryGroupName ‘Finance’
     <!--NeedCopy-->
    

  • MatchServer und NotMatchServer – Wenn Anwendungen beispielsweise auf Servern organisiert sind, importiert das folgende Cmdlet Anwendungen, die dem Server zugeordnet sind, der nicht Current heißt, in eine Delivery Group 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 beispielsweise das Exportskript als Inventurtool verwenden, um Änderungen in einer XenApp 6.x-Farm zu verfolgen. Sie können auch die XSD-Dateien ändern oder (eigene XSD-Dateien erstellen), um zusätzliche Daten oder Daten in verschiedenen Formaten in den XML-Dateien zu speichern. Sie können mit jedem der Import-Cmdlets eine nicht standardmäßige XSD-Datei angeben.

Obwohl Sie Skriptdateien ändern können, um spezifische oder erweiterte Migrationsanforderungen zu erfüllen, ist der Support auf die Skripte in ihrem unveränderten Zustand beschränkt. Der technische Support von Citrix empfiehlt, auf die unveränderten Skripte zurückzugreifen, um das erwartete Verhalten zu ermitteln und bei Bedarf Unterstützung zu leisten.

Problembehandlung

• Wenn Sie PowerShell Version 2.0 verwenden und das Citrix Group Policy PowerShell Provider-Snap-In oder das Citrix Common Commands-Snap-In mit dem Cmdlet Add-PSSnapIn hinzugefügt haben, wird möglicherweise die Fehlermeldung Object reference not set to an instance of an object angezeigt, wenn Sie die Export- oder Import-Cmdlets ausführen. Dieser Fehler hat keine Auswirkungen auf die Skriptausführung und kann ignoriert werden.

• Vermeiden Sie das Hinzufügen oder Entfernen des Citrix Group Policy PowerShell Provider-Snap-Ins in derselben Konsolensitzung, in der die Export- und Import-Skriptmodule verwendet werden, da diese Skriptmodule das Snap-In automatisch hinzufügen. Wenn Sie das Snap-In separat hinzufügen oder entfernen, wird möglicherweise 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. Das Snap-In versucht, das Laufwerk LocalGpo beim Laden einzubinden, und meldet dann den Fehler.
  • A parameter cannot be found that matches parameter name 'Controller'. Dieser Fehler tritt auf, wenn das Snap-In nicht hinzugefügt wurde, das Skript aber versucht, das Laufwerk einzubinden. Das Skript weiß 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 Sie es nicht.
• Wenn Sie beim Importieren der Module mit der rechten Maustaste auf eine .psd1-Datei klicken und Öffnen oder Mit PowerShell öffnen auswählen, öffnet und schließt sich das PowerShell-Konsolenfenster schnell, bis Sie den Vorgang beenden. Um diesen Fehler zu vermeiden, geben Sie den vollständigen Namen des PowerShell-Skriptmoduls direkt in das PowerShell-Konsolenfenster ein (z. B. Import-Module .\ExportPolicy.psd1).
• Wenn Sie beim Ausführen eines Exports oder Imports einen Berechtigungsfehler erhalten, stellen Sie sicher, dass Sie ein XenApp-Administrator mit der Berechtigung zum Lesen von Objekten (für den Export) oder zum Lesen und Erstellen von Objekten (für den Import) sind. Sie müssen auch über ausreichende Windows-Berechtigungen verfügen, um PowerShell-Skripte auszuführen.
• Wenn ein Export fehlschlägt, überprüfen Sie, ob die XenApp 6.x Farm in einem fehlerfreien Zustand ist, indem Sie die Dienstprogramme DSMAINT und DSCHECK auf dem XenApp 6.x Controller-Server ausführen.
• Wenn Sie einen Vorschauimport ausführen und später die Import-Cmdlets erneut für eine tatsächliche Migration ausführen, aber feststellen, dass nichts importiert wurde, überprü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 niemals importiert. Die Funktionen und Komponenten, die diese Einstellungen unterstützen, wurden entweder durch neue Technologien und Komponenten ersetzt, oder die Einstellungen sind aufgrund architektonischer und plattformbezogener Änderungen nicht mehr anwendbar.

Nicht importierte Computerrichtlinieneinstellungen

• Verbindungszugriffssteuerung
• CPU-Verwaltung auf Serverebene
• DNS-Adressauflösung
• Farmname
• Vollständiges Icon-Caching
• Integritätsüberwachung, Integritätsüberwachungstests
• Hostname des Lizenzservers, Port des Lizenzservers
• Benutzersitzungen begrenzen, Begrenzungen für Administratorsitzungen
• Name des Lastauswerters
• Protokollierung von Anmeldegrenzwert-Ereignissen
• Maximaler Prozentsatz von Servern mit Anmeldekontrolle
• Speicheroptimierung, Ausschlussliste für Anwendungen der Speicheroptimierung, Intervall der Speicheroptimierung, Zeitplan für Speicheroptimierung: Tag des Monats, Zeitplan für Speicheroptimierung: Wochentag, Zeitplan für Speicheroptimierung: Uhrzeit
• Clientvertrauen für Offline-Apps, Ereignisprotokollierung für Offline-Apps, Lizenzzeitraum für Offline-Apps, Benutzer von Offline-Apps
• Passwortabfrage
• Benutzerdefinierte Neustartwarnung, Text der benutzerdefinierten Neustartwarnung, Anmelde-Deaktivierungszeit für Neustart, Häufigkeit des Neustartzeitplans, Zufallsintervall des Neustartzeitplans, Startdatum des Neustartzeitplans, Uhrzeit des Neustartzeitplans, Neustartwarnungsintervall, Startzeit der Neustartwarnung, Neustartwarnung für Benutzer, Geplante Neustarts
• Shadowing *
• XML-Anfragen vertrauen (in StoreFront™ konfiguriert)
• Filterung von virtuellen IP-Adapteradressen, Kompatibilitätsprogrammliste für virtuelle IP, Erweiterte Kompatibilität für virtuelle IP, Programmliste für virtuelle IP-Filteradapteradressen
• Workload-Name
• XenApp-Produktedition, XenApp-Produktmodell
• XML-Dienstport

* Ersetzt durch Windows-Remoteunterstützung

Benutzerrichtlinieneinstellungen nicht importiert

• Client-COM-Ports automatisch verbinden, Client-LPT-Ports automatisch verbinden
• Client-COM-Port-Umleitung, Client-LPT-Port-Umleitung
• Clientdruckernamen
• Grenzwert für gleichzeitige Anmeldungen
• Eingabe von Shadow-Verbindungen *
• Linger-Trennungs-Zeitintervall, Linger-Beendigungs-Zeitintervall
• Shadow-Versuche protokollieren *
• Benutzer über ausstehende Shadow-Verbindungen benachrichtigen *
• Prelaunch-Trennungs-Zeitintervall, Prelaunch-Beendigungs-Zeitintervall
• Sitzungspriorität
• Single Sign-On, zentraler Single Sign-On-Speicher
• Benutzer, die andere Benutzer schatten können, Benutzer, die andere Benutzer nicht schatten 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 zum Streamen von Anwendungen)

Anwendungseigenschaftszuordnung

Das Farmdaten-Importskript importiert nur Anwendungen. Die folgenden Anwendungseigenschaften werden unverändert importiert.

IMA und FMA haben unterschiedliche Beschränkungen für die Länge von Ordnernamen. In IMA beträgt die Begrenzung für Ordnernamen 256 Zeichen. Die FMA-Begrenzung beträgt 64 Zeichen. Beim Importieren werden Anwendungen übersprungen, deren Ordnerpfad einen Ordnernamen mit mehr als 64 Zeichen enthält. Die Begrenzung gilt nur für den Ordnernamen im Ordnerpfad. Der gesamte Ordnerpfad kann länger sein als die angegebenen Begrenzungen. Um zu vermeiden, dass Anwendungen während des Imports übersprungen werden, empfiehlt Citrix, die Länge des Anwendungsordnernamens zu überprüfen und ihn bei Bedarf vor dem Export zu kürzen.

Die folgenden Anwendungseigenschaften werden standardmäßig initialisiert oder nicht initialisiert oder auf Werte gesetzt, die in den XenApp 6.x-Daten bereitgestellt werden:

Die folgenden Anwendungseigenschaften werden teilweise migriert:

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