Migrieren in die Cloud

Wenn Sie eine On-Premises-Konfiguration von Citrix Virtual Apps and Desktops in eine Citrix Virtual Apps and Desktops Service-Bereitstellung oder eine Citrix Virtual Apps and Desktops Service-Bereitstellung in eine andere Bereitstellungsregion verschieben möchten, die Konfiguration sichern und wiederherstellen möchten oder die Ressourcenlimits erreicht haben, können Sie nun Ihre Konfiguration ganz oder teilweise mit dem Automated Configuration Tool migrieren.

Das folgende 2-minütige Video bietet einen kurzen Überblick über die automatische Konfiguration.

Weitere Informationen zur automatisierten Konfiguration finden Sie unter Proof of Concept: Automated Configuration Tool in der Tech Zone.

Detaillierte Informationen zum Migrieren Ihrer Bereitstellung und zur Vorbereitung der Konfiguration für die Migration finden Sie unter Migrieren der On-Premises-Version von Citrix Virtual Apps and Desktops zu Citrix Cloud auf Tech Zone.

Erste Schritte mit der automatischen Konfiguration

Die automatische Konfiguration für Citrix Virtual Apps and Desktops ist ein Tool zum Automatisieren der Migration einer Citrix Virtual Apps and Desktops Service-Bereitstellung von:

• Einer On-Premises-Site
• Einer anderen Cloudsite
• Einem Cloudsite-Backup

Die automatische Konfiguration exportiert die Konfiguration in YML-Dateien, die dann optional (zum Testen der Migration) bearbeitet und in Citrix Virtual Apps and Desktops Service importiert werden können.

Dieser Abschnitt enthält allgemeine Erläuterungen zur Ausführung der Funktionen der automatischen Konfiguration.

Herunterladen der automatischen Konfiguration

Laden Sie das Tool zur automatischen Konfiguration von Citrix Downloads herunter und installieren Sie es.

Wichtig:

Um Funktionsfehler zu vermeiden, sollten Sie immer die neueste verfügbare Version der automatischen Konfiguration verwenden.

Upgrade der automatischen Konfiguration

Wenn Sie Cmdlets ausführen, die in der automatischen Konfiguration auf die Cloud zugreifen, erhalten Sie von dem Tool eine Benachrichtigung, wenn eine neuere Version zum Download verfügbar ist.

Sie können mit folgendem Verfahren sicherstellen, dass Sie über die neueste Version verfügen:

1. Doppelklicken Sie auf das Symbol Automatisches Konfigurieren. Ein PowerShell Fenster wird angezeigt.

2. Führen Sie den folgenden Befehl aus, um die Versionsnummer zu überprüfen.

   Get-CvadAcStatus

3. Prüfen Sie Ihre Version gegen die der in der Warnung oder unter Citrix Downloads aufgeführten Version. Die neueste Version befindet sich dort.
4. Laden Sie die aktuelle Softwareversion des Tools von Citrix herunter und installieren Sie es. Sie müssen hierfür die alte Version nicht deinstallieren.

Hinweis:

Die Benachrichtigung wird jedes Mal angezeigt, wenn Sie ein Cmdlet ausführen, das auf die Cloud zugreift. Weitere Informationen zu Cmdlets finden Sie unter Cmdlets der automatischen Konfiguration.

Voraussetzungen für die Migration Ihrer Konfiguration

Benutzer der automatischen Konfiguration müssen folgende Kenntnisse besitzen:

• Einrichtung und Verwaltung von Citrix Virtual Apps and Desktops
• YAML-Standard
• PowerShell

Exportieren der Citrix Virtual Apps and Desktops-Konfiguration:

• Aktuelle Version von Citrix Virtual Apps and Desktops und unmittelbare Vorgängerversion oder Citrix Virtual Apps and Desktops/XenApp und XenDesktop LTSR: alle Versionen
• Ein On-Premises-Delivery Controller und mindestens ein On-Premises-VDA
• Eine Maschine mit .NET Framework 4.7.2 oder höher
• Eine Maschine mit dem Citrix PowerShell SDK Dieses wird automatisch auf dem Delivery Controller installiert. (Wenn Sie es auf einer anderen Maschine als dem On-Premises-Delivery Controller ausführen möchten, muss diese Maschine zur Domäne gehören und dort Citrix Studio installiert sein, da mit Studio die richtigen PowerShell-Snap-Ins installiert werden. Das Studio-Installationsprogramm ist auf dem Citrix Virtual Apps and Desktops-Installationsmedium.)

Zum Importieren der Konfiguration in Citrix Virtual Apps and Desktops Service:

• Eine Maschine mit Zugriff auf Citrix Cloud. Dabei muss es sich weder um einen Delivery Controller noch um eine mit der Domäne verbundene Maschine handeln.
• Citrix Virtual Apps and Desktops Service bereitgestellt.
• Ein aktiver Ressourcenstandort mit installiertem Connector; er muss derselben Domäne angehören wie die On-Premises-Bereitstellung.
• Verbindung zu Sites, die auf Citrix Cloud zugreifen, muss zulässig und verfügbar sein. Weitere Informationen finden Sie unter Virtual Apps and Desktops Service-Konnektivität.

Unterstützte Objekte für die Migration

Die automatische Konfiguration unterstützt die folgenden Komponenten.

• Tags
• Delegierter Admin
  • Geltungsbereiche
  • Rollen
• Hostverbindungen
  • Ein einzelner Ressourcenpool
  • Admin-Geltungsbereiche
• Maschinenkataloge
  • Admin-Geltungsbereiche
  • Maschinen
  • Remote-PC-Zugriff, physisch, gepoolt, bereitgestellt (außer MCS), zugewiesen
• Bereitstellungsgruppen
  • Zugriffsrichtlinie
  • Admin-Bereichszuweisung
  • Anwendungszugriffsrichtlinie
  • Zuweisungsrichtlinie
  • Anspruch-/Desktoprichtlinie
  • Energiezeitpläne
  • Sitzungsfortbestehen
  • Vorabstart von Sitzungen
  • Neustartzeitpläne
  • Tags
• Anwendungsgruppen
  • Admin-Bereichszuweisung
  • Bereitstellungsgruppen
  • Benutzer und Gruppen
• Anwendungen
  • Anwendungsordner
  • Symbole
  • Anwendungen
  • Per Broker konfigurierte FTAs
  • Tags
• Gruppenrichtlinien

Abhängigkeit von Komponenten

Die Schritte beim Erstellen einer On-Premises-Site müssen aufgrund von Abhängigkeiten zwischen den einzelnen Elementen in einer bestimmten Reihenfolge ausgeführt werden. Die automatische Konfiguration funktioniert nach dem gleichen Prinzip.

Beim Import werden Updates präzise durchgeführt, es werden nur die erforderlichen Updates durchgeführt und es wird überprüft, ob alle Updates korrekt durchgeführt wurden.

Die Komponenten müssen in einer Reihenfolge importiert werden, in der Abhängigkeiten in der benötigten Reihenfolge erstellt werden. Die folgende Liste enthält die Komponenten, die in den Befehlen Export, Import, Merge, New, Sync und Restore ausgewählt werden können. Sie werden in der Abhängigkeitsreihenfolge aufgeführt. Das Importieren in einer anderen Reihenfolge kann zu Fehlern und einem Fehlschlagen des Vorgangs führen.

1. Tags
2. Administratorrollen und -bereiche (schließt Geltungsbereiche und Rollen ein, nicht aber Administratoren)
3. Hostverbindungen
4. Maschinenkataloge
5. Bereitstellungsgruppen (einschließlich StoreFront)
6. Anwendungsgruppen
7. Anwendungen (einschließlich Anwendungsordnern)
8. Gruppenrichtlinien

Die Komponenten müssen in einer Reihenfolge importiert werden, in der Abhängigkeiten in der benötigten Reihenfolge erstellt werden. Die automatische Konfiguration bringt Komponenten beim Importieren, Zusammenführen und Wiederherstellen mehrerer Komponenten in einer einzigen Cmdlet-Ausführung in die richtige Reihenfolge.

Beim Importieren einzelner Komponenten mit mehreren Befehlen müssen die Komponenten in die richtige Reihenfolge der Abhängigkeiten gebracht werden.

Wenn eine vollständige Sitekonfiguration erfolgreich importiert wurde, können für Updates individuelle Importvorgänge erfolgen.

Details zu Voraussetzungen

Die Komponenten und ihre Voraussetzungen sind hier aufgelistet. Abhängigkeiten einer Komponente müssen vor dem Import oder dem Zusammenführen vorhanden sein. Wenn eine Voraussetzung fehlt, kann der Befehl zum Importieren oder Zusammenführen fehlschlagen. Im Abschnitt Fixups der Protokolldatei werden bei Fehlschlagen des Imports oder des Zusammenführens fehlende Voraussetzungen aufgelistet.

1. Tags
   • Keine Voraussetzungen
2. Delegierter Admin
   • Keine Voraussetzungen
3. Hostverbindungen
   • Sicherheitsinformationen in CvadAcSecurity.yml
4. Maschinenkataloge
   • In Active Directory vorhandene Maschinen
   • Hostverbindungen
   • Tags
5. Bereitstellungsgruppen
   • In Active Directory vorhandene Maschinen
   • In Active Directory vorhandene Benutzer
   • Maschinenkataloge
   • Tags
6. Anwendungsgruppen
   • Bereitstellungsgruppen
   • Tags
7. Anwendungen
   • Bereitstellungsgruppen
   • Anwendungsgruppen
   • Tags
8. Gruppenrichtlinien
   • Bereitstellungsgruppen
   • Tags

Bekannte Einschränkungen

• Mit Maschinenerstellungsdienste bereitgestellte Maschinenkataloge werden derzeit nicht unterstützt. Sie können andere Objekte von Ihrer Site importieren. Weitere Informationen finden Sie unter Importieren anderer Objekte bei Vorhandensein von MCS-Maschinenkatalogen.
• Symbole werden nicht auf Maschinen oder Desktops angewendet.

Generieren der Kunden-ID, der Client-ID und des geheimen Schlüssels

Mit dem nachfolgenden Verfahren können Sie die Kunden-ID abrufen und die Client-ID und den geheimen Schlüssel erstellen, die zum Importieren der Konfiguration in Citrix Cloud erforderlich sind. Alle Cmdlets, die auf die Cloud zugreifen, benötigen diese Werte.

Zum Abrufen der Kunden-ID gehen Sie wie folgt vor:

1. Melden Sie sich bei Ihrem Citrix Cloud-Konto an und wählen Sie den Kunden aus.

2. Klicken Sie auf das Hamburger-Menü und wählen Sie die Option Identitäts- und Zugriffsverwaltung.

3. Die Kunden-ID ist auf der Seite Identitäts- und Zugriffsverwaltung.

Zum Abrufen der Client-ID und des geheimen Schlüssels gehen Sie wie folgt vor:

1. Klicken Sie auf der Seite Identitäts- und Zugriffsverwaltung auf API-Zugriff.

2. Geben Sie einen Namen in das Feld ein. Dieser Name wird zur Unterscheidung zwischen mehreren Client-IDs und geheimen Schlüsseln verwendet. Klicken Sie auf Client erstellen, um die Client-ID und den geheimen Schlüssel zu erstellen.

3. Wenn Sie die Client-ID und den geheimen Schlüssel erstellt haben, wird das folgende Dialogfeld angezeigt. Kopieren Sie beide Werte an einen sicheren Speicherort oder laden Sie die CSV-Datei herunter, die diese Informationen enthält.

4. Die Client-ID und der geheime Schlüssel werden erfolgreich erstellt.

Speichern Sie diese Werte an einem sicheren Ort und teilen Sie sie nur mit vertrauenswürdigen Personen im Unternehmen, die Zugriff auf das Tool oder auf die Cloud-Rest-APIs benötigen. Die Client-ID und der geheime Schlüssel laufen nicht ab. Werden sie kompromittiert, entfernen Sie sie sofort mit dem Papierkorb-Symbol und erstellen Sie neue.

Hinweis:

Der geheime Schlüssel kann nicht wiederhergestellt werden, wenn er verloren geht oder vergessen wird. Er muss zusammen mit der Client-ID und neu erstellt werden.

Auffüllen der Kundeninformationsdatei

Die Verwendung der Datei CustomerInfo.yml macht das Hinzufügen von Kundeninformationen als Cmdlet-Parameter überflüssig. Jede Kundeninformation kann per Cmdlet-Parameter überschrieben werden.

Erstellen Sie die Datei CustomerInfo.yml mit dem Cmdlet New-CvadAcCustomerInfoFile. New-CvadAcCustomerInfoFile hat die folgenden erforderlichen Parameter.

• CustomerId: die Kunden-ID.
• ClientID: Die Client-ID des Kunden, die in Citrix Cloud erstellt wurde.
• Geheimnis: Das Kundengeheimnis, das in Citrix Cloud erstellt wurde.

New-CvadAcCustomerInfoFile -CustomerId markhof123 -ClientId 6813EEA6-46CC-4F8A-BC71-539F2DAC5984 -Secret TwBLaaaaaaaaaaaaaaaaaw==

Aktualisieren Sie die Datei CustomerInfo.yml mithilfe des Cmdlets Set-CvadAcCustomerInfoFile.

Hinweis:

Das Cmdlet ändert nur die Client-ID.

Set-CvadAcCustomerInfoFile -ClientId C80487EE-7113-49F8-85DD-2CFE30CC398E

Nachfolgend sehen Sie das Beispiel einer CustomerInfo.yml-Datei.

            Created/Updated on 2020/01/29 16:46:47
            CustomerId: "markhof123"
            ClientId: "6713FEA6-46CC-4F8A-BC71-539F2DDK5384"
            Secret: "TwBLaaabbbaaaaaaaaaaw=="
            LogFileName: "CitrixLog"
            Environment: Production
            AltRootUrl: ""
            StopOnError: False
            AlternateFolder: ""
            Locale: "en-us"
            Editor: "C:\Program Files\Notepad++\notepad++.exe"
            Confirm: True
            DisplayLog: True

