Migration und Verwaltung
Wenn Sie eine Citrix Virtual Apps and Desktops Service-Konfiguration 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.
Automatische Konfiguration für Citrix Virtual Apps and Desktops
Die automatische Konfiguration für Citrix Virtual Apps and Desktops ist ein Tool zum Automatisieren der Migration einer On-Premises-Bereitstellung nach Citrix Virtual Apps and Desktops Service.
Die automatische Konfiguration unterstützt auch das Verschieben der Konfiguration von einer Citrix Virtual Apps and Desktops Service-Bereitstellung zu einer anderen. Sie können mit der automatischen Konfiguration auch Ihre Bereitstellungen verwalten.
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.
Herunterladen der automatischen Konfiguration
Laden Sie die automatische Konfiguration von Citrix Downloads herunter. Weitere Informationen finden Sie unter Proof of Concept: Automated Configuration Tool.
Voraussetzungen für die Migration Ihrer Konfiguration
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. (Zur Ausführung auf einer anderen Maschine muss diese zur Domäne gehören und Citrix Studio installiert werden, 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.
- Citrix Virtual Apps and Desktops Service mit einem aktiven Ressourcenstandort und installiertem Connector; es muss derselben Domäne angehören wie die On-Premises-Bereitstellung.
- Der Sitezugriff auf die Citrix Cloud muss zugelassen sein. Weitere Informationen finden Sie unter Anforderungen an System und Konnektivität.
Unterstützte Objekte für die Migration
Die automatische Konfiguration unterstützt und migriert die folgenden Komponenten.
- Tags
- Hostverbindungen
- Ein einzelner Ressourcenpool
- Admin-Geltungsbereiche
- Maschinenkataloge
- Admin-Geltungsbereiche
- Maschinen
- Remote-PC-Zugriff, physisch, gepoolt, bereitgestellt (außer MCS), zugewiesen
- Bereitstellungsgruppen
- Zugriffsrichtlinie
- Admin-Geltungsbereiche
- Anwendungszugriffsrichtlinie
- Zuweisungsrichtlinie
- Anspruch-/Desktoprichtlinie
- Energiezeitpläne
- Sitzungsfortbestehen
- Vorabstart von Sitzungen
- Neustartzeitpläne
- Tags
- Anwendungsgruppen
- Admin-Geltungsbereiche
- Anwendungen
- Anwendungsordner
- Symbole
- Anwendungen
- Per Broker konfigurierte FTAs
- Tags
- Gruppenrichtlinien
Bekannte Einschränkungen
- Mit Maschinenerstellungsdienste bereitgestellte Maschinenkataloge werden derzeit nicht unterstützt. Sie können andere Objekte von Ihrer Site importieren. Weitere Informationen zu MCS finden Sie unter Importieren anderer Objekte bei Vorhandensein von MCS-Maschinenkatalogen.
- Symbole werden nicht auf Maschinen oder Desktops angewendet.
- Die Zugriffssteuerung muss manuell mit dem Remote POSH-SDK hinzugefügt werden.
- Delegierte Administration. Zuordnen von Administratorgeltungsbereichen wird unterstützt.
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.
Exportieren der On-Premises-Konfiguration von Citrix Virtual Apps and Desktops
- Installieren Sie die automatische Konfiguration auf Ihrem Delivery Controller.
- Öffnen Sie PowerShell als Administrator.
-
Führen Sie den folgenden Befehl aus, um einen Basisexport durchzuführen.
Export-CvadAcToFile –All $true
Hinweis:
Beschreibungen weiterer verfügbarer Befehle finden Sie unter hier.
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. Weitere Informationen zu den Protokollen und deren Inhalt finden Sie unter Protokollierung.
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 einen Citrix Provisioning-Katalog oder Hostverbindungen haben, müssen Sie die entsprechenden Informationen in HostSecurity.yml und CvadAcSecurity.yml eingeben.
Ausführen eines Basisimports
- Führen Sie PowerShell als Administrator aus.
-
Führen Sie den folgenden Befehl aus, um einen Basisimport durchzuführen.
Merge-CvadAcToSite -All $true
Hinweis:
Beschreibungen weiterer verfügbarer Befehle finden Sie unter hier.
Überprüfen Sie den erwarteten Zustand gegen den neuen aktuellen Zustand. Wenn Sie einen Merge
-Import durchführen, muss der erwartete Zustand eine Teilmenge des neuen aktuellen Zustands sein, damit der Import erfolgreich ist.
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. Weitere Informationen zu den Protokollen und deren Inhalt finden Sie unter Protokollierung.
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.
Importreihenfolge und Komponentenabhängigkeit
Die folgenden Komponenten können in den Befehlen Export
, Import
, Merge
, New
, Sync
und Restore
ausgewählt werden. Sie werden in der Importreihenfolge aufgeführt. Das Importieren in einer anderen Reihenfolge kann zu Fehlern bezüglich Abhängigkeiten und einem Fehlschlagen des Imports führen.
- Tags
- Hostverbindungen
- Maschinenkataloge
- Bereitstellungsgruppen
- Anwendungsgruppen
- Anwendungen
- 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. Voraussetzungen einer Komponente müssen für einen Import oder das 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.
- Tags
- Keine Voraussetzungen
- Hostverbindungen
- Sicherheitsinformationen in CvadAcSecurity.yml
- Maschinenkataloge
- In Active Directory vorhandene Maschinen
- Hostverbindungen
- Tags
- Bereitstellungsgruppen
- In Active Directory vorhandene Maschinen
- In Active Directory vorhandene Benutzer
- Maschinenkataloge
- Tags
- Anwendungsgruppen
- Bereitstellungsgruppen
- Tags
- Anwendungen
- Bereitstellungsgruppen
- Anwendungsgruppen
- Tags
- Gruppenrichtlinien
- Bereitstellungsgruppen
- Tags
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.
Die Datei CustomerInfo.yml kann mit dem New-CvadAcCustomerInfoFile
Cmdlet erstellt werden. New-CvadAcCustomerInfoFile
hat die folgenden 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==
Sie können die Datei CustomerInfo.yml mithilfe des Cmdlets Set-CvadAcCustomerInfoFile
aktualisieren.
Hinweis:
Das Cmdlet ändert nur die Kunden-ID, die Client-ID oder den geheimen Schlüssel.
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"
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
Generieren der Kunden-ID, der Client-ID und des geheimen Schlüssels
Mit dem nachfolgenden Verfahren können Sie die Client-ID und den geheimen Schlüssel erstellen, die zum Importieren der Konfiguration in Citrix Cloud erforderlich sind.
-
Melden Sie sich bei Ihrem Citrix Cloud-Konto an und wählen Sie den Kunden aus.
-
Klicken Sie auf das Hamburger-Menü und wählen Sie die Option Identitäts- und Zugriffsverwaltung.
-
Klicken Sie auf der Seite Identitäts- und Zugriffsverwaltung auf API-Zugriff.
-
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.
-
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.
-
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 Zonenzuordnungsdatei
Die On-Premises-Zone entspricht dem Cloudressourcenstandort. Im Gegensatz zu anderen Sitekomponenten können Sie die On-Premises-Zone nicht automatisch in einen Cloudressourcenstandort importieren. Sie muss über die Datei ZoneMapping.yml zugeordnet werden. Importfehler können auftreten, wenn der Zonenname nicht mit dem Namen eines bestehenden Ressourcenstandorts übereinstimmt.
Die Datei ZoneMapping.yml wird nach dem Exportieren der lokalen Konfiguration und vor deren Import in die Cloud manuell erstellt und muss in %HOMEPATH%\Documents\Citrix\ AutoConfig sein. Die YML-Datei beinhaltet ein Wörterbuch mit dem Zonennamen als Schlüssel und dem Ressourcennamen als Wert.
Ein Beispiel:
---
Primary: "My Primary Resource Location"
Zone2: "Second Resource Location"
Hinweis:
Ein Leerzeichen muss zwischen dem Doppelpunkt und dem Namen des Ressourcenstandorts stehen.
Wird die Datei ZoneMapping.yml nicht gefunden oder ist die korrekte Zuordnung nicht vorhanden und die Cloudsite hat nur eine Zone, wird diese Zone automatisch für die Zuordnung zu allen On-Premises-Zonen verwendet.
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
- Notfallwiederherstellung
- 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 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 einen Citrix Provisioning-Katalog oder Hostverbindungen haben, müssen Sie die entsprechenden Informationen in HostSecurity.yml und CvadAcSecurity.yml eingeben.
- Installieren Sie die automatische Konfiguration.
- Führen Sie PowerShell als Administrator aus.
-
Führen Sie den folgenden Befehl aus, um ein Basisbackup durchzuführen.
Backup-CvadAcToFile –All $true
Hinweis:
Beschreibungen weiterer verfügbarer Befehle finden Sie unter hier.
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. Weitere Informationen zu den Protokollen und deren Inhalt finden Sie unter Protokollierung.
Wiederherstellen einer Konfiguration in Citrix Virtual Apps and Desktops Service
Hinweis:
Hinweis: Dieser Abschnitt folgt Sichern der Citrix Virtual Apps and Desktops Service-Konfiguration und den dort dokumentierten Schritten. Führen Sie diese Schritte aus, bevor Sie mit der Wiederherstellung beginnen.
Ausführen einer Basiswiederherstellung
- Führen Sie PowerShell als Administrator aus.
-
Führen Sie den folgenden Befehl aus, um eine Basiswiederherstellung durchzuführen.
Restore-CvadAcToSite -All $true -RestoreFolder <folder path of the backup files>
Hinweis:
Beschreibungen weiterer verfügbarer Befehle finden Sie unter hier.
Ü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. Weitere Informationen zu den Protokollen und deren Inhalt finden Sie unter Protokollierung.
Notfallwiederherstellung
Die Notfallwiederherstellung 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.
Es können für Backups zwar einzelne Komponenten ausgewählt werden, zur Notfallwiederherstellung empfiehlt Citrix 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 RestoreFrom
, der ausgewählten Einzelkomponente und der Aufnahmeliste verwendet.
Gehen Sie beispielsweise folgendermaßen vor, um zwei Gruppenrichtlinien aus einem Backup wiederherzustellen:
Restore-CvadAcToSite -RestoreFrom %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 -RestoreFrom %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 -RestoreFrom %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss
Cmdlets der automatischen Konfiguration
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. -
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! -
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. -
Restore-CvadAcToSite
: Stellt die Cloud-Site wieder auf die vorherige Konfiguration zurück. Importierte Dateien werden aus dem im Parameter-RestoreFolder
angegebenen Ordner bezogen. Dies kann zur Wiederherstellung der vorherigen Konfiguration oder für die Notfallwiederherstellung der Cloud-Site verwendet werden. -
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. -
Sync-CvadAcToSite
: Die Synchronisierung führt sowohl den Export als auch den Import in einem Schritt durch. -
Backup-CvadAcToFile
: Exportiert die Cloudkonfiguration in YML-Dateien. Das Backup kann zur Wiederherstellung der vorherigen Konfiguration oder für die Notfallwiederherstellung verwendet werden. -
Compare-CvadAcToSite
: Vergleicht die lokalen YML-Dateien mit der Cloud-Konfiguration und erstellt einen Bericht über Änderungen, die von dem CmdletImport
,Merge
oderRestore
ausgeführt wurden. -
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 ParameterIncludeByName
können so Elemente selektiv entfernt werden.
Granulare Cmdlet-Parameter für die Migration
Alle Cmdlets, die in ToSite
, ToFile
oder FromSite
enden, ermöglichen die Auswahl einer oder mehrerer Komponenten für Aktionen. Die Parameter gestatten mehr Granularität zur selektiven Migration von Komponenten. Sie treffen über eine oder mehrere true/false-Optionen eine Auswahl.
Hinweis:
Die Auswahl
All
bewirkt, dass die anderen Parameter ignoriert werden. Die OptionAll
wird automatisch verwendet, wenn keine Komponenten ausgewählt sind.
All
Tags
MachineCatalogs
DeliveryGroups
ApplicationGroups
Applications
GroupPolicies
-
IncludeByName
undExcludeByName
: Weitere Informationen siehe unten.
Filtern nach Objektnamen
Ein- 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.
Beim Ein- und Ausschließen unterstützte Cmdlets:
Export-CvadAcToFile
Import-CvadAcToSite
Merge-CvadAcToSite
New-CvadAcToSite
Restore-CvadAcToSite
Sync-CvadAcSiteToSite
Compare-CvadAcToSite
Remove-CvadAcFromSite
IncludeByName
und ExcludeByName
akzeptieren eine Liste mit Elementen. Die Name können einen oder mehrere Platzhalter enthalten. Zwei Arten von Platzhaltern werden unterstützt.
- Entspricht einer beliebigen Anzahl von Zeichen
- Entspricht einem Zeichen
Beispiel zum Zusammenführen aller Bereitstellungsgruppen, deren Namen mit DgSite1
beginnen und Home2
enthalten:
Merge-CvadAcToSite –DeliveryGroups $true –IncludeByName DgSite1*,*Home2*
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.
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.
Für ByDeliveryGroupName
unterstützte Cmdlets:
Export-CvadAcToFile
Import-CvadAcToSite
Merge-CvadAcToSite
New-CvadAcToSite
Restore-CvadAcToSite
Sync-CvadAcSiteToSite
Compare-CvadAcToSite
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 Zeichen
Im folgenden Beispiel werden alle Anwendungen zusammengeführt, die auf alle Bereitstellungsgruppennamen verweisen, die mit EastDg
beginnen.
Merge-CvadAcToSite –Applications $true –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.
Migrationsmodus-Parameter
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. -
Merge
: Führt die Dateidaten in die Cloud zusammen, löscht jedoch keine Komponenten. Diese Option ist standardmäßig im CmdletMerge
aktiviert, inImport
undSync
ist sie optional. -
AddOnly
: Fügt nur Komponenten hinzu. Vorhandene Komponenten werden nicht aktualisiert oder gelöscht.AddOnly
ist bei allen Cmdlets optional mit Ausnahme vonNew
, wo es standardmäßig aktiviert ist. -
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 CmdletRemove
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. -
AdminAddress
: Wird für Cmdlets zum Exportieren unterstützt und kann auf beliebige Delivery Controller zum Exportieren abzielen. Die benötigten Citrix PowerShell-SDKs müssen auf der Maschine installiert sein, auf der die automatische Konfiguration ausgeführt wird (siehe Voraussetzungen für die Migration Ihrer Konfiguration). Hostverbindungen können nicht exportiert werden, wenn das Tool auf einer anderen Maschine als einem Delivery Controller ausgeführt wird. -
CheckAllMachines
: Prüft, ob alle Maschinen in Maschinenkatalogen in Active Directory vorhanden sind. Ist eine Maschine nicht vorhanden, wird sie aus dem Maschinenkatalog entfernt und ein entsprechender Eintrag wird dem Abschnitt “Fixups” in der Protokolldatei hinzugefügt. So werden Fehler beim Hinzufügen von Maschinenkatalogen aufgrund nicht vorhandener Maschinen vermieden.CheckAllMachines
ist standardmäßig auf “true” festgelegt.
Parameter für den Cloudzugriff
Alle Cmdlets, die auf die Cloud zugreifen (Cmdlets, die in ToSite
, FromSite
oder Get-CvadAcStatus
enden), unterstützen folgende zusätzliche Parameter.
Hinweis:
Diese Parameter werden nicht benötigt, wenn sie der Datei CustomerInfo.yml hinzugefügt werden.
-
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. Er ist zum Abrufen des Bearertokens erforderlich, das zur Authentifizierung bei allen Rest-APIs benötigt wird. -
Secret
: Der auf der Website Citrix Cloud Identity and Access Management erstellte geheime Schlüssel. Er ist zum Abrufen des Bearertokens erforderlich, das 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. -
SiteActive
: Bestimmt, ob die Cloud-Site passiv oder aktiv ist. Die Cloud-Site ist bei Einstellung vonFalse
passiv und bei Einstellung vonTrue
aktiv.SiteActive
ist standardmäßig aufFalse
festgelegt, d. h. die Cloud-Site ist passiv.
Support und Problembehandlung von Cmdlets
-
New-CvadAcCustomerInfoFile
: Erstellt die Datei CustomerInfo.yml mit den Parametern “CustomerID”, “ClientID” und “Secret”. -
Set-CvadAcCustomerInfoFile
: Ermöglicht das Bearbeiten der Parameter “CustomerID”, “ClientID” und “Secret” in der Datei CustomerInfo.yml. -
New-CvadAcTemplateToFile
: Erstellt eine Vorlagendatei für ausgewählte Komponenten zur manuellen Erstellung einer Importdatei. -
Test-CvadAcConnectionWithSite
: Testet die Verbindung mit der Cloudsite. Das Cmdlet verwendet die Cloudzugriffsparameter oder die Datei CustomerInfo.yml zum Angeben der Kundenverbindungsinformationen. -
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. -
Get-CvadAcCustomerSites
: Gibt die Liste aller Kundensites zurück. Das Cmdlet verwendet die Cloudzugriffsparameter oder die Datei CustomerInfo.yml zum Angeben der Kundenverbindungsinformationen. -
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 und ob ein oder mehrere Connectors vorhanden sind.
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.
Befehl | Hinzufügen, Aktualisieren, Löschen | Hinzufügen, Aktualisieren | Add |
---|---|---|---|
Importieren | -Merge $false |
Standard | -AddOnly $true |
Merge | Nicht zutreffend | Standard | -AddOnly $true |
Neu | Nicht zutreffend | Nicht zutreffend | Standard |
Synchronisieren | -Merge $false |
Standard | -AddOnly $true |
Wiederherstellen | -Merge $false |
Standard | -AddOnly $true |
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
undTemplate
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
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.
Get-Help Import-CvadAcToSite
Ordner, Backups und Protokollierung
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.
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.
Jeder Unterordner kann zum Konfigurieren der Cloudsite verwendet werden. Exportunterordner werden bei der automatischen Konfiguration weder gelöscht noch geändert.
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.
Backup
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 -RestoreFrom %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss -DeliveryGroups $true -MachineCatalogs $true
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 -RestoreFrom %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 -RestoreFrom
angegebenen Ordners.
Protokollierung
Beim Ausführen eines Cmdlets wird immer eine Protokolldatei erstellt und der Master-Verlaufsprotokolldatei 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 Master-Verlaufsprotokoll ist in %HOMEPATH%\Documents\Citrix\AutoConfig (Dateiname History.Log). Jede Cmdlet-Ausführung wird im Master-Verlaufsprotokoll 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 Master-Verlaufsprotokolls
- 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.
Weitere Informationen
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:
-
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.
-
Erstellen Sie die entsprechende Bereitstellungsgruppe für den neuen Katalog. Stellen Sie sicher, dass ihr Name mit dem der On-Premises-Bereitstellungsgruppe identisch ist.
-
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.
-
Klicken Sie auf “Gruppen”, um zu prüfen, zu welchen Gruppen die ausgewählte Anwendung gehört:
-
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>
-
Geben Sie Yes ein, um fortzufahren.
-
Wechseln Sie in der Studio-Konsole in Citrix Cloud zu Anwendungen und aktualisieren Sie die Anzeige, um sich zu vergewissern, dass die Apps wie erwartet aufgeführt werden. Wählen Sie hierfür die Anwendungen und gehen Sie zu Anwendungseigenschaften > Gruppen.
Importieren MCS-bezogener Richtlinien
Wenn Sie den MCS-Katalogen oder -Gruppen zugeordnete Richtlinien importieren müssen, gehen Sie folgendermaßen vor:
-
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).
-
Aktualisieren Sie das Studio-Fenster in Citrix Cloud und klicken Sie links auf Richtlinien.
-
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.
- Bearbeiten Sie die Datei CustomerInfo.yml im Ordner %HOMEPATH%\Documents\Citrix\AutoConfig.
-
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.
Administrator-Geltungsbereiche
Der Export- und der Importvorgang unterstützen Administrator-Geltungsbereiche. Beim Importvorgang kann jedoch nur ein Bereich zugeordnet, nicht aber erstellt werden. Führen Sie die folgenden Schritte aus, um Administrator-Geltungsbereiche zu exportieren und in die Cloudsite zu importieren.
- Exportieren Sie die On-Premises-Site.
- Navigieren Sie im On-Premises-Citrix Studio zur Registerkarte Konfiguration > Administratoren > Geltungsbereiche und notieren Sie alle vorhandenen Bereiche. Die Zuordnungen müssen nicht notiert werden, da sie beim Importieren der Komponenten erstellt werden.
- Navigieren Sie in der Citrix Cloud-Konsole zur Registerkarte Konfiguration > Administratoren > Geltungsbereiche und erstellen Sie manuell jeden im vorherigen Schritt notierten Bereich.
- Führen Sie an dem Export aus Schritt 1 ein
Import
,Merge
,Restore
,New
oderSync
aus. - Die manuell erstellten Bereiche werden den richtigen Komponenten zugeordnet.
Wenn die Administrator-Geltungsbereiche nicht zuerst manuell erstellt werden, werden sie beim Importieren aus den Komponenten entfernt. Nach dem manuellen Erstellen der Bereiche ordnet ein erneuter Import die Bereiche den Komponenten zu.
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.
---
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 Hypervisoren manuell über die Studio-Konsole in Citrix Cloud erstellt werden. Die Namen von Hostverbindungen und Hypervisors müssen mit den On-Premises-Gegenstücken ü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
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 ohne zusätzliche Aktionen auf diesem 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:
Hostverbindungen können nicht von einer Maschine, die kein Delivery Controller ist, exportiert werden.
Die automatische Konfiguration kann nicht auf dem Cloud Connector ausgeführt werden.
Citrix Cloud-Datenerfassung
Informationen zu den von Citrix Cloud erfassten Daten finden Sie unter Citrix Cloud Services Erfassen von Kundendaten und Protokollen.
Problembehandlung und Empfehlungen
Ausführlichere und aktuelle Informationen zur Problembehandlung und zum Support finden Sie im Knowledge Center-Artikel CTX277730.
Zur schnellen Problembehandlung lesen Sie die Protokolldatei, insbesondere den Abschnitt Fixups.
Durch Voraussetzungen verursachte Probleme
Import und Zusammenführung können aufgrund fehlender Voraussetzungen fehlschlagen. Einige häufig auftretende Probleme:
- In Gruppenrichtlinien fehlen Bereitstellungsgruppenfilter. Die übliche Ursache sind nicht importierte Bereitstellungsgruppen.
- Anwendungen können nicht importiert oder zusammengeführt werden. Die übliche Ursache sind nicht importierte Bereitstellungsgruppen oder Anwendungsgruppen.
- In Anwendungsgruppen fehlt ein RestrictToTag. Die übliche Ursache sind nicht importierte Tags.
- Hostverbindungen schlagen fehl. Die übliche Ursache sind fehlende Sicherheitsinformationen in der Datei CvadAcSecurity.yml.
- Maschinenkataloge schlagen fehl. Die übliche Ursache sind nicht importierte Hostverbindungen.
- In Maschinenkatalogen und Bereitstellungsgruppen fehlen Maschinen. Die übliche Ursache sind Maschine, die nicht in Active Directory gefunden wurden.
- 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:
-
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.
-
Verwenden Sie
Merge
anstelle vonImport
.
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:
-
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. -
Verwenden Sie
Merge
anstelle vonImport
.
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 Web Studio oder mit der Vollkonfigurationskonsole, während Sie die automatische Konfiguration ausführen. Das Vornehmen von Änderungen in Web Studio oder der Vollkonfigurationskonsole während der Ausführung der automatischen Konfiguration 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.
- Überprüfen Sie immer visuell die Ergebnisse von Merge/Import/Restore in Web Studio oder der Vollkonfigurationskonsole, um sicherzustellen, dass die Cloudsite die Erwartungen erfüllt.
Weitere Informationen
-
Besuchen Sie das Citrix Diskussionsforum zur automatisierten Konfiguration.
-
Schauen Sie Under the Hood of the Automated Configuration Tool for CVAD auf YouTube an.
In diesem Artikel
- Automatische Konfiguration für Citrix Virtual Apps and Desktops
- Herunterladen der automatischen Konfiguration
- Voraussetzungen für die Migration Ihrer Konfiguration
- Migration von on-premises in die Cloud
- Migration von Cloud zu Cloud
- Notfallwiederherstellung
- Cmdlets der automatischen Konfiguration
- Ordner, Backups und Protokollierung
- Weitere Informationen
- Problembehandlung und Empfehlungen