Auffüllen der Zonenzuordnungsdatei

Die On-Premises-Zone entspricht dem Cloudressourcenstandort. Im Gegensatz zu anderen Sitekomponenten können Sie die On-Premises-Zone nicht automatisch in die Cloud importieren. Sie muss stattdessen manuell über die Datei ZoneMapping.yml zugeordnet werden. Importfehler können auftreten, wenn der Zonenname keinem bestehenden Ressourcenstandort zugewiesen ist.

Bei On-Premises-Sites mit nur einer Zone und Cloudsites mit nur einem Ressourcenstandort führt die automatische Konfiguration die richtige Zuordnung durch, sodass die ZoneMapping.yml-Datei nicht manuell verwaltet werden muss.

Bei On-Premises-Sites mit mehreren Zonen und bei Cloudsites mit mehreren Ressourcenstandorten muss die ZoneMapping.yml-Datei manuell aktualisiert werden, damit sie die korrekte Zuordnung von On-Premises-Zonen zu Cloud-Ressourcenstandorten widerspiegelt. Dies muss vor jeglichem Import in die Cloud erledigt werden.

Die Datei ZoneMapping.yml ist in %HOMEPATH%\Documents\Citrix\AutoConfig. Die YML-Datei beinhaltet ein Wörterbuch mit dem Zonennamen als Schlüssel und dem Ressourcennamen als Wert.

Beispiel: Eine Citrix Virtual Apps and Desktops-On-Premises-Site mit der primären Zone “Zone-1” und der sekundären Zone “Zone-2” wird in eine Citrix Virtual Apps and Desktops-Cloudbereitstellung mit den beiden Ressourcenstandorten “Cloud-RL-1” und “Cloud-RL-2” migriert. In diesem Fall würde ZoneMapping.yml wie folgt konfiguriert:

            Zone-1: Cloud-RL-1

            Zone-2: Cloud-RL-2

Hinweis:

Ein Leerzeichen muss zwischen dem Doppelpunkt und dem Namen des Ressourcenstandorts stehen. Wenn ein Zonen- oder Ressourcenstandortname Leerzeichen enthält, setzen Sie den Namen in Anführungszeichen.

Migration von on-premises in die Cloud

Mit der automatischen Konfiguration können Sie das Verschieben der On-Premises-Konfiguration zu einer Cloud-Site automatisieren.

Übersicht über die Migration

Bei der Migration werden Daten aus einer Quelle exportiert und in ein Ziel importiert. Dieser Vorgang wird von der automatischen Konfiguration erledigt. Migriert ein Kunde eine On-Premises-Umgebung in die Cloud, stellt die On-Premises-Site die Quelle dar und die Cloudsite das Ziel. In seiner einfachsten Form umfasst der Migrationsprozess für den ersten Gebrauch die folgenden Schritte (mit Beispiel-Cmdlets).

1. Laden Sie das Tool zur automatischen Konfiguration herunter und installieren Sie es.
2. Exportieren Sie die On-Premises-Daten (Export-CvadAcToFile).
3. Bringen Sie die Sicherheitsinformationen für den Zugriff auf Ihre Cloudsite in Erfahrung.
4. Erstellen Sie die Kundeninformationsdatei mit den Sicherheitsinformationen, die von der automatischen Konfiguration verwendet werden (New-CvadAcCustomerInfoFile).
5. Importieren Sie die On-Premises-Daten in die Cloud (Import-CvadAcToSite, Merge-CvadAcToSite, New-CvadAcToSite).

Nachfolgende Migrationen sind noch einfacher.

1. Exportieren Sie die On-Premises-Daten (Export-CvadAcToFile).
2. Importieren Sie die On-Premises-Daten in die Cloud (Import-CvadAcToSite, Merge-CvadAcToSite, New-CvadAcToSite).

Dieser Prozess kann sogar auf einen Schritt reduziert werden.

1. Exportieren und importieren (Sync-CvadAcSiteToSite).

Exportieren der On-Premises-Konfiguration von Citrix Virtual Apps and Desktops

Wichtig:

• Sie müssen eine CustomerInfo.yml-Datei mit Ihrer Kunden-ID, Client-ID und dem geheimen Schlüssel haben. Informationen zum Abrufen der Kunden- und Client-ID und des geheimen Schlüssels finden Sie unter Generieren der Kunden-ID, der Client-ID und des geheimen Schlüssels. Weitere Informationen zum Einfügen dieser Informationen in die Datei CustomerInfo.yml finden Sie unter Auffüllen der Kundeninformationsdatei.
• Die Datei ZoneMapping.yml muss Informationen zur Zuordnung der On-Premises-Zone zu den Ressourcenstandorten in der Cloud enthalten. Weitere Informationen über die Zuordnung von Zonen finden Sie unter Auffüllen der Zonenzuordnungsdatei.
• Wenn Sie Hostverbindungen haben, müssen Sie die entsprechenden Informationen in CvadAcSecurity.yml eingeben.

1. Installieren Sie die automatische Konfiguration.
2. Doppelklicken Sie auf das Symbol Automatisches Konfigurieren. Ein PowerShell Fenster wird angezeigt.

3. Führen Sie den folgenden Befehl aus, um alle Komponenten zu exportieren.

   Export-CvadAcToFile

Nach der ersten Ausführung eines Cmdlets wird ein Exportordner mit den YML-Konfigurationsdateien und Protokollen erstellt. Der Ordner ist in %HOMEPATH%\Documents\Citrix\AutoConfig. Jeder nachfolgende Export erstellt einen Unterordner. Der übergeordnete Ordner %HOMEPATH%\Documents\Citrix\AutoConfig enthält immer die Dateien aus dem zuletzt ausgeführten Export.

Hinweis:

Wenn die automatische Konfiguration nicht auf dem Delivery Controller installiert ist, führen Sie import-module Citrix.AutoConfig.Commands aus, bevor Sie das Tool über PowerShell verwenden. Dies ist nicht erforderlich, wenn Sie die automatische Konfiguration über das Auto-Konfig-Symbol öffnen.

Bei Auftreten von Fehlern oder Ausnahmen konsultieren Sie den Abschnitt Fixups in der Protokolldatei.

Importieren der Konfiguration in Citrix Virtual Apps and Desktops Service

Wichtig:

• Sie müssen eine CustomerInfo.yml-Datei mit Ihrer Kunden-ID, Client-ID und dem geheimen Schlüssel haben. Informationen zum Abrufen der Kunden- und Client-ID und des geheimen Schlüssels finden Sie unter Generieren der Kunden-ID, der Client-ID und des geheimen Schlüssels. Weitere Informationen zum Einfügen dieser Informationen in die Datei CustomerInfo.yml finden Sie unter Auffüllen der Kundeninformationsdatei.
• Die Datei ZoneMapping.yml muss Informationen zur Zuordnung der On-Premises-Zone zu den Ressourcenstandorten in der Cloud enthalten. Weitere Informationen über die Zuordnung von Zonen finden Sie unter Auffüllen der Zonenzuordnungsdatei.
• Wenn Sie Hostverbindungen haben, müssen Sie die entsprechenden Informationen in CvadAcSecurity.yml eingeben.

Ausführen eines Imports

1. Doppelklicken Sie auf das Symbol Automatisches Konfigurieren. Ein PowerShell Fenster wird angezeigt.

2. Führen Sie den folgenden Befehl aus, um alle Komponenten zu importieren.

   Merge-CvadAcToSite

Überprüfen Sie den erwarteten Zustand gegen den neuen aktuellen Zustand. Importoptionen steuern, ob die Importergebnisse mit der On-Premises-Site identisch oder eine Teilmenge davon sind. Informationen zu den Optionen und deren Resultat finden Sie unter Abgeleitete Zustände nach Befehl.

Nach der Ausführung eines Cmdlets wird ein Exportordner mit den YML-Konfigurationsdateien und Protokollen erstellt. Der Ordner ist in %HOMEPATH%\Documents\Citrix\AutoConfig.

Bei Auftreten von Fehlern oder Ausnahmen konsultieren Sie den Abschnitt Fixups in der Protokolldatei.

Hinweis:

Wenn die automatische Konfiguration nicht auf dem Delivery Controller installiert ist, führen Sie import-module Citrix.AutoConfig.Commands aus, bevor Sie das Tool über PowerShell verwenden. Dies ist nicht erforderlich, wenn Sie die automatische Konfiguration über das Auto-Konfig-Symbol öffnen.

Informationen zum Wiederherstellen der ursprünglichen Citrix Virtual Apps and Desktops-Service-Konfiguration finden Sie unter Sichern der Citrix Virtual Apps and Desktops Service-Konfiguration.

Importvorgang im Einzelnen

Beim Import werden Updates präzise durchgeführt, es werden nur die erforderlichen Updates durchgeführt und es wird überprüft, ob alle Updates korrekt durchgeführt wurden. Bei allen Importvorgängen werden folgende Schritte ausgeführt.

1. Lesen der exportierten YML-Datei (erwarteter Zustand).
2. Lesen der Cloud (aktueller Zustand).
3. Backup des Cloudzustands vor Import in YML-Dateien (das Backup kann bei Bedarf wiederhergestellt werden).
4. Bewerten der Unterschiede zwischen erwartetem und aktuellem Zustand. Dies bestimmt, welche Aktualisierungen erforderlich sind.
5. Ausführen der Aktualisierungen.
6. Erneutes Lesen der Cloud (neuer aktueller Zustand).
7. Backup des Cloudzustands nach Import in YML-Dateien (das Backup kann bei Bedarf wiederhergestellt werden).
8. Vergleich des erwarteten Zustands und des neuen aktuellen Zustands.
9. Meldung der Vergleichsergebnisse.

Aktivieren der Sites

Hinweis:

Dieses Feature ist nur für Version 2.0 und höher verfügbar. Zur Überprüfung der Version verwenden Sie Get-CvadAcStatus in der automatischen Konfiguration.

Der Delivery Controller steuert in On-Premises- und Cloudsites Ressourcen wie das Brokering von Desktops und Anwendungen und den Neustart von Maschinen. Probleme treten auf, wenn Ressourcen von zwei oder mehr Sites gesteuert werden. Eine solche Situation kann bei der Migration von einer On-Premises-Site zu einer Cloudsite auftreten. On-Premises- und Cloud-Delivery Controller können die gleichen Ressourcen verwalten. Eine solche duale Verwaltung kann dazu führen, dass Ressourcen nicht mehr verfügbar sind oder nicht mehr verwaltet werden können und dass eine Diagnose schwierig wird.

Durch die Siteaktivierung können Sie vorgeben, wo die aktive Site gesteuert wird.

Die Siteaktivierung wird über den Bereitstellungsgruppen-Wartungsmodus verwaltet. Bereitstellungsgruppen werden in den Wartungsmodus versetzt, wenn die Site inaktiv ist. Der Wartungsmodus wird Bereitstellungsgruppen in aktiven Sites beendet.

• Set-CvadAdSiteActiveStateCloud
• Set-CvadAdSiteActiveStateOnPrem

Alle Cmdlets unterstützen die Filter IncludeByName und ExcludeByName.

Importieren und Übertragen der Steuerung in die Cloud

Im Folgenden finden Sie eine allgemeine Beschreibung des Verfahrens zum Importieren und Übertragen der Steuerung von der On-Premises-Site in die Cloudsite.

1. Exportieren und importieren Sie die On-Premises-Site in die Cloud. Stellen Sie sicher, dass der Parameter –SiteActive in keinem der Cmdlets zum Importieren verwendet wird. Die On-Premises-Site ist aktiv und die Cloudsite inaktiv. Standardmäßig befinden sich Cloudsite-Bereitstellungsgruppen im Wartungsmodus.
2. Überprüfen Sie den Inhalt und die Konfiguration der Cloud.
3. Legen Sie die On-Premises-Site außerhalb der Geschäftszeiten auf inaktiv fest. Der Parameter –SiteActive darf nicht vorhanden sein. Alle Bereitstellungsgruppen der On-Premises-Site sind im Wartungsmodus.
   • Set-CvadAcSiteActiveStateOnPrem
4. Legen Sie die Cloudsite auf aktiv fest. Der Parameter –SiteActive muss vorhanden sein. Keine Cloudsite-Bereitstellungsgruppe ist im Wartungsmodus.
   • Set-CvadAcSiteActiveStateCloud –SiteActive
5. Vergewissern Sie sich, dass die Cloudsite aktiv und die On-Premises-Site inaktiv ist.

Rückübertragen der Steuerung in die On-Premises-Site

Zum Rückübertragen der Steuerung von der Cloudsite in die On-Premises-Site gehen Sie folgendermaßen vor:

1. Legen Sie die Cloudsite außerhalb der Geschäftszeiten auf inaktiv fest. Alle Cloudsite-Bereitstellungsgruppe sind im Wartungsmodus.
   • Set-CvadAcSiteActiveStateCloud
2. Legen Sie die On-Premises-Site auf aktiv fest. Keine Bereitstellungsgruppe der On-Premises-Site ist im Wartungsmodus.
   • Set-CvadAcSiteActiveStateOnPrem -SiteActive

Migration von Cloud zu Cloud

Mit der automatischen Konfiguration können Sie das Verschieben Ihrer Cloud-Konfiguration auf eine andere Cloud-Site automatisieren und Ihre Cloud-Site wiederherstellen.

Das Verschieben der Citrix Virtual Apps and Desktops Service-Konfiguration kann für verschiedene Zwecke nützlich sein:

• Migration von Region zu Region
• Synchronisieren der Site von der Testumgebung in die Produktion
• Ressourcenlimits werden erreicht

Sichern der Citrix Virtual Apps and Desktops Service-Konfiguration

Hinweis:

Führen Sie zunächst die Schritte zum Importieren in Voraussetzungen für die Migration Ihrer Konfiguration aus, um die Konfiguration von einer Cloud in eine andere zu migrieren.

Wichtig:

• Sie müssen eine CustomerInfo.yml-Datei mit Ihrer Kunden-ID, Client-ID und dem geheimen Schlüssel haben. Informationen zum Abrufen der Kunden- und Client-ID und des geheimen Schlüssels finden Sie unter Generieren der Kunden-ID, der Client-ID und des geheimen Schlüssels. Weitere Informationen zum Einfügen dieser Informationen in die Datei CustomerInfo.yml finden Sie unter Auffüllen der Kundeninformationsdatei.
• Die Datei ZoneMapping.yml muss Informationen zur Zuordnung der Ressourcenstandorte in der Cloud enthalten. Weitere Informationen über die Zuordnung von Zonen finden Sie unter Auffüllen der Zonenzuordnungsdatei.
• Wenn Sie Hostverbindungen haben, müssen Sie die entsprechenden Informationen in CvadAcSecurity.yml eingeben.

1. Installieren Sie die automatische Konfiguration.

   Hinweis:

   Bei der Cloud-zu-Cloud-Migration kann die automatische Konfiguration auf einer Maschine mit Zugriff auf das Internet installiert werden, auf die der Administrator direkten Zugriff hat.

2. Doppelklicken Sie auf das Symbol Automatisches Konfigurieren. Ein PowerShell Fenster wird angezeigt.

3. Führen Sie den folgenden Befehl aus, um ein Backup durchzuführen.

   Backup-CvadAcToFile

Nach der ersten Ausführung eines Cmdlets wird ein Exportordner mit den YML-Konfigurationsdateien und Protokollen erstellt. Der Ordner ist in %HOMEPATH%\Documents\Citrix\AutoConfig.

Bei Auftreten von Fehlern oder Ausnahmen konsultieren Sie den Abschnitt Fixups in der Protokolldatei.

Wiederherstellen einer Konfiguration in Citrix Virtual Apps and Desktops Service

Hinweis:

Die Schritte im vorliegenden Abschnitt folgen denen unter Sichern der Citrix Virtual Apps and Desktops Service-Konfiguration. Führen Sie diese Schritte aus, bevor Sie mit der Wiederherstellung beginnen.

Ausführen einer Wiederherstellung

1. Doppelklicken Sie auf das Symbol Automatisches Konfigurieren. Ein PowerShell Fenster wird angezeigt.

2. Führen Sie den folgenden Befehl aus, um eine Wiederherstellung durchzuführen.

   Restore-CvadAcToSite -RestoreFolder <folder path of the backup files>

Überprüfen Sie den erwarteten Zustand gegen den neuen aktuellen Zustand.

Nach der Ausführung eines Cmdlets wird ein Exportordner mit den YML-Konfigurationsdateien und Protokollen erstellt. Der Ordner ist in %HOMEPATH%\Documents\Citrix\AutoConfig.

Bei Auftreten von Fehlern oder Ausnahmen konsultieren Sie den Abschnitt Fixups in der Protokolldatei.

Aktivieren der Sites

Durch die Siteaktivierung können Sie vorgeben, wo die aktive Site gesteuert wird. Weitere Informationen zum Aktivieren von Sites finden Sie unter Aktivieren der Sites.

Backup und Wiederherstellung

Der Backup- und Wiederherstellungsprozess schützt vor unbeabsichtigten Änderungen oder Beschädigungen an der Cloud-Sitekonfiguration. Während der Backuperstellung durch die automatische Konfiguration spiegelt das Backup jeweils den Status der Konfiguration der Cloud-Site vor den Änderungen wider. Der Schutz erfordert das regelmäßige Backup der Cloud-Sitekonfiguration und das Speichern der Backups an einem sicheren Ort. Bei Auftreten einer unerwünschten Änderung oder Beschädigung, kann mit dem Backup die Änderung oder Beschädigung auf granularer Ebene oder für die vollständige Konfiguration rückgängig gemacht werden.

Backup

Führen Sie für ein Backup das Cmdlet Backup-CvadAcToFile aus.

Für Backups können zwar einzelne Komponenten ausgewählt werden, Citrix empfiehlt jedoch, alle Komponenten zu sichern. Backups werden in einem eindeutig benannten Ordner unter dem Stammordner abgelegt: %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss

Wiederherstellen

Die Wiederherstellung kann aus einem beliebigen Backup durchgeführt werden und es können Komponentenelemente, Komponenten oder die vollständige Cloud-Sitekonfiguration wiederhergestellt werden.

Wiederherstellen von Komponentenelementen

Beim Wiederherstellen eines oder mehrerer Komponentenelemente wird das Feature IncludeByName verwendet. Das Cmdlet Restore wird mit dem Parameter RestoreFolder, der ausgewählten Einzelkomponente und der Aufnahmeliste verwendet.

Gehen Sie beispielsweise folgendermaßen vor, um zwei Gruppenrichtlinien aus einem Backup wiederherzustellen:

Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss

-GroupPolicies $true -IncludeByName Policy1,Policy2

Wiederherstellen kompletter Komponenten

Beim Wiederherstellen einer Komponente muss mindestens ein Komponentenparameter ausgewählt werden.

Folgen Sie zum Wiederherstellen der gesamten Bereitstellungsgruppen- und Maschinenkatalogkomponenten folgendem Beispiel:

Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss

-DeliveryGroups $true -MachineCatalogs $true

Wiederherstellen der gesamten Cloud-Sitekonfiguration

Zur Wiederherstellung der vollständigen Konfiguration der Cloud-Site werden alle Komponenten ausgewählt.

Folgen Sie zum Wiederherstellen der gesamten Cloudsite-Konfiguration folgendem Beispiel:

Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss

Zusammenführen mehrerer Sites

Hinweis:

Dieses Feature ist nur für Version 2.0 und höher verfügbar. Zur Überprüfung der Version verwenden Sie Get-CvadAcStatus in der automatischen Konfiguration.

Die Multisite-Unterstützung bietet eine Methode zum Zusammenführen mehrerer On-Premises-Sites in eine Cloudsite.

Dabei werden den Komponentennamen jeder On-Premises-Site eindeutige Präfixe und Suffixe hinzugefügt, sodass nach der Zusammenführung für Namenseindeutigkeit gesorgt ist.

Präfixe und Suffixe können für jede der folgenden Komponenten pro On-Premises-Site zugewiesen werden.

• AdminScope
• AdminRole
• ApplicationAdmin
• ApplicationFolder
• ApplicationGroup
• ApplicationUser
• DeliveryGroup
• GroupPolicy
• HostConnection
• MachineCatalog
• StoreFront
• Tag

Anwendungsordner unterstützen Präfixe, Suffixe und die Modifizierung des Stammordners. Bei der Modifizierung des Stammordners erhält die bestehende Ordnerstruktur einer Anwendung einen zusätzlichen Ordner auf oberster Ebene.

Regeln für Präfixe und Suffixe

1. Präfixe und Suffixe dürfen keines der folgenden Sonderzeichen enthalten: \ , / ; : # . * ? = < > | ( ) " ' { } [ ]
2. Präfixe und Suffixe dürfen Leerzeichen am Ende enthalten, nicht aber am Anfang.
3. Präfixe und Suffixe mit Leerzeichen am Ende müssen in Anführungszeichen gestellt werden.
4. Präfixe und Suffixe werden beim Import, der Zusammenführung und beim Hinzufügen angewendet. Die Quell-YML-Dateien werden niemals geändert.
5. Bei dem Prozess werden nach Bedarf die Namen abhängiger Komponentennamen automatisch mit Präfixen oder Suffixen versehen. Wird beispielsweise Maschinenkatalognamen das Präfix “Ost” vorangestellt, erhalten Bereitstellungsgruppen, die auf sie verweisen, ebenfalls das Präfix “Ost”.
6. Wenn ein Komponentenname bereits mit dem Präfix oder Suffix beginnt, wird kein Präfix oder Suffix hinzugefügt. Komponentennamen dürfen keine zwei identischen Präfixe bzw. Suffixe enthalten.
7. Präfixe und Suffixe können einzeln oder in Kombination verwendet werden.
8. Die Verwendung eines Präfixes oder Suffixes für eine Komponente ist optional.

Hinweis:

Die Oberfläche der vollständigen Konfiguration zeigt Komponenten in alphabetischer Reihenfolge an.

Gruppieren nach Site

Verwenden Sie Präfixe, um Komponenten einer Site visuell zu gruppieren. Jede Site wird als Gruppe aufgeführt, wobei die Reihenfolge der Sitegruppen alphabetisch nach Präfix gesteuert wird.

Gruppieren nach Namen

Verwenden Sie Suffixe, um ähnlich benannte Komponenten aus mehreren Sites visuell zu gruppieren. Ähnlich benannte Komponenten verschiedener Sites werden abwechselnd angezeigt.

SitePrefixes.yml-Datei

Die Datei SiteMerging.yml enthält die Präfix- und Suffix-Zuordnung für eine oder mehrere On-Premises-Sites. Sie können die Datei SiteMerging.yml manuell oder mithilfe der in Abschnitt Cmdlets zum Zusammenführen von Sites aufgeführten Cmdlets verwalten.

Exportieren, Importieren, Zusammenführen und Hinzufügen

Die Zusammenführung kann erst beginnen, wenn Sie eine On-Premises-Site exportiert haben. Informationen zum Exportieren einer On-Premises-Site finden Sie unter Migration von on-premises in die Cloud.

Zentraler Exportzielordner

Bei den in diesem Abschnitt beschriebenen Verfahren werden die Exporte mehrerer Sites in eine zentrale Dateifreigabe exportiert. Die Dateien SiteMerging.yml file und CustomerInfo.yml sowie alle Exportdateien befinden sich in der Dateifreigabe, sodass der Import aus diesem von den On-Premises-Sites unabhängigen Speicherort aus möglich ist.

Vorgänge, bei denen auf die Cloud zugegriffen wird, verweisen nie auf die On-Premises-Sites oder Active Directory, sodass Sie solche Vorgänge ortsunabhängig durchführen können.

Direkte Dateifreigabe

Die Operationen zum Exportieren, Importieren, Zusammenführen und Erstellen/Hinzufügen bieten einen Parameter zur Auswahl eines anderen Ordners als des Standardordners %HOMEPATH%\Documents\Citrix\AutoConfig als Ziel oder Quelle. In den folgenden Beispielen wird eine zentrale Dateifreigabe auf \\share.central.net verwendet, auf die der Administrator bereits Zugriff hat.

Zum Exportieren in einen sitespezifischen Ordner verwenden Sie den Parameter –TargetFolder:

Aus dem Desktop Delivery Controller “East”:

mkdir \\share.central.net\AutoConfig\SiteEast

Export-CvadAcToFile –TargetFolder \\share.central.net\AutoConfig\SiteEast

Aus dem Desktop Delivery Controller “West”:

mkdir \\share.central.net\AutoConfig\SiteWest

Export-CvadAcToFile –TargetFolder \\share.central.net\AutoConfig\SiteWest

Nach Abschluss des Exports erstellen Sie die Dateien CustomerInfo.yml und SiteMerging.yml und speichern sie in \\share.central.net\AutoConfig.

Hinweis:

Verwenden Sie bei dem Verfahren mit direktem Dateifreigabeverweis beim Erstellen von SitePrefixes.yml nicht den Parameter SiteRootFolder.

Zum Importieren, Zusammenzuführen oder Hinzufügen aus der direkten Dateifreigabe müssen Sie entscheiden, von welcher Maschine aus Sie den Cloudzugriffsvorgang durchführen möchten. Es gibt folgende Optionen:

• Eine On-Premises-Desktop Delivery Controller, auf dem das Tool installiert ist.
• Die Maschine, auf der die Dateifreigabe gehostet wird.
• Eine andere Maschine.

Die automatische Konfiguration muss auf der Maschine installiert sein, die auf die Cloud zugreift. Weder das On-Premises-PowerShell SDK, der Desktop Delivery Controller noch Active Directory werden verwendet, sodass die Anforderungen für den Zugriff auf die Cloud zur Ausführung einfacher sind als beim Export.

Zusammenführen des Desktop Delivery Controllers “East” in die Cloud:

Merge-CvadAcToSite –SiteName East –SourceFolder \\share.central.net\AutoConfig\SiteEast -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml

Zusammenführen des Desktop Delivery Controllers “West” in die Cloud:

Merge-CvadAcToSite –SiteName West –SourceFolder \\share.central.net\AutoConfig\SiteWest -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml

Nachfolgend sehen Sie das Muster der im vorherigen Beispiel verwendeten SitePrefixes.yml-Datei.

            HostConn1:
            ConnectionType: XenServer
            UserName: root
            PasswordKey: rootPassword
            HostCon2:
            ConnectionType: AWS
            ApiKey: 78AB6083-EF60-4D26-B2L5-BZ35X00DA5CH
            SecretKey: TwBLaaaaaaaaaaaaaaaaaw==
            Region: East

Dateifreigabeverweis mit SiteMerging.yml

Bei dieser Methode wird SiteRootFolder aus dem Site-Präfixsatz verwendet. Die Methode ist zwar etwas komplizierter als die mit direkter Dateifreigabe, doch ist das Risiko des Verweises auf den falschen Ordner beim Exportieren, Importieren, Zusammenführen oder Hinzufügen geringer.

Legen Sie zuerst den SiteRootFolder für jede Site in der SiteMerging.yml-Datei fest. Sie müssen hierzu den freigegebenen Speicherort verwenden.

Set-CvadAcSitePrefixes –SiteName East –SiteRootFolder \\share.central.net\AutoConfig\SiteEast -SitePrefixesFolder \\share.central.net\AutoConfig

Set-CvadAcSitePrefixes –SiteName West –SiteRootFolder SiteWest -SitePrefixesFolder \\share.central.net\AutoConfig

In diesem Beispiel ist “East” eine vollständig qualifizierte Ordnerangabe und “West” eine relative Ordnerangabe.

Um den Export unter Verwendung der Datei SiteMerging.yml an einen sitespezifischen Ordner zu verweisen geben Sie Folgendes ein:

Aus dem Desktop Delivery Controller “East”:

mkdir \\share.central.net\AutoConfig\SiteEast

Export-CvadAcToFile -SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml

Aus dem Desktop Delivery Controller “West”:

mkdir \\share.central.net\AutoConfig\SiteWest

Export-CvadAcToFile -SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml

Das Export-Cmdlet verwendet den Speicherort des Ordners CustomerInfo.yml, um die SiteMerging.yml-Datei zu finden. Im Fall von East ist der SiteRootFolder vollqualifiziert. Es wird unverändert verwendet. Im Fall von West ist der SiteRootFolder nicht vollqualifiziert. Er wird in Kombination mit dem Speicherort des Ordners CustomerInfo.yml zum Abrufen eines vollqualifizierten Ordnerspeicherorts für West verwendet.

Zusammenführen des Desktop Delivery Controllers “East” in die Cloud:

Merge-CvadAcToSite –SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml

Zusammenführen des Desktop Delivery Controllers “West” in die Cloud:

Merge-CvadAcToSite –SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml

Nachfolgend sehen Sie das Muster der im vorherigen Beispiel verwendeten SitePrefixes.yml-Datei.

            East:
              SiteRootFolder: "\\\\share.central.net\\AutoConfig\\SiteEast"
              AdminScopePrefix: "East_"
              AdminRolePrefix: "East_"
              ApplicationAdminPrefix: "East_"
              ApplicationFolderPrefix: "" # Note that a new parent root folder is used instead
              ApplicationFolderRoot: "East"
              ApplicationGroupPrefix: "East_"
              ApplicationUserPrefix: "East_"
              DeliveryGroupPrefix: "East_"
              GroupPolicyPrefix: "East_"
              HostConnectionPrefix: "East_"
              MachineCatalogPrefix: "East_"
              StoreFrontPrefix: "East_"
              TagPrefix: "East_"
              AdminScopeSuffix: "_east"
              AdminRoleSuffix: "_east"
              ApplicationAdminSuffix: "_east"
              ApplicationFolderSuffix: "_east"
              ApplicationGroupSuffix: "_east"
              ApplicationUserSuffix: "_east"
              DeliveryGroupSuffix: "_east"
              GroupPolicySuffix: "_east"
              HostConnectionSuffix: "_east"
              MachineCatalogSuffix: "_east"
              StoreFrontSuffix: "_east"
              TagSuffix: "_east"
            West:
              SiteRootFolder: "\\\\share.central.net\\AutoConfig\\SiteWest"
              AdminScopePrefix: "Western "
              AdminRolePrefix: "Western "
              ApplicationAdminPrefix: "Western "
              ApplicationFolderPrefix: "" # Note that a new parent root folder is used instead
              ApplicationFolderRoot: "Western"
              ApplicationGroupPrefix: "Western "
              ApplicationUserPrefix: "Western "
              DeliveryGroupPrefix: "Western "
              GroupPolicyPrefix: "Western "
              HostConnectionPrefix: "Western "
              MachineCatalogPrefix: "Western "
              StoreFrontPrefix: "Western "
              TagPrefix: "Western "
              AdminScopeSuffix: ""
              AdminRoleSuffix: ""
              ApplicationAdminSuffix: ""
              ApplicationFolderSuffix: ""
              ApplicationGroupSuffix: ""
              ApplicationUserSuffix: ""
              DeliveryGroupSuffix: ""
              GroupPolicySuffix: ""
              HostConnectionSuffix: ""
              MachineCatalogSuffix: ""
              StoreFrontSuffix: ""
              TagSuffix: ""

Wenn keine zentrale Dateifreigabe verwendet wird und der Import, die Zusammenführung oder das Hinzufügen von den einzelnen Desktop Delivery Controllern aus durchgeführt wird, erstellen und replizieren Sie die Datei SiteMerging.yml auf jedem Desktop Delivery Controller, der in die Cloud migriert wird. Der Standardpfad ist %HOMEPATH%\Documents\Citrix\AutoConfig. Zur Wahl der richtigen Sitepräfixe müssen Sie den Parameter –SiteName angeben.

Zusammenführen der Sites

Citrix empfiehlt, die Cloudvorgänge schrittweise durchzuführen und vor jedem nächsten Schritt eine vollständige Überprüfung durchzuführen. Wenn Sie beispielsweise drei Sites zu einer einzelnen Cloudsite zusammenführen, gehen Sie wie folgt vor:

1. Führen Sie die erste Site unter Verwendung des zugehörigen SiteName-Werts mit der Cloud zusammen.
2. Überprüfen Sie das Ergebnis in Studio (On-Premises oder Web)
3. Ist das Ergebnis nicht wie erwartet, suchen Sie die Ursache des Fehlers, korrigieren Sie sie und führen Sie die Zusammenführung erneut durch. Entfernen Sie bei Bedarf Cloudkomponenten mit Remove-CvadAcFromSite und beginnen Sie von Grund auf neu. Wenn das Ergebnis erwartungsgemäß ausfällt, fahren Sie fort.
4. Wenn die Zusammenführung der ersten Site fehlerfrei erfolgt ist, führen Sie die zweite Site mit der Cloudsite zusammen.
5. Wiederholen Sie die Schritte 2 und 3.
6. Wenn die Zusammenführung der zweiten Site fehlerfrei erfolgt ist, führen Sie die dritte Site mit der Cloudsite zusammen.
7. Wiederholen Sie die Schritte 2 und 3.
8. Überprüfen Sie die Ressourcen aus der Perspektive der Benutzer und vergewissern Sie sich, dass die Anzeige den Soll-Zustand aufweist.

Entfernen einer Komponente unter Verwendung des Sitepräfixes

Sie können Komponenten einzelner Sites unter Verwendung des Präfixes im Parameter –IncludeByName des Cmdlets Remove-CvadAcFromSite selektiv entfernen. Das folgende Beispiel geht von einem Fehler bei den Bereitstellungsgruppen des Desktop Delivery Controllers “West” aus. Um die Bereitstellungsgruppen gezielt für die West-Site zu entfernen gehen Sie folgendermaßen vor:

Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”

Um alle West-Komponenten zu entfernen, führen Sie die folgenden Cmdlets in der angegebenen Reihenfolge aus.

Remove-CvadAcFromSite –GroupPolicies –IncludeByName “Western *”

Remove-CvadAcFromSite –Applications –IncludeByName “Western *”

Remove-CvadAcFromSite – ApplicationGroups –IncludeByName “Western *”

Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”

Remove-CvadAcFromSite –MachineCatalogs –IncludeByName “Western *”

Remove-CvadAcFromSite –HostConnections –IncludeByName “Western *”

Remove-CvadAcFromSite –Tags –IncludeByName “Western *”

Um Gruppenrichtlinien der East-Komponenten zu entfernen, verwenden Sie das Suffix:

Remove-CvadAcFromSite –GroupPolicies –IncludeByName “*_east”

Cmdlets der automatischen Konfiguration

• Cmdlets der Siteverwaltung

• Cmdlets für die Datei mit Kundeninformationen

• Cmdlets für Support und Problembehandlung

• Cmdlets zur Siteaktivierung

• Cmdlets zum Zusammenführen von Sites

• Parameter zur Auswahl von Komponenten

• Filtern nach Objektnamen

• Migrationsparameter

• Parameter mit Cloudzugriff

• Parameter zur Protokollanzeige

• Abgeleitete Zustände nach Befehl

• Cmdlet-Rückgabewerte

• Hilfe

Cmdlets der Siteverwaltung

• Export-CvadAcToFile

  Exportiert die Konfiguration aus Ihrem On-Premises-Setup. Dabei handelt es sich um den standardmäßigen Export mit der automatischen Konfiguration. Es werden keine Änderungen an der On-Premises-Sitekonfiguration vorgenommen. Die exportierten Dateien werden im Verzeichnis %HOMEPATH%\Documents\Citrix\AutoConfig in einem eindeutig Export benannten Unterordner abgelegt. Der Ordner %HOMEPATH%\Documents\Citrix\AutoConfig enthält immer die neueste exportierte On-Premises-Sitekonfiguration.

  Parameter:

  • Siehe Parameter zur Auswahl von Komponenten
  • Siehe Filtern nach Objektnamen
  • TargetFolder gibt den Exportzielordner an.
  • Locale gibt die Sprache des menschenlesbaren Texts an, der exportiert werden kann.
  • Quiet unterdrückt die Protokollierung an die Konsole (nur verfügbar ab Version 2.0).
  • AdminAddress gibt das DNS oder die IP-Adresse des Delivery Controllers an, wenn der Export nicht auf dem Delivery Controller ausgeführt wird.
  • CheckUserAndMachines überprüft, ob Benutzer und Maschinen in Active Directory sind. Nicht in Active Directory enthaltene Benutzer und Maschinen können zu Importfehlern führen.

  Gibt zurück:

  • Siehe Cmdlet-Rückgabewerte

• Import-CvadAcToSite

  Importiert alle On-Premises-Dateien in die Cloud. Der Befehl stellt sicher, dass der Endstatus in der Cloud dem On-Premises-Status entspricht. Mit dieser Option werden alle Änderungen in der Cloud gelöscht. Importierte Sitekonfigurationsdateien stammen aus %HOMEPATH%\Documents\Citrix\AutoConfig. Mit Vorsicht verwenden!

  Parameter:

  • Siehe Parameter zur Auswahl von Komponenten
  • Siehe Filtern nach Objektnamen
  • Siehe Parameter mit Cloudzugriff
  • SourceFolder identifiziert einen Ersatzstammordner für %HOMEPATH%\Documents\Citrix\AutoConfig.
  • Locale gibt die Sprache des menschenlesbaren Texts an, der exportiert werden kann.
  • Quiet unterdrückt die Protokollierung an die Konsole (nur verfügbar ab Version 2.0).
  • DisplayLog zeigt die Protokolldatei nach Abschluss des Cmdlets an. Legen Sie den Parameter auf $false fest, um die Protokollanzeige zu unterdrücken.
  • Merge fügt bei Einstellung auf $true der Cloudsite nur Komponenten hinzu. Es werden keine Komponenten entfernt. Legen Sie $false fest, um Komponenten zu entfernen.
  • AddOnly fügt bei Einstellung auf $true nur neue Komponenten hinzu, vorhandene Komponenten werden nicht aktualisiert oder gelöscht. Legen Sie $false fest, um Aktualisierungen und Löschungen zuzulassen. Merge wird ignoriert, wenn dieser Parameter auf $true festgelegt ist.

  Gibt zurück:

  • Siehe Cmdlet-Rückgabewerte

• Merge-CvadAcToSite

  Führt die On-Premises-Dateien in die Cloud zusammen, löscht jedoch keine Komponenten in der Cloud. Dadurch bleiben in der Cloud bereits vorgenommene Änderungen erhalten. Gibt es in Citrix Cloud eine Komponente mit demselben Namen, kann sie durch den Befehl geändert werden. Dabei handelt es sich um den standardmäßigen Import mit der automatischen Konfiguration. Zusammengeführte Sitekonfigurationsdateien stammen aus %HOMEPATH%\Documents\Citrix\AutoConfig.

  Parameter:

  • Siehe Parameter zur Auswahl von Komponenten
  • Siehe Filtern nach Objektnamen
  • Siehe Parameter mit Cloudzugriff
  • SourceFolder identifiziert einen Ersatzstammordner für %HOMEPATH%\Documents\Citrix\AutoConfig.
  • Locale gibt die Sprache des menschenlesbaren Texts an, der exportiert werden kann.
  • Quiet unterdrückt die Protokollierung an die Konsole (nur verfügbar ab Version 2.0).
  • DisplayLog zeigt die Protokolldatei nach Abschluss des Cmdlets an. Legen Sie den Parameter auf $false fest, um die Protokollanzeige zu unterdrücken.
  • AddOnly fügt bei Einstellung auf $true nur neue Komponenten hinzu, vorhandene Komponenten werden nicht aktualisiert oder gelöscht. Legen Sie $false fest, um Aktualisierungen und Löschungen zuzulassen. Merge wird ignoriert, wenn dieser Parameter auf $true festgelegt ist.

  Gibt zurück:

  • Siehe Cmdlet-Rückgabewerte

• Restore-CvadAcToSite

  Stellt die Cloudsite wieder auf die vorherige Konfiguration zurück. Importierte Dateien werden aus dem im Parameter -RestoreFolder angegebenen Ordner bezogen. Dies kann zum Zurücksetzen auf die vorherige Konfiguration oder für ein Backup und Wiederherstellen der Cloudsite verwendet werden.

  Parameter:

  • Siehe Parameter zur Auswahl von Komponenten
  • Siehe Filtern nach Objektnamen
  • Siehe Parameter mit Cloudzugriff
  • RestoreFolder identifiziert den Ordner mit den YML-Dateien zur Wiederherstellung in die Cloudsite. Es muss sich um eine vollständig qualifizierte Ordnerangabe handeln.
  • Locale gibt die Sprache des menschenlesbaren Texts an, der exportiert werden kann.
  • Quiet unterdrückt die Protokollierung an die Konsole (nur verfügbar ab Version 2.0).
  • DisplayLog zeigt die Protokolldatei nach Abschluss des Cmdlets an. Legen Sie den Parameter auf $false fest, um die Protokollanzeige zu unterdrücken.
  • Merge fügt bei Einstellung auf $true der Cloudsite nur Komponenten hinzu. Es werden keine Komponenten entfernt. Legen Sie $false fest, um Komponenten zu entfernen.
  • AddOnly fügt bei Einstellung auf $true nur neue Komponenten hinzu, vorhandene Komponenten werden nicht aktualisiert oder gelöscht. Legen Sie $false fest, um Aktualisierungen und Löschungen zuzulassen. Merge wird ignoriert, wenn dieser Parameter auf $true festgelegt ist.

  Gibt zurück:

  • Siehe Cmdlet-Rückgabewerte

• New-CvadAcToSite

  Importiert die On-Premises-Konfiguration in die Cloud, wobei nur neue Komponenten hinzugefügt werden. Vorhandene Cloud-Sitekomponenten werden weder aktualisiert noch gelöscht. Verwenden Sie diesen Befehl, wenn die vorhandenen Cloud-Sitekomponenten unverändert bleiben müssen.

  Parameter:

  • Siehe Parameter zur Auswahl von Komponenten
  • Siehe Filtern nach Objektnamen
  • Siehe Parameter mit Cloudzugriff
  • SourceFolder identifiziert einen Ersatzstammordner für %HOMEPATH%\Documents\Citrix\AutoConfig.
  • Locale gibt die Sprache des menschenlesbaren Texts an, der exportiert werden kann.
  • Quiet unterdrückt die Protokollierung an die Konsole (nur verfügbar ab Version 2.0).
  • DisplayLog zeigt die Protokolldatei nach Abschluss des Cmdlets an. Legen Sie den Parameter auf $false fest, um die Protokollanzeige zu unterdrücken.

  Gibt zurück:

  • Siehe Cmdlet-Rückgabewerte

• Sync-CvadAcToSite

  Die Synchronisierung führt Export und Import in einem Schritt durch.

  Parameter:

  • Siehe Parameter zur Auswahl von Komponenten
  • Siehe Filtern nach Objektnamen
  • Siehe Parameter mit Cloudzugriff
  • SourceTargetFolder gibt den Export-/Importzielordner an.
  • Locale gibt die Sprache des menschenlesbaren Texts an, der exportiert werden kann.
  • AdminAddress gibt das DNS oder die IP-Adresse des Delivery Controllers an, wenn der Export nicht auf dem Delivery Controller ausgeführt wird.
  • Quiet unterdrückt die Protokollierung an die Konsole (nur verfügbar ab Version 2.0).
  • DisplayLog zeigt die Protokolldatei nach Abschluss des Cmdlets an. Legen Sie den Parameter auf $false fest, um die Protokollanzeige zu unterdrücken.
  • Merge fügt bei Einstellung auf $true der Cloudsite nur Komponenten hinzu. Es werden keine Komponenten entfernt. Legen Sie $false fest, um Komponenten zu entfernen.
  • AddOnly fügt bei Einstellung auf $true nur neue Komponenten hinzu, vorhandene Komponenten werden nicht aktualisiert oder gelöscht. Legen Sie $false fest, um Aktualisierungen und Löschungen zuzulassen. Merge wird ignoriert, wenn dieser Parameter auf $true festgelegt ist.

  Gibt zurück:

  • Siehe Cmdlet-Rückgabewerte

• Backup-CvadAcToFile

  Exportiert die Cloudkonfiguration in YML-Dateien. Dieses Backup kann bei einem Backup- und Wiederherstellungsprozess zur Wiederherstellung verlorener Komponenten genutzt werden.

  Parameter:

  • Siehe Parameter zur Auswahl von Komponenten
  • Siehe Parameter mit Cloudzugriff
  • TargetFolder gibt den Exportzielordner an.
  • Locale gibt die Sprache des menschenlesbaren Texts an, der exportiert werden kann.
  • Quiet unterdrückt die Protokollierung an die Konsole (nur verfügbar ab Version 2.0).
  • DisplayLog zeigt die Protokolldatei nach Abschluss des Cmdlets an. Legen Sie den Parameter auf $false fest, um die Protokollanzeige zu unterdrücken.

  Gibt zurück:

  • Siehe Cmdlet-Rückgabewerte

• Compare-CvadAcToSite

  Vergleicht die lokalen YML-Dateien mit der Cloud-Konfiguration und erstellt einen Bericht über Änderungen, die von dem Cmdlet Import, Merge oder Restore ausgeführt wurden.

  Parameter:

  • Siehe Parameter zur Auswahl von Komponenten
  • Siehe Filtern nach Objektnamen
  • Siehe Parameter mit Cloudzugriff
  • SourceFolder identifiziert einen Ersatzstammordner für %HOMEPATH%\Documents\Citrix\AutoConfig.
  • Locale gibt die Sprache des menschenlesbaren Texts an, der exportiert werden kann.
  • Quiet unterdrückt die Protokollierung an die Konsole (nur verfügbar ab Version 2.0).
  • DisplayLog zeigt die Protokolldatei nach Abschluss des Cmdlets an. Legen Sie den Parameter auf $false fest, um die Protokollanzeige zu unterdrücken.
  • Merge fügt bei Einstellung auf $true der Cloudsite nur Komponenten hinzu. Es werden keine Komponenten entfernt. Legen Sie $false fest, um Komponenten zu entfernen.
  • AddOnly fügt bei Einstellung auf $true nur neue Komponenten hinzu, vorhandene Komponenten werden nicht aktualisiert oder gelöscht. Legen Sie $false fest, um Aktualisierungen und Löschungen zuzulassen. Merge wird ignoriert, wenn dieser Parameter auf $true festgelegt ist.

  Gibt zurück:

  • Siehe Cmdlet-Rückgabewerte

• Remove-CvadAcFromSite

  Kann die gesamte Site zurücksetzen oder Elemente aus einer Komponente entfernen (z. B. einen Maschinenkatalog aus der Liste der Kataloge). In Kombination mit dem Parameter IncludeByName können so Elemente selektiv entfernt werden.

  Parameter:

  • Siehe Parameter zur Auswahl von Komponenten
  • Siehe Filtern nach Objektnamen
  • Siehe Parameter mit Cloudzugriff
  • Quiet unterdrückt die Protokollierung an die Konsole (nur verfügbar ab Version 2.0).
  • DisplayLog zeigt die Protokolldatei nach Abschluss des Cmdlets an. Legen Sie den Parameter auf $false fest, um die Protokollanzeige zu unterdrücken.

  Gibt zurück:

  • Siehe Cmdlet-Rückgabewerte

Cmdlets für die Datei mit Kundeninformationen

• New-CvadAcCustomerInfoFile

  Erstellt eine Kundeninformationsdatei. Standardmäßig ist diese unter %HOMEPATH%\Documents\Citrix\AutoConfig.

  Parameter:

  • CustomerId: Kunden-ID (erforderlich).
  • ClientId: Client-ID des Kunden, die in Citrix Cloud erstellt wurde (erforderlich).
  • Secret: Geheimer Schlüssel des Kunden, der in Citrix Cloud erstellt wurde (erforderlich).
  • Environment: Production- oder ProductionGov-Umgebung.
  • LogFileName: Ändern des Protokolldateipräfixes “CitrixLog” in ein anderes Präfix.
  • StopOnError: Stoppt den Vorgang nach dem ersten Fehler.
  • AlternateRootFolder: Verwendet anstelle von %HOMEPATH%\Documents\Citrix\AutoConfig den angegebenen Ordner als Stammordner.
  • Locale: Verwendet das angegebene Gebietsschema anstelle des vom System, auf dem das Tool ausgeführt wird, abgeleiteten Gebietsschemas.
  • Editor: Verwendet den angegebenen Editor zum Anzeigen des Protokolls nach Abschluss jedes Cmdlets. Notepad.exe ist der Standardeditor. Der Parameter muss die vollständig qualifizierte Dateiangabe für den Editor enthalten und darf ansonsten keinen Einstellung enthalten.

  Gibt zurück:

  • Siehe Cmdlet-Rückgabewerte

  Beispiel:

  New-CvadAcCustomerInfoFile -CustomerId markhof123 -ClientId 6813EEA6-46CC-4F8A-BC71-539F2DAC5984 -Secret TwBLaaaaaaaaaaaaaaaaaw==

• Set-CvadAcCustomerInfoFile

  Aktualisiert eine bestehende Kundeninformationsdatei. Nur die im Cmdlet angegebenen Parameter werden geändert, alle nicht angegebenen Parameterwerte bleiben in der Datei CustomerInfo.yml unverändert.

  Parameter:

  • CustomerId: Kunden-ID (erforderlich).
  • ClientId: Client-ID des Kunden, die in Citrix Cloud erstellt wurde (erforderlich).
  • Secret: Geheimer Schlüssel des Kunden, der in Citrix Cloud erstellt wurde (erforderlich).
  • Environment: Production- oder ProductionGov-Umgebung.
  • LogFileName: Ändern des Protokolldateipräfixes “CitrixLog” in ein anderes Präfix.
  • StopOnError: Stoppt den Vorgang nach dem ersten Fehler.
  • AlternateRootFolder: Verwendet anstelle von %HOMEPATH%\Documents\Citrix\AutoConfig den angegebenen Ordner als Stammordner.
  • Locale: Verwendet das angegebene Gebietsschema anstelle des vom System, auf dem das Tool ausgeführt wird, abgeleiteten Gebietsschemas.
  • Editor: Verwendet den angegebenen Editor zum Anzeigen des Protokolls nach Abschluss jedes Cmdlets. Notepad.exe ist der Standardeditor. Der Parameter muss die vollständig qualifizierte Dateiangabe für den Editor enthalten und darf ansonsten keinen Einstellung enthalten.

  Gibt zurück:

  • Siehe Cmdlet-Rückgabewerte

Cmdlets für Support und Problembehandlung

• New-CvadAcTemplateToFile

  Erstellt eine Vorlagendatei für ausgewählte Komponenten zur manuellen Erstellung einer Importdatei.

  Parameter:

  • Siehe Parameter zur Auswahl von Komponenten
  • TargetFolder gibt den Exportzielordner an.

  Gibt zurück:

  • Siehe Cmdlet-Rückgabewerte

• Show-CvadAcDocument zeigt dieses Dokument im Standardbrowser an.

  Parameter:

  • Keine.

  Gibt zurück:

  • Zeigt diese Webseite im Standardbrowser an.

• Test-CvadAcConnectionWithSite

  Test der Verbindung mit der Cloudsite. Das Cmdlet verwendet die Cloudzugriffsparameter oder die Datei CustomerInfo.yml zum Angeben der Kundenverbindungsinformationen.

  Parameter:

  • Siehe Parameter mit Cloudzugriff
  • SiteId identifiziert die Site, die auf eine gültige Verbindung getestet werden soll.
  • Quiet unterdrückt die Protokollierung an die Konsole (nur verfügbar ab Version 2.0).

  Gibt zurück:

  • Die Testergebnisse werden auf der Befehlszeile angezeigt.

• Find-CvadAcConnector

  Sucht vorhandene Connectors und ermittelt deren Ausführungszustand. Das Cmdlet verwendet Informationen aus der Datei CustomerInfo.yml oder aus dem Kunden-ID-Parameter zur Suche der Connectors des Kunden.

  Parameter:

  • CustomerInfoFileSpec: Die Dateispezifikation, die auf eine Kundeninformationsdatei verweist, um den Standardspeicherort und den Standardnamen außer Kraft zu setzen. Dieser Parameter wird ignoriert, wenn der Parameter CustomerId angegeben wird.
  • CustomerId: Kunden-ID; dieser Parameter setzt den entsprechenden Wert in der Datei CustomerInfo.yml außer Kraft.

  Gibt zurück:

  • Die Ergebnisse werden auf der Befehlszeile angezeigt.

• New-CvadAcZipInfoForSupport

  Hinweis:

  Das Cmdlet New-CvadAcZipInfoForSupport ist nur für Version 2.0 und höher verfügbar. Zur Überprüfung der Version verwenden Sie Get-CvadAcStatus in der automatischen Konfiguration.

  Komprimiert alle Protokoll- und YML-Dateien in einer ZIP-Datei zur Übermittlung an Citrix für Supportmaßnahmen. Vertrauliche Kundendaten (CustomerInfo.yml und CvadAcSecurity.yml) sind nicht in der ZIP-Datei enthalten. Die Datei Icon.yml ist aufgrund ihrer Größe ebenfalls ausgeschlossen. Die ZIP-Datei wird in %HOMEPATH%\Documents\Citrix\AutoConfig gespeichert und erhält den Namen CvadAcSupport_yyyy_mm_dd_hh_mm_ss.zip (mit Datums- und Zeitstempel). Diese ZIP-Datei kann auch als Backup dienen.

  Parameter:

  • AlternateFolder gibt einen alternativen Ordner zum Speichern der ZIP-Datei an.
  • Quiet unterdrückt die Protokollierung an die Konsole (nur verfügbar ab Version 2.0).

  Gibt zurück:

  • Die ZIP-Datei mit Namen und Pfad wird in der Eingabeaufforderung angezeigt.

• Get-CvadAcCustomerSites

  Gibt die Liste aller Kundensites zurück. Das Cmdlet verwendet die Cloudzugriffsparameter oder die Datei CustomerInfo.yml zum Angeben der Kundenverbindungsinformationen.

  Parameter:

  • Siehe Parameter mit Cloudzugriff

  Gibt zurück:

  • Zeigt die Liste der gefundenen Kundensite-IDs an.

• Get-CvadAcStatus

  Gibt Informationen über das Tool und die Umgebung zurück, in der es ausgeführt wird: Toolversion, ob der Benutzer Siteadministrator-Berechtigung für den Export hat, ob Kunden-ID, Client-ID und geheimer Schlüssel vorhanden sind, ob die Kommunikation mit der Site möglich ist, ob das verbesserte Provisioning Services-Feature vorhanden ist und ob ein oder mehrere Connectors vorhanden sind.

  Parameter:

  • Siehe Parameter mit Cloudzugriff
  • SiteId identifiziert die Site, mit der eine Verbindung hergestellt werden soll (optional).
  • AdminAddress ist das DNS oder IP-Adresse des On-Premises-Delivery Controllers, der zur Überprüfung der Administrator-Zugriffsebene verwendet wird. Dies ist erforderlich, wenn das Tool nicht auf einem Delivery Controller ausgeführt wird.

  Gibt zurück:

  • Zeigt die Ergebnisse für jedes Element an.

Cmdlets zur Siteaktivierung

Hinweis:

Dieses Feature ist nur für Version 2.0 und höher verfügbar. Zur Überprüfung der Version verwenden Sie Get-CvadAcStatus in der automatischen Konfiguration.

• Set-CvadAcSiteActiveStateOnPrem

  Legt den Status der On-Premises-Site auf aktiv oder inaktiv fest.

  Parameter:

  • Siehe Parameter mit Cloudzugriff
  • Ist SiteActive vorhanden, wird die On-Premises-Site auf aktiv festgelegt und der Wartungsmodus für alle Bereitstellungsgruppen beendet. Wenn dieser Parameter nicht vorhanden ist, wird der Wartungsmodus für alle Bereitstellungsgruppen aktiviert.
  • IncludeByName ist die Liste der Bereitstellungsgruppen, die eingeschlossen werden sollen, wenn die Site auf aktiv festgelegt wird. Die Platzhalter * und ? werden in Namen unterstützt.
  • ExcludeByName ist die Liste der Bereitstellungsgruppen, die ausgeschlossen werden sollen, wenn die Site auf aktiv festgelegt wird. Die Platzhalter * und ? werden in Namen unterstützt.
  • Quiet unterdrückt die Protokollierung an die Konsole
  • DisplayLog zeigt die Protokolldatei nach Abschluss des Cmdlets an. Legen Sie den Parameter auf $false fest, um die Protokollanzeige zu unterdrücken.

  Gibt zurück:

  • Siehe Cmdlet-Rückgabewerte

• Set-CvadAcSiteActiveStateCloud

  Legt den Status der Cloudsite auf aktiv oder inaktiv fest.

  Parameter:

  • Siehe Parameter mit Cloudzugriff
  • Ist SiteActive vorhanden, wird die On-Premises-Site auf aktiv festgelegt und der Wartungsmodus für alle Bereitstellungsgruppen beendet. Wenn dieser Parameter nicht vorhanden ist, wird der Wartungsmodus für alle Bereitstellungsgruppen aktiviert.
  • IncludeByName ist die Liste der Bereitstellungsgruppen, die eingeschlossen werden sollen, wenn die Site auf aktiv festgelegt wird. Die Platzhalter * und ? werden in Namen unterstützt.
  • ExcludeByName ist die Liste der Bereitstellungsgruppen, die ausgeschlossen werden sollen, wenn die Site auf aktiv festgelegt wird. Die Platzhalter * und ? werden in Namen unterstützt.
  • Quiet unterdrückt die Protokollierung an die Konsole
  • DisplayLog zeigt die Protokolldatei nach Abschluss des Cmdlets an. Legen Sie den Parameter auf $false fest, um die Protokollanzeige zu unterdrücken.

  Gibt zurück:

  • Siehe Cmdlet-Rückgabewerte

Cmdlets zum Zusammenführen von Sites

Hinweis:

Dieses Feature ist nur für Version 2.0 und höher verfügbar. Zur Überprüfung der Version verwenden Sie Get-CvadAcStatus in der automatischen Konfiguration.

Weitere Informationen zum Zusammenführen von Sites mithilfe dieser Cmdlets finden Sie unter Zusammenführen mehrerer Sites.

• New-CvadAcSiteMergingInfo erstellt ein Präfix-/Suffix-Infoset zum Zusammenführen von Websites. Zu Beginn müssen nicht alle Präfixe oder Suffixe bekannt sein. Sie können mithilfe von Set-CvadAcSiteMergingInfo oder durch manuelles Bearbeiten der Datei SiteMerging.yml aktualisiert werden.
• Set-CvadAcSiteMergingInfo aktualisiert das Präfix-/Suffix-Infoset zur Sitezusammenführung.
• Remove-CvadAcSiteMergingInfo entfernt das Präfix-/Suffix-Infoset zur Sitezusammenführung.

Parameter zur Sitezusammenführung

• SiteName identifiziert das Präfix-/Suffix-Infoset einer spezifischen Site. Eine Übereinstimmung mit dem Namen der Site ist möglich, aber nicht notwendig. SiteName ist ein erforderlicher Parameter. Hinweis: Dies ist der einzige unterstützte Parameter für Remove-CvadAcSiteMergingInfo.
• Quiet unterdrückt die Protokollierung an die Konsole (nur verfügbar ab Version 2.0).
• AdminScopedPrefix: das auf Administratorbereiche anzuwendende Präfix.
• ApplicationPrefix: das auf Anwendungen anzuwendende Präfix.
• ApplicationFolderPrefix: das auf Anwendungsordner anzuwendende Präfix. ApplicationFolderPrefix kann mit ApplicationFolderRoot kombiniert werden.
• ApplicationFolderRoot: der neue Stammordner für Anwendungsordner. Hierdurch wird eine zusätzliche Ordnerhierarchie erstellt. ApplicationFolderRoot kann mit ApplicationFolderPrefix kombiniert werden.
• ApplicationGroupPrefix: das auf Anwendungsgruppen anzuwendende Präfix.
• ApplicationUserPrefix: das auf Anwendungsnamen, die für Benutzer angezeigt werden, anzuwendende Präfix.
• ApplicationAdminPrefix: das auf Anwendungsnamen, die für Administratoren angezeigt werden, anzuwendende Präfix.
• DeliveryGroupPrefix: das auf Bereitstellungsgruppen anzuwendende Präfix.
• GroupPolicyPrefix: das auf Richtliniennamen anzuwendende Präfix.
• HostConnectionPrefix: das auf Hostverbindungen anzuwendende Präfix.
• MachineCatalogPrefix: das auf Maschinenkataloge anzuwendende Präfix.
• StoreFrontPrefix: das auf StoreFront-Namen anzuwendende Präfix.
• TagPrefix: das auf Tags anzuwendende Präfix.
• AdminScopedSuffix: das auf Administratorbereiche anzuwendende Suffix.
• ApplicationSuffix: das auf Anwendungen anzuwendende Suffix.
• ApplicationFolderSuffix: das auf Anwendungsordner anzuwendende Suffix. ApplicationFolderSuffix kann mit ApplicationFolderRoot kombiniert werden.
• ApplicationGroupSuffix: das auf Anwendungsgruppen anzuwendende Suffix.
• ApplicationUserSuffix: das auf Anwendungsnamen, die für Benutzer angezeigt werden, anzuwendende Suffix.
• ApplicationAdminSuffix: das auf Anwendungsnamen, die für Administratoren angezeigt werden, anzuwendende Suffix.
• DeliveryGroupSuffix: das auf Bereitstellungsgruppen anzuwendende Suffix.
• GroupPolicySuffix: das auf Richtliniennamen anzuwendende Suffix.
• HostConnectionSuffix: das auf Hostverbindungen anzuwendende Suffix.
• MachineCatalogSuffix: das auf Maschinenkataloge anzuwendende Suffix.
• StoreFrontSuffix: das auf StoreFront-Namen anzuwendende Suffix.
• TagSuffix: das auf Tags anzuwendende Suffix.
• SiteRootFolder: der vollqualifizierte Ordnername für Exporte und Importe (lokaler Ordner oder Dateifreigabe).

Parameter zur Auswahl von Komponenten

Die folgenden Komponenten können mit den entsprechenden Cmdlets angegeben werden. Für Toolversionen bis einschließlich 1.x muss jedem Parameter $true folgen. Ab Version 2.x geben Sie nur den Parameter an. Die Auswahl All bewirkt, dass die anderen Parameter ignoriert werden. Die Option All wird automatisch ausgewählt, wenn keine Komponentenparameter angegeben werden.

• All
• Tags
• AdminRolesScopes
• MachineCatalogs
• DeliveryGroups
• ApplicationGroups
• Applications
• GroupPolicies

Filtern nach Objektnamen

Nach Namen einschließen und ausschließen

Die Parameter IncludeByName und ExcludeByName und ermöglichen das Ein- und Ausschließen von Elementen in Cmdlets nach Namen. In den unterstützten Cmdlets kann jeweils nur eine Komponente (z. B. Bereitstellungsgruppen) ausgewählt werden. Wenn sich ein Komponentenelement in beiden Bereichen befindet, setzt das Ausschließen alle anderen Parameter außer Kraft und im Abschnitt “Fixups” der Protokolldatei werden die ausgeschlossene Komponente und das ausgeschlossene Element aufgeführt.

IncludeByName und ExcludeByName akzeptieren eine Liste mit Elementen. Die Name können einen oder mehrere Platzhalter enthalten. Zwei Arten von Platzhaltern werden unterstützt. Die Liste der Komponentenelemente muss in einfache Anführungszeichen gesetzt werden, wenn ein Elementname Sonderzeichen enthält.

• * entspricht einer beliebigen Anzahl von Zeichen
• ? Entspricht einem Zeichen

IncludeByName und ExcludeByName akzeptieren auch eine Datei mit einer Liste von Elementen, von denen jedes explizit oder mit Platzhaltern angegeben werden kann. Jedes Element muss auf einer eigenen Zeile stehen. Bei Elementnamen werden führende und nachgestellte Leerzeichen gelöscht. Dem Dateinamen muss das @-Zeichen in einfachen Anführungszeichen vorangestellt werden (eine PowerShell-Anforderung, damit das @-Zeichen nicht neu interpretiert wird). Zusätzlich zum Mischen mit Elementnamen können mehrere Dateien aufgelistet werden.

Beispiel zum Zusammenführen aller Bereitstellungsgruppen, deren Namen mit DgSite1 beginnen und Home2 enthalten:

Merge-CvadAcToSite –DeliveryGroups $true –IncludeByName DgSite1*,*Home2*

Nach Bereitstellungsgruppennamen

ByDeliveryGroupName filtert nach Bereitstellungsgruppennamen für Anwendungen und Anwendungsgruppen. Dieser Parameter ist immer eine Aufnahmeliste, deren Einträge basierend auf ihrer Bereitstellungsgruppenzuordnung berücksichtigt werden.

ByDeliveryGroupName erfasst eine Liste von Bereitstellungsgruppennamen. Die Name können einen oder mehrere Platzhalter enthalten. Zwei Arten von Platzhaltern werden unterstützt.

• * entspricht einer beliebigen Anzahl von Zeichen
• ? entspricht einem einzelnen Zeichen

Im folgenden Beispiel werden alle Anwendungen zusammengeführt, die auf alle Bereitstellungsgruppennamen verweisen, die mit EastDg beginnen.

Merge-CvadAcToSite –Applications –ByDeliveryGroupName EastDg*

Deaktivierte ausschließen

ExcludeDisabled schließt alle deaktivierten Anwendungen und Anwendungsgruppen vom Import aus. ExcludeDisabled ist standardmäßig auf false festgelegt, d. h. alle Anwendungen und Anwendungsgruppen werden unabhängig vom Aktivierungsstatus importiert.

Nach Maschinenname

Hinweis:

Dieses Feature ist nur für Version 2.0 und höher verfügbar. Zur Überprüfung der Version verwenden Sie Get-CvadAcStatus in der automatischen Konfiguration.

ByMachineName filtert nach dem Maschinennamen für Maschinenkataloge und Bereitstellungsgruppen. Dieser Parameter ist immer eine Aufnahmeliste, deren Einträge basierend auf ihrer Maschinennamenzuordnung berücksichtigt werden.

ByMachineName akzeptiert eine Liste von Maschinennamen, die einen oder mehrere Platzhalter enthalten können. Zwei Arten von Platzhaltern werden unterstützt.

• * entspricht einer beliebigen Anzahl von Zeichen
• ? entspricht einem einzelnen Zeichen

Wird beim Exportieren oder Importieren unter Verwendung von ByMachineName und eines Maschinennamenfilters keine Maschine im Maschinenkatalog oder in der Bereitstellungsgruppe gefunden, wird der Maschinenkatalog bzw. die Bereitstellungsgruppe vom Export oder Import ausgeschlossen.

Hinweis:

Bei Verwendung von ByMachineName in einem Import-Cmdlet wird AddMachinesOnly auf $true festgelegt.

Nur Maschinen hinzufügen

Wird AddMachinesOnly auf $true festgelegt, werden Maschinen dem Maschinenkatalog oder der Bereitstellungsgruppe nur hinzugefügt. Es werden keine Maschinen entfernt, sodass inkrementelle Hinzufügungen möglich sind.

AddMachineOnly ist standardmäßig “false”, d. h. Maschinen werden entfernt, wenn sie nicht in der YML-Datei des Maschinenkatalogs oder der Bereitstellungsgruppe sind. AddMachinesOnly wird bei Verwendung von ByMachineName auf $true festgelegt, kann aber durch Festlegen von AddMachinesOnly auf “false” außer Kraft gesetzt werden.

Migrationsparameter

Die Cmdlets zur Änderung der Cloudsitekonfiguration (Import, Restore, Merge, New und Sync) unterstützen folgende Parameter zur Erweiterung der Flexibilität.

• CheckMode: Führt den Importvorgang ohne Änderungen durch. Alle erwarteten Änderungen werden vor dem Import gemeldet. Sie können den Import vor dessen Ausführung mit diesen Befehl testen.
• BackupFirst: Sichert den Cloudinhalt in YML-Dateien, bevor die Cloudkonfiguration geändert wird. Diese Option ist standardmäßig aktiviert.
• Confirm: Bei Festlegen auf “true” wird eine Bestätigung zum Ändern der Konfiguration der Cloudsite angefordert. Das Cmdlet Remove zeigt aufgrund seiner destruktiven Wirkung eine Aufforderung an. Legen Sie es auf “false” fest, wenn keine Eingabeaufforderung gewünscht wird (z. B. bei Ausführung in einem Skript). Confirm ist standardmäßig auf “true” festgelegt.

Hinweis:

Die Cmdlets SecurityFileFolder, SiteName und SiteActive sind nur ab Version 2.0 verfügbar. Zur Überprüfung der Version verwenden Sie Get-CvadAcStatus in der automatischen Konfiguration.

• SecurityFileFolder ist der vollständig qualifizierte Name des Ordners mit der Datei CvadSecurity.yml, der auf einen lokalen Ordner oder eine Netzwerkfreigabe mit Authentifizierung verweisen kann. Das Tool fordert nicht zur Eingabe von Anmeldeinformationen auf. Der Zugriff auf Ressourcen mit Authentifizierung muss vor dem Ausführen des Tools bereitgestellt werden.
• SiteName gibt das Präfix und Suffix für die Sitezusammenführung beim Import an. Weitere Informationen finden Sie unter Zusammenführen mehrerer Sites.
• SiteActive gibt an, ob die importierte Site aktiv oder inaktiv ist. Standardmäßig ist dieser Parameter auf $false festgelegt und die importierte Site ist inaktiv.

Parameter mit Cloudzugriff

Alle Cmdlets, die auf die Cloud zugreifen, unterstützen folgende zusätzliche Parameter.

Hinweis:

Die Parameter CustomerId, ClientId und Secret können in die Datei CustomerInfo.yml eingefügt oder im Cmdlet wie oben erläutert angegeben werden. Bei Angabe an beiden Stellen haben die Cmdlet-Parameter Vorrang.

• CustomerId: Die Kunden-ID wird in den Rest-APIs verwendet und ist für den Zugriff auf alle Rest-APIs erforderlich. Die Kunden-ID finden Sie in Citrix Cloud.
• ClientId: Die auf der Website Citrix Cloud Identity and Access Management erstellte clientID. Dies ist zum Abrufen des Bearertokens erforderlich, der zur Authentifizierung bei allen Rest-APIs benötigt wird.
• Secret: Der auf der Website Citrix Cloud Identity and Access Management erstellte geheime Schlüssel. Dies ist zum Abrufen des Bearertokens erforderlich, der zur Authentifizierung bei allen Rest-APIs benötigt wird.
• CustomerInfoFileSpec: Die Dateispezifikation, die auf eine Kundeninformationsdatei verweist, um den Standardspeicherort und den Standardnamen außer Kraft zu setzen.

Parameter zur Protokollanzeige

Die Cmdlets Export, Import, Sync, Restore, Backup, Compare und Remove zeigen nach Abschluss des Vorgangs die Protokolldatei an. Sie können die Anzeige unterdrücken, indem Sie den Parameter -DisplayLog auf $false einstellen. Notepad.exe wird standardmäßig zur Anzeige des Protokolls verwendet. Sie können in der Datei CustomerInfo.yml einen anderen Editor angeben.

Editor: C:\Program Files\Notepad++\notepad++.exe

Abgeleitete Zustände nach Befehl

Ein abgeleiteter Zustand kann zu einer von drei Aktionskombinationen in der Cloudsite führen:

• Hinzufügen, Aktualisieren und Löschen
• Nur Hinzufügen und Aktualisieren
• Nur Hinzufügen

Die folgende Tabelle zeigt den abgeleiteten Zustand für jedes Cmdlet und optionale Parameter zum Ändern von dessen Verhalten.

Cmdlet-Rückgabewerte

ActionResult

Alle Cmdlets geben den folgenden Wert zurück.

            public class ActionResult
            {
                public bool                         Overall_Success;
                public Dictionary<string, string>   Individual_Success;
                public object                       CustomResult;
            }

Overall_Success gibt einen einzelnen Booleschen Wert zurück, der den Gesamterfolg des Cmdlets für alle ausgewählten Komponenten anzeigt: true = erfolgreich, false = nicht erfolgreich.

Individual_Success gibt einen von drei Werten für jede Hauptkomponente zurück. Das Ergebnis kann Success, Failure oder Skipped lauten. Skipped bedeutet, dass eine Komponente nicht für das Ausführen durch das Cmdlet ausgewählt wurde.

CustomResult ist Cmdlet-spezifisch.

CustomResult

Import, Merge, Restore, Sync, Compare, Compare File und Remove geben die folgenden CustomResult-Informationen in einer EvaluationResultData-Instanz zurück.

Hinweis:

Die Cmdlets Export und Template geben kein CustomResult zurück.

                public class EvaluationResultData
                {
                    public Dictionary<string, Dictionary<string, ActionResultValues >> EvaluationResults;
                    public int                  Added;
                    public int                  Updated;
                    public int                  Deleted;
                    public int                  NoChange;
                    public int                  TotalChanged;
                    public EvaluationResults     OverallResult;
                    public string               CloudBackupFolder;
                    public string               SourceBackupFolder;
                }
                Where:
                public enum ActionResultValues
                {
                    Add,
                    Update,
                    Delete,
                    Identical,
                    DoNothing
                }
                public enum EvaluationResults
                {
                    Success,
                    Failure,
                    Skipped
                }

EvaluationResults zeigt eine Liste mit einem Eintrag pro ausgewählter Komponente an. Der Schlüssel ist der Komponentenname und der Wert eine Liste jedes Komponentenelements und der an diesem ausgeführten Aktion. Die Aktion ist einer der ActionResultValues-Werte.

Added, Updated, Deleted und NoChange entsprechen der Gesamtzahl der hinzugefügten, aktualisierten, gelöschten und nicht geänderten Komponentenelemente (in der hier angegebenen Reihenfolge).

TotalChanged ist die Summe von Added, Updated und Deleted.

OverallResult ist ein Boolescher Wert, der das Ergebnis des Cmdlets beschreibt. “True” bedeutet Erfolg für alle Komponenten, “false” zeigt einen Fehler bei der Verarbeitung mindestens einer Komponente an.

CloudBackupFolder ist die vollqualifizierte Dateispezifikation des Backups der Cloudsite-Konfiguration, die vor Ausführung des Cmdlets erstellt wurde.

SourceBackupFolder ist die vollqualifizierte Dateispezifikation des Backups der Quelldatei, die nach Ausführung des Cmdlets erstellt wurde. Standardmäßig sind diese Dateien unter %HOMEPATH%\Documents\Citrix\AutoConfig.

Hilfe

• Get-Help – PowerShell-Hilfe ist für jedes Cmdlet verfügbar. Sie enthält eine kurze Erläuterung des Cmdlets und eine Dokumentation aller Parameter. Um auf die Hilfe für ein Cmdlet zuzugreifen, geben Sie vor dem Cmdlet Get-Help ein. Beispiel: Get-Help Import-CvadAcToSite.

Weitere Informationen

• Importieren von Objekten mit MCS-Maschinenkatalogen

• Citrix Cloud Government

• Hostverbindungen

• Automatisierung

• Exportieren von anderen PCs als dem Delivery Controller

• Citrix Cloud-Datenerfassung

• Ordner

• Backups

• Protokollierung

• Diagnosedateien

• Probleme mit Voraussetzungen

• Häufige Probleme

• Empfehlungen

• Ressourcen

Importieren anderer Objekte bei Vorhandensein von MCS-Maschinenkatalogen

Derzeit unterstützt die automatische Konfiguration keinen automatisierten Import von MCS-Maschinenkatalogen oder den entsprechenden Bereitstellungsgruppen. Sie können jedoch andere Konfigurationsoptionen (Anwendungen, Richtlinien usw.) mit der automatischen Konfiguration importieren. Maschinenkatalog und Bereitstellungsgruppe müssen unter denselben Namen wie in der On-Premises-Konfiguration erstellt werden. Führen Sie vor dem Import der Anwendungseinstellungen folgende Schritte aus, um die Umgebung vorzubereiten:

1. Klicken Sie im Citrix Cloud-Portal auf das Hamburger-Menü und wählen Sie Eigene Services > Virtual Apps and Desktops Service > Verwalten. Erstellen Sie den MCS-Maschinenkatalog wie gewohnt. Stellen Sie sicher, dass der Name des Katalogs mit dem des On-Premises-Katalogs identisch ist.

2. Erstellen Sie die entsprechende Bereitstellungsgruppe für den neuen Katalog. Stellen Sie sicher, dass ihr Name mit dem der On-Premises-Bereitstellungsgruppe identisch ist.

3. Vergewissern Sie sich in Citrix Studio (On-Premises) im Knoten Anwendungen, dass die Anwendungen zu den entsprechenden Bereitstellungsgruppen gehören. Klicken Sie hierfür mit der rechten Maustaste auf die Anwendung und wählen Sie Eigenschaften.

4. Klicken Sie auf Gruppen, um zu prüfen, zu welchen Gruppen die ausgewählte Anwendung gehört:

5. Führen Sie in PowerShell den Merge-Befehl aus. Verwenden Sie das Flag byDeliveryGroupName, das die Anwendungen nach dem Namen der Bereitstellungsgruppe filtert.

   Merge-CvadAcToSite –Applications $true –ByDeliveryGroupName <DG_name>

6. Geben Sie Yes ein, um fortzufahren.

7. Wählen Sie unter Verwalten > Vollständige Konfiguration im linken Bereich Anwendungen. Aktualisieren Sie die Anzeige, um sicherzustellen, dass die Apps erwartungsgemäß aufgelistet sind. Wählen Sie hierfür die Anwendungen und wählen Sie Anwendungseigenschaften > Gruppen.

Importieren MCS-bezogener Richtlinien

Wenn Sie den MCS-Katalogen oder -Gruppen zugeordnete Richtlinien importieren müssen, gehen Sie folgendermaßen vor:

1. Führen Sie den Befehl Merge-CvadAcToSite -GroupPolicies $true in PowerShell und geben Sie yes ein, um fortzufahren.

   Bei einer erfolgreichen Ausführung wird eine Rückmeldung angezeigt, die der im obigen Screenshot ähnelt (Werte hinzugefügt). Der Screenshot unten zeigt das Ergebnis einer Zeile, für die es keine Änderungen gab (No change).

2. Aktualisieren Sie die Anzeige unter Verwalten > Vollständige Konfiguration und wählen Sie im linken Bereich Richtlinien.

3. Prüfen Sie die Registerkarte Zugewiesen zu gegen Ihre On-Premises-Richtlinienzuweisung.

Wechsel zu Citrix Cloud Government

Die Citrix Cloud Government-Umgebung verwendet verschiedene Zugriffspunkte zum Authentifizieren und Zuweisen von Zugriffstoken. Diese einmalige Anforderung gilt für jegliche Tools zur automatischen Konfiguration, die auf die Cloud zugreifen. Führen Sie die folgenden Schritte aus, um die automatische Konfiguration in Citrix Cloud Government-Umgebungen zu verwenden.

1. Bearbeiten Sie die Datei CustomerInfo.yml im Ordner %HOMEPATH%\Documents\Citrix\AutoConfig.

2. Fügen Sie der Datei CustomerInfo.yml die folgende Zeile hinzu (bzw. ändern Sie sie entsprechend, falls sie bereits vorhanden ist.)

   Environment: "ProductionGov"

Die automatische Konfiguration kann jetzt in Citrix Cloud Government-Umgebungen verwendet werden.

Hostverbindungen

Hostverbindungen und die zugehörigen Hypervisoren können mit der automatischen Konfiguration exportiert und importiert werden.

Das Hinzufügen eines Hypervisors zu einer Hostverbindung erfordert Hypervisortyp-spezifische Sicherheitsinformationen. Diese Informationen können aus Sicherheitsgründen nicht aus der On-Premises-Site exportiert werden. Sie müssen die Informationen manuell bereitstellen, damit die automatische Konfiguration Hostverbindungen und Hypervisors in die Cloudsite importieren kann.

Beim Exportieren wird die Datei HostSecurity.yml in %HOMEPATH%\Documents\Citrix\AutoConfig erstellt. Sie enthält Platzhalter für jedes für den spezifischen Hypervisortyp benötigte Sicherheitselement. Sie müssen die Datei HostSecurity.yml vor dem Import in die Cloudsite aktualisieren. Administratorupdates werden über mehrere Exportvorgänge beibehalten und bei Bedarf neue Sicherheitsplatzhalter hinzugefügt. Sicherheitselemente werden nie entfernt.

Hinweis:

Setzen Sie alle in der Datei HostSecurity.yml eingegebenen Werte in Anführungszeichen.

            HostConn1:
            ConnectionType: XenServer
            UserName: root
            PasswordKey: rootPassword
            HostCon2:
            ConnectionType: AWS
            ApiKey: 78AB6083-EF60-4D26-B2L5-BZ35X00DA5CH
            SecretKey: TwBLaaaaaaaaaaaaaaaaaw==
            Region: East

Hypervisor-spezifische Sicherheitsinformationen

Nachfolgend werden die für die einzelnen Hypervisortypen erforderlichen Sicherheitsinformationen aufgeführt.

• XenServer, Hyper-V, VMware
  • Benutzername
  • Klartextkennwort
• Microsoft Azure
  • Abonnement-ID
  • Anwendungs-ID
  • Anwendungsgeheimnis
• Amazon Web Services
  • Dienstkonto-ID
  • Anwendungsgeheimnis
  • Region

Besondere Sicherheitsüberlegungen

Alle Sicherheitsinformationen werden als Klartext eingegeben. Wenn Klartext nicht empfohlen wird, können die Hostverbindungen und die zugehörigen Hypervisors manuell über die Oberfläche Verwalten > Vollständige Konfiguration des Diensts erstellt werden. Die Namen von Hostverbindungen und Hypervisors müssen mit ihrem On-Premises-Gegenstück übereinstimmen, damit Maschinenkataloge, die die Hostverbindungen verwenden, erfolgreich importiert werden.

Automatisierung

Die Cmdlets der automatischen Konfiguration können ohne Administratoreingriff in Skripts ausgeführt werden. Eingabeaufforderungen und die Anzeige der Protokollergebnisse bei Abschluss des Cmdlets werden dann unterdrückt. Sie können für dieselbe Funktion auch Parameter über die Datei CustomerInfo.yml festlegen.

Fügen Sie den folgenden Parameter zu Cmdlets zur Cloudmodifizierung hinzu, um die Anzeige von Eingabeaufforderungen zu unterdrücken.

-Confirm $false

Fügen Sie den folgenden Parameter zu Cmdlets hinzu, um die Anzeige des Protokolls nach Abschluss des Cmdlets zu unterdrücken.

-DisplayLog $false

Fügen Sie Cmdlets den folgenden Parameter hinzu, um die Protokollierung im PowerShell-Befehlsfenster zu unterdrücken.

-Quiet

Alternativ können die folgenden Parameter in die Datei CustomerInfo.yml geschrieben werden.

Confirm: False

DisplayLog: False

Exportieren von anderen PCs als dem Delivery Controller

Die automatische Konfiguration verwendet mehrere Citrix PowerShell-SDKs, um die Konfiguration der On-Premises-Site zu exportieren. Die SDKs werden automatisch auf dem Delivery Controller installiert, sodass das Tool darauf ohne zusätzliche Aktionen ausgeführt werden kann. Zur Ausführung des Tools auf Maschinen, die kein Delivery Controller sind, müssen Sie die benötigten Citrix PowerShell-SDKs installieren. Die SDKs ist gehören zu Citrix Studio, das vom Citrix Virtual Apps and Desktops-Installationsmedium installiert werden kann.

Hinweis:

Die automatische Konfiguration kann nicht auf dem Cloud Connector ausgeführt werden.

Citrix Cloud-Datenerfassung

Informationen zu den von Citrix Cloud erfassten Informationen finden Sie unter Erfassen von Kundendaten und Protokollen in Citrix Cloud Services.

Ordner

Standard-Stammordner

Alle Vorgänge der automatischen Konfiguration werden im Stammordner oder einem seiner Unterordner ausgeführt. Der Stammordner ist in %HOMEPATH%\Documents\Citrix\AutoConfig.

Exportieren

Alle exportierten Dateien werden zur Gewährleistung der Benutzerfreundlichkeit und zur Bewahrung eines Exportverlaufs in zwei Ordnern gespeichert. Exporte werden immer im Stammordner gespeichert. Kopien werden in dem Unterordner Export mit dem Datum und der Uhrzeit des Exports gespeichert.

Der Stammordner enthält immer die zuletzt exportierte On-Premises-Sitekonfiguration. Jeder Export-Unterordner enthält den zu dem angegebenen Datum und der angegebenen Uhrzeit erfolgten Export, wodurch ein Exportverlauf bereitgestellt wird. Sie können die Cloudsite unter Verwendung eines beliebigen Export-Unterordners konfigurieren. Exportunterordner werden bei der automatischen Konfiguration weder gelöscht noch geändert.

Importieren, Zusammenführen, Synchronisieren, Vergleichen

Die Vorgänge Import, Merge und Compare erfolgen immer mit Quelldateien im Stammordner. Jeder Vorgang führt zur Erstellung eines Unterordners, in den Dateien aus dem Stammordner kopiert werden, sodass ein Verlauf der Quelldateien der Cloudsite-Änderungen entsteht.

Wiederherstellen

Der Restore-Vorgang verwendet einen bestehenden Unterordner zum Konfigurieren der Cloudsite. Der Quellordner wird mit dem erforderlichen Parameter -RestoreFolder angegeben. Im Gegensatz zu anderen Befehlen wird kein Unterordner erstellt, da der Restore-Vorgang einen bestehenden Unterordner verwendet. Als Wiederherstellungsordner kann der Stammordner verwendet werden, doch auch er muss im -RestoreFolder-Parameter angegeben werden.

Backups

Die automatische Konfiguration initialisiert, aktualisiert und sichert die Cloudsite-Konfiguration. Die Verwendung im Laufe der Zeit kann zu vielen Konfigurationsänderungen bei der Cloudsite führen. Zur Vereinfachung der langfristigen Verwendung speichert die automatische Konfiguration den Änderungsverlauf und bietet eine Methode zum Wiederherstellen früherer Zustände.

Backups der Cloudsite-Konfiguration werden immer in einem Unterordner namens Backup mit Datum und Zeitpunkt des Backups gespeichert. Exportunterordner werden bei der automatischen Konfiguration weder gelöscht noch geändert.

Sie können mit den Backups einzelne Komponenten oder die gesamte Konfiguration wiederherstellen. Verwenden Sie zum Wiederherstellen der gesamten Bereitstellungsgruppen- und Maschinenkatalogkomponenten folgendes Cmdlet:

Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss -DeliveryGroups -MachineCatalogs

Hinweis:

Die Informationen zur Backupdatei im obigen Cmdlet basieren auf Ihren eigenen Backups.

Verwenden Sie zum Wiederherstellen der gesamten Cloudsite-Konfiguration folgendes Cmdlet:

Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss

Hinweis:

Die Informationen zur Backupdatei im obigen Cmdlet basieren auf Ihren eigenen Backups.

Ändern des Standardstammordners

Die Vorgänge Export, Import, Merge, Sync und Compare können bei Verwendung des Parameters –AlternateFolder den Stammordner ändern. Die Erstellung und Verwaltung vorgangsbezogener Unterordner ist weiterhin wie oben beschrieben.

In Unterordner kopierte Dateien

Mit Ausnahme der Folgenden werden alle Dateien mit der Erweiterung “yml” in Vorgangsunterordner kopiert:

• CustomerInfo.yml
• ZoneMapping.yml
• HostSecurity.yml

Automatisierte, ausfallsichere Cloudsite-Backups

Vor dem Ausführen von Vorgängen, die die Konfiguration ändern, wird ein Backup der Cloudsite-Konfiguration vorgenommen. Dies betrifft die Parameter Import, Merge, Sync und Restore. Das Backup ist immer in einem Unterordner des zum Vorgang gehörenden Unterordners.

Bei Restore ist der Backupordner ein Unterordner des im Parameter -RestoreFolder angegebenen Ordners.

Protokollierung

Beim Ausführen eines Cmdlets wird immer eine Protokolldatei erstellt und der Hauptverlaufsprotokolldatei ein Eintrag hinzugefügt. Alle Vorgangsprotokolldateien werden in einem Backupordner gespeichert. Alle Protokolldateinamen beginnen mit CitrixLog, gefolgt von dem Vorgang der automatischen Konfiguration und dem Datum und der Uhrzeit der Cmdlet-Ausführung. Protokolle werden nicht automatisch gelöscht.

Das Hauptverlaufsprotokoll ist in %HOMEPATH%\Documents\Citrix\AutoConfig (Dateiname History.Log). Jede Cmdlet-Ausführung wird im Hauptverlaufsprotokoll mit Datum, Vorgang, Ergebnis, Backup und Protokolldatei-Speicherorten eingetragen.

Die Protokollierung

Jede Protokolldatei enthält Folgendes:

• Name des Vorgangs und ob der Prüfmodus aktiviert ist
• Datum und Uhrzeit des Starts und Endes
• Einträge für die Aktionen an jeder Komponente und Erfolgs-/Fehlermeldung
• Zusammenfassung der durchgeführten Aktionen, einschließlich Anzahl erstellter Objekte
• Gegebenenfalls Empfehlungen für Fixes
• Gegebenenfalls Speicherort des Backupordners
• Speicherort des Hauptprotokolls
• Dauer

Diagnosedateien

Diagnosedateien helfen bei der Ermittlung und Behebung von Problemen. Die folgenden Dateien werden erstellt, wenn der betreffende Vorgang ausgeführt wird. Sie sind in dem aktionsspezifischen Unterordner in %HOMEPATH%\Documents\Citrix\AutoConfig. Fügen Sie diese Dateien bei, wenn Sie Informationen für den Support zur Problembehebung bereitstellen.

Exportieren

PoshSdk_yyyy_mm_dd_hh_mm_ss.ps1

Diese Datei listet alle Broker-PowerShell-SDK-Aufrufe auf, die zum Exportieren der Sitekonfiguration ausgeführt wurden.

Import, Merge, Restore, Sync, Backup, Compare

Transaction_yyyy_mm_dd_hh_mm_ss.txt

Diese Datei dokumentiert jeden Rest API-Aufruf und zugehörige Informationen.

RestApiContent_yyyy_mm_dd_hh_mm_ss.txt

Diese Datei enthält den Inhalt für alle Add-, Update- und Delete-Rest APIs.

Durch Voraussetzungen verursachte Probleme

Import und Zusammenführung können aufgrund fehlender Voraussetzungen fehlschlagen. Einige häufig auftretende Probleme:

1. In Gruppenrichtlinien fehlen Bereitstellungsgruppenfilter. Die übliche Ursache sind nicht importierte Bereitstellungsgruppen.
2. Anwendungen können nicht importiert oder zusammengeführt werden. Die übliche Ursache sind nicht importierte Bereitstellungsgruppen oder Anwendungsgruppen.
3. In Anwendungsgruppen fehlt ein RestrictToTag. Die übliche Ursache sind nicht importierte Tags.
4. Hostverbindungen schlagen fehl. Die übliche Ursache sind fehlende Sicherheitsinformationen in der Datei CvadAcSecurity.yml.
5. Maschinenkataloge schlagen fehl. Die übliche Ursache sind nicht importierte Hostverbindungen.
6. In Maschinenkatalogen und Bereitstellungsgruppen fehlen Maschinen. Die übliche Ursache sind Maschine, die nicht in Active Directory gefunden wurden.
7. In Bereitstellungsgruppen fehlen Benutzer. Die übliche Ursache sind Benutzer, die nicht in Active Directory gefunden wurden.

Häufige Probleme

Cloudsite ist leer

Eine leere Site deutet darauf hin, dass der Import-/Merge-/Restore-Vorgang nicht einwandfrei ausgeführt wurde. Wurde ein solcher Vorgang versucht, überprüfen Sie das zugehörige Protokoll.

Cloudsite enthält mehr Elemente als erwartet

Dies kann passieren, wenn die Konfiguration der Cloudsite erweitert und ein Merge-Vorgang ausgeführt wurde. Es kann auch vorkommen, wenn die Konfiguration der Cloudsite Werte aufwies und beim Import/Merge/Restore Fehler auftreten. Versuchen Sie den Vorgang erneut.

Cloudsite enthält weniger Elemente als erwartet

Dies kann passieren, wenn die Cloudsite-Konfiguration erweitert und ein Import mit dem Parameter Merge = $false ausgeführt wurde, was zu einem identischen abgeleiteten Zustand führt. Ein Backup des ursprünglichen Zustands in dem Ordner Automated Fail-Safe-Cloud Site Backup gespeichert, der dem Importvorgang zugeordnet ist. Behebung:

1. Stellen Sie das Automated Fail-Safe Cloud Site Backup mit “Restore” wieder her, und legen Sie dabei den Parameter “RestoreFolder” auf Automated Fail-Safe Cloud Site Backup fest.

2. Verwenden Sie Merge anstelle von Import.

Nach dem Import erfolgte Änderungen der Cloudsite gehen verloren

Dies kann passieren, wenn ein Import mit dem –Merge-Parameter = $false ausgeführt wurde, was zu einem identischen abgeleiteten Zustand führt. Ein Backup des ursprünglichen Zustands in dem Ordner Automated Fail-Safe-Cloud Site Backup gespeichert, der dem Importvorgang zugeordnet ist. Behebung:

1. Stellen Sie das Automated Fail-Safe Cloud Site Backup mit “Restore” wieder her und legen Sie dabei den Parameter RestoreFolder auf Automated Fail-Safe Cloud Site Backup fest.

2. Verwenden Sie Merge anstelle von Import.

Cloudsite stimmt nicht mit der aktuellen On-Premises-Site überein

Dies kann passieren, wenn ein Merge ausgeführt wurde, was zu einem zusammengeführten abgeleiteten Zustand führt, anstelle eines Import-Vorgangs mit dem Merge-Parameter = $false, was zu einem identischen abgeleiteten Zustand führt. Wiederholen Sie den Vorgang unter Verwendung von Import mit Parameter Merge = $false.

Empfehlungen

• Führen Sie nicht mehrere Instanzen der automatischen Konfiguration gleichzeitig aus. Das Ausführen mehrerer Instanzen führt zu unvorhersehbaren Ergebnissen in der Cloudsite. Führen Sie in diesem Fall eine Instanz der automatischen Konfiguration noch einmal aus, um die Site in den erwarteten Zustand zu versetzen.
• Arbeiten Sie nicht in der vollständigen Konfiguration, während Sie die automatische Konfiguration ausführen. Das Vornehmen von Änderungen in der vollständigen Konfiguration, während Sie eine automatische Konfiguration ausführen, kann zu unvorhersehbaren Ergebnissen in der Cloudsite führen. Führen Sie in diesem Fall eine Instanz der automatischen Konfiguration noch einmal aus, um die Site in den erwarteten Zustand zu versetzen.
• Stellen Sie stets über eine visuelle Kontrolle der Ergebnisse von Merge/Import/Restore in der vollständigen Konfiguration sicher, dass die Cloudsite den Erwartungen entspricht.

Ressourcen

• Ausführlichere und aktuelle Informationen zur Problembehandlung und zum Support finden Sie im Knowledge Center-Artikel CTX277730.

• Weitere Informationen zur automatisierten Konfiguration finden Sie unter Proof of Concept: Automated Configuration Tool.

• Besuchen Sie das Citrix Diskussionsforum zur automatisierten Konfiguration.

• Schauen Sie sich das Video Under the Hood of the Automated Configuration Tool for Citrix Virtual Apps and Desktops auf YouTube an.

• Das Cloud Learning Center enthält Videos mit schrittweisen Anleitungen zum Aufbau einer Service-Bereitstellung, einschließlich der in diesem Artikel beschriebenen Aufgaben. Siehe Migrating Citrix Virtual Apps and Desktops to Citrix Cloud Learning Path.