Produktdokumentation
Citrix DaaS™
PDF anzeigen

Cmdlets für die automatisierte Konfiguration zur Migration

April 6, 2026
Beitrag von: 
C C

Diese Seite listet alle Cmdlets und Parameter auf, die vom Tool für Migrationsanwendungsfälle unterstützt werden.

Alle Cmdlets akzeptieren Parameter, die einen der folgenden Typen haben:

  • String
  • Liste von Strings
  • Boolean: $true oder $false
  • SwitchParameter: Das Vorhandensein des Parameters bedeutet $true; das Fehlen des Parameters bedeutet $false

Hinweis:

SwitchParameter ist die bevorzugte Methode für True/False-Auswahlen, aber Booleans werden im Tool aufgrund von Legacy-Problemen immer noch verwendet.

Die folgende Tabelle ist eine Zusammenfassung aller Cmdlets. In jedem einzelnen Abschnitt finden Sie, welche Parameter jedes Cmdlet unterstützt.

|Kategorie|Cmdlet|Beschreibung| |—|—|—| |[Migration von On-Premises in die Cloud](#on-premises-to-cloud-cmdlets)|Export-CvadAcToFile|Exportiert On-Premises-Dateien in YAML-Dateien.| |^^|Import-CvadAcToSite|Importiert YAML-Dateien in die Cloud. Unterstützt Erstellungs-, Aktualisierungs- und Löschvorgänge.| |^^|Merge-CvadAcToSite|Importiert YAML-Dateien in die Cloud. Unterstützt Erstellungs- und Aktualisierungsvorgänge.| |^^|New-CvadAcToSite|Importiert YAML-Dateien in die Cloud. Unterstützt Erstellungs- und Aktualisierungsvorgänge.| |^^|Sync-CvadAcToSite|Exportiert und importiert in einem Schritt.| |^^|*Granulare Migration* Für Komponenten verwenden Sie Parameter mit den oben genannten Befehlen. Beispiele: MachineCatalogs, Tags. Für Komponentennamen verwenden Sie Parameter mit den oben genannten Befehlen. Beispiele: IncludeByName, ExcludeByName.|Migriert selektiv nur Komponenten oder Komponentennamen| |[Cloud-zu-Cloud-Cmdlets](#cloud-to-cloud-cmdlets)|Backup-CvadAcToFile|Sichert die gesamte Konfiguration von Ihrer Cloud-Site.| |^^|Restore-CvadAcToSite|Stellt gesicherte YAML-Dateien auf der Cloud-Site wieder her. Diese Cloud-Site kann dieselbe oder eine andere sein als die Quell-Cloud-Site.| |^^|Remove-CvadAcFromSite|Entfernt Komponentenmitglieder aus der Cloud.| |^^|*Granulare Migration* Für Komponenten verwenden Sie Parameter mit den oben genannten Befehlen. Beispiele: MachineCatalogs, Tags. Für Komponentennamen verwenden Sie Parameter mit den oben genannten Befehlen. Beispiele: IncludeByName, ExcludeByName.|Migriert selektiv nur Komponenten oder Komponentennamen| |[Weitere grundlegende Cmdlets](#other-basic-cmdlets)|Compare-CvadAcToSite|Vergleicht die On-Premises-.yml-Dateien mit der Cloud-Konfiguration.| |[Cmdlets für Voraussetzungen](#prerequisites-related-cmdlets)|New-CvadAcCustomerInfoFile|Erstellt eine Kundeninformationsdatei.| |^^|Set-CvadAcCustomerInfoFile|Aktualisiert eine vorhandene Kundeninformationsdatei.| |[Cmdlets für Support und Fehlerbehebung](#support-and-troubleshooting-cmdlets)|New-CvadAcZipInfoForSupport|Zippt alle Protokoll- und .yml-Dateien in eine einzige Zip-Datei, um sie zur Unterstützung an Citrix® zu senden.| |^^|Get-CvadAcStatus|Wird verwendet, um die Konnektivität zu testen und sicherzustellen, dass alle Voraussetzungen erfüllt sind. Gibt Informationen über das Tool zurück, wie z. B. die Versionsnummer und die Konnektivität mit der Cloud und den Connector-Status.| |^^|Test-CvadAcConnectionWithSite|Testet die Verbindung mit der Cloud-Site.| |^^|Find-CvadAcConnector|Sucht vorhandene Connectors und bestimmt deren Ausführungsstatus.| |^^|Get-CvadAcCustomerSites|Gibt die Liste aller Kunden-Sites zurück.| |^^|New-CvadAcTemplateToFile|Erstellt eine Vorlagendatei für ausgewählte Komponenten.| |^^|Show-CvadAcDocument|Zeigt diese Dokumentation im Standardbrowser an.| |^^|Find-CvadAcInFile|Find in file durchsucht YAML-Dateien von Komponenten nach Mitgliedern, die einem oder mehreren Namen entsprechen, die Platzhalter enthalten können.| |[Cmdlets zur Site-Aktivierung](#site-activation-cmdlets)|Set-CvadAcSiteActiveStateOnPrem|Setzt den Status der On-Premises-Site auf aktiv oder inaktiv.| |^^|Set-CvadAcSiteActiveStateCloud|Setzt den Status der Cloud-Site auf aktiv oder inaktiv.| |[Cmdlets zum Zusammenführen mehrerer On-Premises-Sites](#merging-multiple-on-premises-sites-cmdlets)|New-CvadAcSiteMergingInfo|Erstellt einen Satz von Site-Merging-Präfix-/Suffix-Informationen.| |^^|Set-CvadAcSiteMergingInfo|Aktualisiert einen vorhandenen Satz von Site-Merging-Präfix-/Suffix-Informationen.| |^^|Remove-CvadAcSiteMergingInfo|Entfernt einen vorhandenen Satz von Site-Merging-Präfix-/Suffix-Informationen.|

Weitere Informationen zu Parametern und deren Verwendung finden Sie unter Granulare Migrationsparameter.

Grundlegende Cmdlets

Cmdlets für die Migration von On-Premises in die Cloud

  • Export-CvadAcToFile – Exportiert On-Premises-Dateien in YAML-Dateien.

    Exportiert die Konfiguration aus Ihrer On-Premises-Einrichtung. Dies ist der Standard-Exportvorgang für die automatisierte Konfiguration. Es werden keine Änderungen an der On-Premises-Site-Konfiguration vorgenommen. Exportierte Dateien werden im Verzeichnis %HOMEPATH%\Documents\Citrix\AutoConfig in einem eindeutig benannten Unterordner Export abgelegt. Der Ordner %HOMEPATH%\Documents\Citrix\AutoConfig enthält immer die zuletzt exportierte On-Premises-Site-Konfiguration.

    Parameter:

|Name|Beschreibung|Erforderlich?|Typ|
|---|---|---|---|
|Migrate by components|Siehe \[Migration nach Komponenten]\(#migrate-by-components)\||SwitchParameters|
|Filtering by object names|Siehe \[Filterung nach Objektnamen]\(#filtering-by-object-names)\||Liste von Strings|
|`TargetFolder`|Gibt den Zielordner für den Export an.\||String|
|`Locale`|Gibt die Sprache des exportierbaren, menschenlesbaren Textes an.\||String|
|`Quiet`|Unterdrückt die Protokollierung in der Konsole.\||SwitchParameter|
|`AdminAddress`|Gibt die DNS- oder IP-Adresse des Delivery Controllers an, wenn der Export nicht auf dem Delivery Controller ausgeführt wird.\||String|
|`CheckUserAndMachines`|Überprüft, ob Benutzer und Maschinen im Active Directory vorhanden sind. Benutzer und Maschinen, die nicht im Active Directory sind, können zu Importfehlern führen.\||`$true` oder `$false`|
|`ZipResults`|Zippt gesicherte YAML-Dateien in eine einzige Zip-Datei. Die Datei befindet sich im selben Ordner wie die gesicherten YAML-Dateien und hat denselben Namen wie der Ordner.\||SwitchParameter| <!--- table-end --->

Rückgabewert:

-  Siehe [Cmdlet-Rückgabewerte](#cmdlet-return-values)

Es gibt drei Möglichkeiten, Daten in die Cloud zu importieren. Die Ausführung spezifischer Cmdlets kann zu einer der drei Kombinationen von Aktionen auf der Cloud-Site führen:

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

| Cmdlet | Hinzufügen | Aktualisieren | Löschen | | — |— | — | — | | Import | X | X | X | | Merge | X | X | | | New | X | | |

  • Import-CvadAcToSite – Importiert YAML-Dateien in die Cloud. Unterstützt Erstellungs-, Aktualisierungs- und Löschvorgänge.

    Importiert alle On-Premises-Dateien in die Cloud. Dieser Befehl stellt sicher, dass der Endzustand der Cloud mit dem On-Premises-Zustand identisch ist. Diese Option löscht alle Änderungen, die in der Cloud vorhanden sind. Importierte Site-Konfigurationsdateien stammen aus %HOMEPATH%\Documents\Citrix\AutoConfig. Mit Vorsicht verwenden.

    Parameter:

|Name|Beschreibung|Erforderlich?|Typ|
|---|---|---|---|
|Migrate by components|Siehe \[Migration nach Komponenten]\(#migrate-by-components).\||SwitchParameters|
|Filtering by object names|Siehe \[Filterung nach Objektnamen]\(#filtering-by-object-names).\||Liste von Strings|
|Cloud-accessing parameters|Siehe \[Cloud-Zugriffsparameter]\(#cloud-accessing-parameters).\||SwitchParameters|
|`SourceFolder`|Identifiziert einen Ersatz-Stammordner für \*%HOMEPATH%\Documents\Citrix\AutoConfig\*.\||String|
|`Locale`|Gibt die Sprache des exportierbaren, menschenlesbaren Textes an.\||String|
|`Quiet`|Unterdrückt die Protokollierung in der Konsole.\||SwitchParameter|
|`DisplayLog`|Zeigt die Protokolldatei nach Abschluss des Cmdlets an. Setzen Sie auf `$false`, um die Protokollanzeige zu unterdrücken.\||`$true` oder `$false`|
|`Merge`|Wenn auf `$true` gesetzt, werden nur Komponenten zur Cloud-Site hinzugefügt. Komponenten werden nicht entfernt. Setzen Sie auf `$false`, um Komponenten zu entfernen.\||`$true` oder `$false`|
|`AddOnly`|Wenn auf `$true` gesetzt, werden nur neue Komponenten hinzugefügt, vorhandene Komponenten werden nicht aktualisiert oder gelöscht. Setzen Sie auf `$false`, um Aktualisierungen und Löschungen zuzulassen. `Merge` wird ignoriert, wenn dieser Parameter `$true` ist.\||`$true` oder `$false`|
|`MergePolicies`|Führt Richtlinieneinstellungen und Filter zusammen. Das Zusammenführen erfolgt nur, wenn eine zu importierende Richtlinie bereits im Cloud-DDC vorhanden ist. Das Ergebnis des Zusammenführens von Richtlinien ist, dass die Cloud-DDC-Richtlinien die Einstellungen und Filter enthalten, die sie bereits hatte, zusätzlich zu allen neuen Einstellungen und Filtern, die importiert werden. Beachten Sie, dass bei Kollisionen von Einstellungen und Filtern die importierten Werte Vorrang haben.\||SwitchParameter|
|`OnErrorAction`|Siehe \[OnErrorAction-Parameter]\(/de-de/citrix-daas/migrate/auto-config-troubleshoot.html#onerroraction-parameter).\||String| <!--- table-end --->

Rückgabewert:

  • Siehe Rückgabewerte des Cmdlets

  • Merge-CvadAcToSite – Importiert YAML-Dateien in die Cloud. Unterstützt Erstellungs- und Aktualisierungsvorgänge.

    Führt die lokalen Dateien mit der Cloud zusammen, löscht jedoch keine Komponenten in der Cloud oder am lokalen Standort. Dadurch bleiben bereits in der Cloud vorgenommene Änderungen erhalten. Wenn eine Komponente in Citrix Cloud mit demselben Namen existiert, kann dieser Befehl diese Komponente ändern. Dies ist der Standardimportvorgang für die automatisierte Konfiguration. Zusammengeführte Standortkonfigurationsdateien stammen aus %HOMEPATH%\Documents\Citrix\AutoConfig.

    Parameter:

|Name|Beschreibung|Erforderlich?|Typ|
|---|---|---|---|
|Migration nach Komponenten|Siehe \[Migration nach Komponenten]\(#migrate-by-components).\||SwitchParameters|
|Filterung nach Objektnamen|Siehe \[Filterung nach Objektnamen]\(#filtering-by-object-names).\||List of strings|
|Cloud-Zugriffsparameter|Siehe \[Cloud-Zugriffsparameter]\(#cloud-accessing-parameters).\||SwitchParameters|
|`SourceFolder`|Identifiziert einen Ersatz-Stammordner für \*%HOMEPATH%\Documents\Citrix\AutoConfig\*.\||String|
|`Locale`|Gibt die Sprache des exportierbaren, menschenlesbaren Textes an.\||String|
|`Quiet`|Unterdrückt die Protokollierung in der Konsole.\||SwitchParameter|
|`DisplayLog`|Zeigt die Protokolldatei nach Abschluss des Cmdlets an. Auf `$false` setzen, um die Protokollanzeige zu unterdrücken.\||`$true` oder `$false`|
|`Merge`|Wenn auf `$true` gesetzt, werden nur Komponenten zur Cloud-Site hinzugefügt. Komponenten werden nicht entfernt. Auf `$false` setzen, um Komponenten zu entfernen.\||`$true` oder `$false`|
|`AddOnly`|Wenn auf `$true` gesetzt, werden nur neue Komponenten hinzugefügt, bestehende Komponenten werden weder aktualisiert noch gelöscht. Auf `$false` setzen, um Aktualisierungen und Löschungen zuzulassen. `Merge` wird ignoriert, wenn dieser Parameter auf `$true` gesetzt ist.\||`$true` oder `$false`|
|`MergePolicies`|Führt Richtlinieneinstellungen und Filter zusammen. Das Zusammenführen erfolgt nur, wenn eine zu importierende Richtlinie bereits im Cloud-DDC existiert. Das Ergebnis des Zusammenführens von Richtlinien ist, dass die Cloud-DDC-Richtlinien die Einstellungen und Filter enthalten, die sie bereits hatte, zusätzlich zu allen neuen Einstellungen und Filtern, die importiert werden. Beachten Sie, dass bei Kollisionen von Einstellungen und Filtern die importierten Werte Vorrang haben.\||SwitchParameter|
|`OnErrorAction`|Siehe \[OnErrorAction-Parameter]\(/de-de/citrix-daas/migrate/auto-config-troubleshoot.html#onerroraction-parameter).\||String| <!--- table-end --->

Rückgabewerte:

-  Siehe [Rückgabewerte des Cmdlets](#cmdlet-return-values)

  • New-CvadAcToSite – Importiert YAML-Dateien in die Cloud. Unterstützt Erstellungs- und Aktualisierungsvorgänge.

    Importiert die lokale Standortkonfiguration in die Cloud, fügt aber nur neue Komponenten hinzu. Bestehende Cloud-Site-Komponenten werden weder aktualisiert noch gelöscht. Verwenden Sie diesen Befehl, wenn Ihre bestehenden Cloud-Site-Komponenten unverändert bleiben müssen.

    Parameter:

|Name|Beschreibung|Erforderlich?|Typ|
|---|---|---|---|
|Migration nach Komponenten|Siehe \[Migration nach Komponenten]\(#migrate-by-components).\||SwitchParameters|
|Filterung nach Objektnamen|Siehe \[Filterung nach Objektnamen]\(#filtering-by-object-names).\||List of strings|
|Cloud-Zugriffsparameter|Siehe \[Cloud-Zugriffsparameter]\(#cloud-accessing-parameters).\||SwitchParameters|
|`SourceFolder`|Identifiziert einen Ersatz-Stammordner für \*%HOMEPATH%\Documents\Citrix\AutoConfig\*.\||String|
|`Locale`|Gibt die Sprache des exportierbaren, menschenlesbaren Textes an.\||String|
|`Quiet`|Unterdrückt die Protokollierung in der Konsole.\||SwitchParameter|
|`DisplayLog`|Zeigt die Protokolldatei nach Abschluss des Cmdlets an. Auf `$false` setzen, um die Protokollanzeige zu unterdrücken.\||`$true` oder `$false`|
|`OnErrorAction`|Siehe \[OnErrorAction-Parameter]\(/de-de/citrix-daas/migrate/auto-config-troubleshoot.html#onerroraction-parameter).\||String| <!--- table-end --->

Rückgabewerte:

-  Siehe [Rückgabewerte des Cmdlets](#cmdlet-return-values)

  • Sync-CvadAcToSite – Export und Import in einem Schritt.

    Sync führt sowohl einen Export als auch einen Import in einem Schritt durch. Verwenden Sie den Parameter SourceTargetFolder, um den Zielordner für Export/Import anzugeben.

    Parameter:

|Name|Beschreibung|Erforderlich?|Typ|
|---|---|---|---|
|Migration nach Komponenten|Siehe \[Migration nach Komponenten]\(#migrate-by-components)\||SwitchParameters|
|Filterung nach Objektnamen|Siehe \[Filterung nach Objektnamen]\(#filtering-by-object-names)\||List of strings|
|Cloud-Zugriffsparameter|Siehe \[Cloud-Zugriffsparameter]\(#cloud-accessing-parameters)\||SwitchParameters|
|`SourceTargetFolder`|Gibt den Zielordner für Export/Import an.\||String|
|`Locale`|Gibt die Sprache des exportierbaren, menschenlesbaren Textes an.\||String|
|`AdminAddress`|Gibt die DNS- oder IP-Adresse des Delivery Controllers an, wenn der Export nicht auf dem Delivery Controller ausgeführt wird.\||String|
|`Quiet`|Unterdrückt die Protokollierung in der Konsole.\||SwitchParameter|
|`DisplayLog`|Zeigt die Protokolldatei nach Abschluss des Cmdlets an. Auf `$false` setzen, um die Protokollanzeige zu unterdrücken.\||`$true` oder `$false`|
|`Merge`|Wenn auf `$true` gesetzt, werden nur Komponenten zur Cloud-Site hinzugefügt. Komponenten werden nicht entfernt. Auf `$false` setzen, um Komponenten zu entfernen.\||`$true` oder `$false`|
|`AddOnly`|Wenn auf `$true` gesetzt, werden nur neue Komponenten hinzugefügt, bestehende Komponenten werden weder aktualisiert noch gelöscht. Auf `$false` setzen, um Aktualisierungen und Löschungen zuzulassen. `Merge` wird ignoriert, wenn dieser Parameter auf `$true` gesetzt ist.\||`$true` oder `$false`|
|`MergePolicies`|Führt Richtlinieneinstellungen und Filter zusammen. Das Zusammenführen erfolgt nur, wenn eine zu importierende Richtlinie bereits im Cloud-DDC existiert. Das Ergebnis des Zusammenführens von Richtlinien ist, dass die Cloud-DDC-Richtlinien die Einstellungen und Filter enthalten, die sie bereits hatte, zusätzlich zu allen neuen Einstellungen und Filtern, die importiert werden. Beachten Sie, dass bei Kollisionen von Einstellungen und Filtern die importierten Werte Vorrang haben.\||SwitchParameter| <!--- table-end --->

Rückgabewerte:

-  Siehe [Rückgabewerte des Cmdlets](#cmdlet-return-values)

Cloud-zu-Cloud-Cmdlets

  • Backup-CvadAcToFile – Sichert die gesamte Konfiguration Ihrer Cloud-Site.

    Exportiert Ihre Cloud-Konfiguration in .yml-Dateien. Dieses Backup kann in einem Backup- und Wiederherstellungsprozess verwendet werden, um verlorene Komponenten wiederherzustellen.

    Parameter:

|Name|Beschreibung|Erforderlich?|Typ|
|---|---|---|---|
|Migration nach Komponenten|Siehe \[Migration nach Komponenten]\(#migrate-by-components)\||SwitchParameters|
|Cloud-Zugriffsparameter|Siehe \[Cloud-Zugriffsparameter]\(#cloud-accessing-parameters)\||SwitchParameters|
|`TargetFolder`|Gibt den Exportzielordner an.\||String|
|`Locale`|Gibt die Sprache des exportierbaren, menschenlesbaren Textes an.\||String|
|`Quiet`|Unterdrückt die Protokollierung in der Konsole.\||SwitchParameter|
|`DisplayLog`|Zeigt die Protokolldatei nach Abschluss des Cmdlets an. Auf `$false` setzen, um die Protokollanzeige zu unterdrücken.\||`$true` oder `$false`|
|`ZipResults`|Komprimiert gesicherte YAML-Dateien in eine einzelne ZIP-Datei. Die Datei befindet sich im selben Ordner wie die gesicherten YAML-Dateien und hat denselben Namen wie der Ordner.\||SwitchParameter| <!--- table-end --->

Gibt zurück:

-  Siehe [Cmdlet-Rückgabewerte](#cmdlet-return-values)

  • Restore-CvadAcToSite – Stellt Sicherungs-YAML-Dateien auf der Cloud-Site wieder her. Diese Cloud-Site kann dieselbe oder eine andere als die Quell-Cloud-Site sein.

    Stellt die Cloud-Site auf die vorherige Konfiguration zurück. Importierte Dateien werden aus dem Ordner bezogen, der mit dem Parameter -RestoreFolder angegeben wird, welcher den Ordner mit den .yml-Dateien identifiziert, die auf die Cloud-Site wiederhergestellt werden sollen. Dies muss eine vollständig qualifizierte Ordnerspezifikation sein. Dieses Cmdlet kann verwendet werden, um zu Ihrer vorherigen Konfiguration zurückzukehren oder um Ihre Cloud-Site zu sichern und wiederherzustellen. Dieser Befehl kann Ihre Cloud-Site hinzufügen, löschen und aktualisieren.

    Parameter:

| Name | Beschreibung | Erforderlich? | Typ |
|----|----|----|----|
| Migration nach Komponenten | Siehe \[Migration nach Komponenten]\(#migrate-by-components). | | SwitchParameters |
| Filtern nach Objektnamen | Siehe \[Filtern nach Objektnamen]\(#filtering-by-object-names). | | Liste von Zeichenfolgen |
| Parameter für den Cloud-Zugriff | Siehe \[Parameter für den Cloud-Zugriff]\(#cloud-accessing-parameters). | | SwitchParameters |
| `RestoreFolder` | Identifiziert den Ordner, der die .yml-Dateien enthält, die auf die Cloud-Site wiederhergestellt werden sollen. Dies muss eine vollständig qualifizierte Ordnerspezifikation sein. | | String |
| `Locale` | Gibt die Sprache des exportierbaren, menschenlesbaren Textes an. | | String |
| `Quiet` | Unterdrückt die Protokollierung in der Konsole. | | SwitchParameter |
| `DisplayLog` | Zeigt die Protokolldatei nach Abschluss des Cmdlets an. Auf `$false` setzen, um die Protokollanzeige zu unterdrücken. | | `$true` oder `$false` |
| `Merge` | Wenn auf `$true` gesetzt, werden nur Komponenten zur Cloud-Site hinzugefügt. Komponenten werden nicht entfernt. Auf `$false` setzen, um Komponenten zu entfernen. | | `$true` oder `$false` |
| `AddOnly` | Wenn auf `$true` gesetzt, werden nur neue Komponenten hinzugefügt, vorhandene Komponenten werden nicht aktualisiert oder gelöscht. Auf `$false` setzen, um Aktualisierungen und Löschungen zuzulassen. `Merge` wird ignoriert, wenn dieser Parameter auf `$true` gesetzt ist. | | `$true` oder `$false` |
| `MergePolicies` | Richtlinieneinstellungen und Filter zusammenführen. Das Zusammenführen erfolgt nur, wenn eine importierte Richtlinie bereits im Cloud-DDC vorhanden ist. Das Ergebnis des Zusammenführens von Richtlinien ist, dass die Cloud-DDC-Richtlinien die Einstellungen und Filter enthalten, die sie bereits hatten, zusätzlich zu allen neuen Einstellungen und Filtern, die importiert werden. Beachten Sie, dass bei Kollisionen von Einstellungen und Filtern die importierten Werte Vorrang haben. | | SwitchParameter |
| `OnErrorAction` | Siehe \[OnErrorAction-Parameter]\(/de-de/citrix-daas/migrate/auto-config-troubleshoot.html#onerroraction-parameter). | | String | <!--- table-end --->

Gibt zurück:

-  Siehe [Cmdlet-Rückgabewerte](#cmdlet-return-values)

  • Remove-CvadAcFromSite – Entfernt Komponentenmitglieder aus der Cloud.

    Kann die gesamte Site zurücksetzen oder Mitgliedselemente aus einer Komponente entfernen (z. B. das Entfernen eines Maschinenkatalogs aus der Liste der Kataloge). Dies kann in Verbindung mit dem Parameter IncludeByName verwendet werden, um bestimmte Mitglieder selektiv zu entfernen.

    Parameter:

| Name | Beschreibung | Erforderlich? | Typ |
|----|----|----|----|
| Migration nach Komponenten | Siehe \[Migration nach Komponenten]\(#migrate-by-components) | | SwitchParameters |
| Filtern nach Objektnamen | Siehe \[Filtern nach Objektnamen]\(#filtering-by-object-names) | | Liste von Zeichenfolgen |
| Parameter für den Cloud-Zugriff | Siehe \[Parameter für den Cloud-Zugriff]\(#cloud-accessing-parameters) | | SwitchParameters |
| `Quiet` | Unterdrückt die Protokollierung in der Konsole. | | SwitchParameter |
| `DisplayLog` | Zeigt die Protokolldatei nach Abschluss des Cmdlets an. Auf `$false` setzen, um die Protokollanzeige zu unterdrücken. | | `$true` oder `$false` | <!--- table-end --->

Gibt zurück:

-  Siehe [Cmdlet-Rückgabewerte](#cmdlet-return-values)

Weitere grundlegende Cmdlets

  • Compare-CvadAcToSite – Vergleicht die lokalen .yml-Dateien mit der Cloud-Konfiguration und erstellt einen Bericht über Änderungen, die durch ein Import-, Merge- oder Restore-Cmdlet vorgenommen wurden.

    Parameter:

| Name | Beschreibung | Erforderlich? | Typ |
|----|----|----|----|
| Migration nach Komponenten | Siehe \[Migration nach Komponenten]\(#migrate-by-components). | | SwitchParameters |
| Filtern nach Objektnamen | Siehe \[Filtern nach Objektnamen]\(#filtering-by-object-names). | | Liste von Zeichenfolgen |
| Parameter für den Cloud-Zugriff | Siehe \[Parameter für den Cloud-Zugriff]\(#cloud-accessing-parameters). | | SwitchParameters |
| `SourceFolder` | Identifiziert einen Ersatz-Stammordner für \*%HOMEPATH%\Documents\Citrix\AutoConfig\*. | | String |
| `Locale` | Gibt die Sprache des exportierbaren, menschenlesbaren Textes an. | | String |
| `Quiet` | Unterdrückt die Protokollierung in der Konsole. | | SwitchParameter |
| `DisplayLog` | Zeigt die Protokolldatei nach Abschluss des Cmdlets an. Auf `$false` setzen, um die Protokollanzeige zu unterdrücken. | | `$true` oder `$false` |
| `Merge` | Wenn auf `$true` gesetzt, werden nur Komponenten zur Cloud-Site hinzugefügt. Komponenten werden nicht entfernt. Auf `$false` setzen, um Komponenten zu entfernen. | | `$true` oder `$false` |
| `AddOnly` | Wenn auf `$true` gesetzt, werden nur neue Komponenten hinzugefügt, vorhandene Komponenten werden nicht aktualisiert oder gelöscht. Auf `$false` setzen, um Aktualisierungen und Löschungen zuzulassen. `Merge` wird ignoriert, wenn dieser Parameter auf `$true` gesetzt ist. | | `$true` oder `$false` |
| `OnErrorAction` | Siehe \[OnErrorAction-Parameter]\(/de-de/citrix-daas/migrate/auto-config-troubleshoot.html#onerroraction-parameter). | | String | <!--- table-end --->

Gibt zurück:

-  Siehe [Cmdlet-Rückgabewerte](#cmdlet-return-values)

Granulare Migrationsparameter

Migration nach Komponenten

Die folgenden Komponenten können mit den sie unterstützenden Cmdlets angegeben werden. Die Option All wird automatisch ausgewählt, wenn keine Komponentenparameter angegeben werden. Um Fehler zu vermeiden, empfehlen wir, Komponenten in der folgenden Reihenfolge zu migrieren:

  • All
  • Tags
  • AdminRoles
  • AdminScopes
  • HostConnections
  • MachineCatalogs
  • StoreFronts
  • DeliveryGroups
  • ApplicationGroups
  • ApplicationFolders
  • Applications
  • GroupPolicies
  • UserZonePreference

Filtern nach Objektnamen

Migration nach Komponentennamen

Die Parameter IncludeByName und ExcludeByName ermöglichen das Ein- und Ausschließen von Komponentenmitgliedern in Cmdlets nach Namen. Es kann jeweils nur eine Komponente (z. B. Bereitstellungsgruppen) in einem der unterstützten Cmdlets ausgewählt werden. Befindet sich ein Komponentenmitglied in beiden Bereichen, überschreibt der Ausschluss jeden anderen Parameter, und ein Eintrag wird in der Log-Fixup-Liste vorgenommen, der die ausgeschlossene Komponente und den Mitgliedsnamen identifiziert.

IncludeByName und ExcludeByName akzeptieren eine Liste von Komponentennamen. Jeder Name kann ein oder mehrere Platzhalterzeichen enthalten. Es werden zwei Arten von Platzhalterzeichen unterstützt. Die Liste der Komponentennamen muss in einfache Anführungszeichen eingeschlossen werden, wenn ein Mitgliedsname Sonderzeichen enthält.

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

IncludeByName und ExcludeByName können auch eine Datei akzeptieren, die eine Liste von Mitgliedern enthält, wobei jedes Mitglied explizit sein oder Platzhalterzeichen enthalten kann. Jede Zeile in der Datei kann ein Mitglied enthalten. Führende und nachgestellte Leerzeichen werden vom Mitgliedsnamen entfernt. Der Dateiname muss dem Zeichen @ vorangestellt und von einfachen Anführungszeichen umschlossen sein (eine PowerShell-Anforderung, damit das @ nicht neu interpretiert wird). Es können mehrere Dateien zusätzlich zu einer Mischung mit Mitgliedsnamen aufgeführt werden.

Ein Beispiel für das Zusammenführen aller Bereitstellungsgruppen, deren Namen mit DgSite1 beginnen und Home2 enthalten, wäre:

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

Nach Bereitstellungsgruppenname

ByDeliveryGroupName filtert nach dem Namen der Bereitstellungsgruppe für Anwendungen und Anwendungsgruppen. Dieser Parameter ist immer eine Inclusionsliste, die Mitglieder identifiziert, die basierend auf ihrer Bereitstellungsgruppen-Zuordnung eingeschlossen werden sollen.

ByDeliveryGroupName akzeptiert eine Liste von Bereitstellungsgruppennamen. Jeder Name kann ein oder mehrere Platzhalterzeichen enthalten. Es werden zwei Arten von Platzhalterzeichen unterstützt.

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

Das folgende Beispiel führt alle Anwendungen zusammen, die auf alle Bereitstellungsgruppennamen verweisen, die mit EastDg beginnen.

Merge-CvadAcToSite –Applications –ByDeliveryGroupName EastDg*

Deaktivierte ausschließen

ExcludeDisabled filtert bei Importvorgängen alle deaktivierten Anwendungen und Anwendungsgruppen heraus. ExcludeDisabled ist standardmäßig auf false gesetzt, was bedeutet, dass alle Anwendungen und Anwendungsgruppen unabhängig von ihrem Aktivierungsstatus importiert werden.

Nach Maschinenname

ByMachineName filtert nach dem Maschinennamen für Maschinenkataloge und Bereitstellungsgruppen. Dieser Parameter ist immer eine Inclusionsliste, die Mitglieder identifiziert, die basierend auf ihrer Maschinennamen-Zuordnung eingeschlossen werden sollen.

ByMachineName akzeptiert eine Liste von Maschinennamen, wobei jeder Name ein oder mehrere Platzhalterzeichen enthalten kann. Es werden zwei Arten von Platzhalterzeichen unterstützt.

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

Wenn beim Exportieren oder Importieren ByMachineName verwendet wird und ein Maschinenname-Filter dazu führt, dass keine Maschinen im Maschinenkatalog oder in der Bereitstellungsgruppe gefunden werden, wird der Maschinenkatalog oder die Bereitstellungsgruppe vom Export oder Import ausgeschlossen.

Hinweis:

Die Verwendung von ByMachineName in einem Cmdlet vom Importtyp führt dazu, dass MergeMachines auf $true gesetzt wird.

Maschinen zusammenführen

MergeMachines weist, wenn auf $true gesetzt, den Importvorgang an, Maschinen nur zum Maschinenkatalog oder zur Bereitstellungsgruppe hinzuzufügen. Maschinen werden nicht entfernt, was inkrementelle additive Operationen ermöglicht.

MergeMachines ist standardmäßig auf false gesetzt, was bedeutet, dass Maschinen entfernt werden, wenn sie nicht im Maschinenkatalog oder in der .yml-Datei der Bereitstellungsgruppe vorhanden sind. MergeMachines wird auf $true gesetzt, wenn ByMachineName verwendet wird, kann aber durch Setzen von MergeMachines auf false überschrieben werden.

Cmdlets für Voraussetzungen

  • New-CvadAcCustomerInfoFile – Erstellt eine Kundeninformationsdatei. Standardmäßig befindet sich die Kundeninformationsdatei unter %HOMEPATH%\Documents\Citrix\AutoConfig.

    Parameter:

|Name|Beschreibung|Erforderlich?|Typ|
|---|---|--|--|
|`CustomerId`|Kunden-ID.|x|String|
|`ClientId`|Kunden-Client-ID, die in Citrix Cloud erstellt wurde. Die CustomerId und der Secret müssen bei Verwendung dieses Parameters angegeben werden.|Bedingt|String|
|`Secret`|Geheimer Kundenschlüssel, der in Citrix Cloud erstellt wurde. Die CustomerId und ClientId müssen bei Verwendung dieses Parameters angegeben werden.|Bedingt|String|
|`Environment`|Produktions-, ProductionGov- oder ProductionJP-Umgebung.\||Enumeration|
|`LogFileName`|Ändert das Protokolldateipräfix von CitrixLog in etwas anderes.\||String|
|`AltRootUrl`|Nur auf Anweisung von Citrix verwenden.\||String|
|`StopOnError`|Stoppt den Vorgang beim ersten Fehler.\||`$true` oder `$false`|
|`TargetFolder`|Verwendet den angegebenen Ordner als Stammordner anstelle von \*%HOMEPATH%\Documents\Citrix\AutoConfig\*.\||String|
|`Locale`|Verwendet das angegebene Gebietsschema anstelle des vom System abgeleiteten Gebietsschemas, auf dem das Tool ausgeführt wird.\||String|
|`Editor`|Verwendet den angegebenen Editor, um das Protokoll nach Abschluss jedes Cmdlets anzuzeigen. Notepad.exe ist der Standardeditor. Dieser Parameter muss die vollständig qualifizierte Dateispezifikation für den Editor enthalten, und der Editor muss die Protokolldateispezifikation als einzigen Parameter akzeptieren.\||String|
|`SecurityCsvFileSpec`|Die vollständig qualifizierte Dateispezifikation, die auf die von Citrix Identity and Access Management heruntergeladene Datei SecurityClient.csv verweist. Die CustomerId muss bei Verwendung dieses Parameters angegeben werden.\||String|

Rückgabe:

-  Siehe [Cmdlet-Rückgabewerte](#cmdlet-return-values)

  • Set-CvadAcCustomerInfoFile – Aktualisiert eine vorhandene Kundeninformationsdatei. Es werden nur die im Cmdlet angegebenen Parameter geändert. Alle nicht angegebenen Parameterwerte in der Datei CustomerInfo.yml bleiben unverändert.

    Parameter:

    Name Beschreibung Erforderlich? Typ
    CustomerId Kunden-ID. String
    ClientId Kunden-Client-ID, die in Citrix Cloud erstellt wurde. String
    Secret Geheimer Kundenschlüssel, der in Citrix Cloud erstellt wurde. String
    Environment Produktions-, ProductionGov- oder ProductionJP-Umgebung. Enumeration
    LogFileName Ändert das Protokolldateipräfix von CitrixLog in etwas anderes. String
    StopOnError Stoppt den Vorgang beim ersten Fehler. $true oder $false
    TargetFolder Verwendet den angegebenen Ordner als Stammordner anstelle von %HOMEPATH%\Documents\Citrix\AutoConfig. String
    Locale Verwendet das angegebene Gebietsschema anstelle des vom System abgeleiteten Gebietsschemas, auf dem das Tool ausgeführt wird. String
    Editor Verwendet den angegebenen Editor, um das Protokoll nach Abschluss jedes Cmdlets anzuzeigen. Notepad.exe ist der Standardeditor. Dieser Parameter muss die vollständig qualifizierte Dateispezifikation für den Editor enthalten, und der Editor muss die Protokolldateispezifikation als einzigen Parameter akzeptieren. String
    SecurityCsvFileSpec Die vollständig qualifizierte Dateispezifikation, die auf die von Citrix Identity and Access Management heruntergeladene Datei SecurityClient.csv verweist. Die CustomerId muss bei Verwendung dieses Parameters angegeben werden. String

    Rückgabe:

Voraussetzungsbezogene Parameter

Zusätzlich zu den Cloud-Zugriffsparametern können die folgenden Parameter mit den voraussetzungsbezogenen Cmdlets verwendet werden:

  • Environment – Produktions- oder ProductionGov-Umgebung.
  • LogFileName – Ändert das Protokolldateipräfix von CitrixLog in etwas anderes.
  • StopOnError – Stoppt den Vorgang beim ersten Fehler.
  • AlternateRootFolder – Verwendet den angegebenen Ordner als Stammordner anstelle von %HOMEPATH%\Documents\Citrix\AutoConfig.
  • Locale – Verwendet das angegebene Gebietsschema anstelle des vom System abgeleiteten Gebietsschemas, auf dem das Tool ausgeführt wird.
  • Editor – Verwendet den angegebenen Editor, um das Protokoll nach Abschluss jedes Cmdlets anzuzeigen. Notepad.exe ist der Standardeditor. Dieser Parameter muss die vollständig qualifizierte Dateispezifikation für den Editor enthalten, und der Editor muss die Protokolldateispezifikation als einzigen Parameter akzeptieren.

Cmdlets für Support und Fehlerbehebung

  • New-CvadAcZipInfoForSupport – Zippt alle Protokoll- und .yml-Dateien in einer einzigen Zip-Datei, um sie zur Unterstützung an Citrix zu senden. Kundenbezogene sensible Informationen (CustomerInfo.yml und CvadAcSecurity.yml) sind nicht in der Zip-Datei enthalten. Die Datei Icon.yml wird aufgrund ihrer Größe ebenfalls ausgeschlossen. Die Zip-Datei wird unter %HOMEPATH%\Documents\Citrix\AutoConfig abgelegt und erhält den Namen CvadAcSupport_yyyy_mm_dd_hh_mm_ss.zip, basierend auf Datum und Zeitstempel. Diese Zip-Datei kann auch als Sicherung dienen.

    Parameter:

    Name Beschreibung Erforderlich? Typ
    TargetFolder Gibt einen Zielordner an, in dem die Zip-Datei erstellt und gespeichert werden soll. String
    Quiet Unterdrückt die Protokollierung in der Konsole. SwitchParameter

    Rückgabe:

    • Die Zip-Datei mit Dateinamen und Speicherort wird in der Eingabeaufforderung angezeigt.

  • Get-CvadAcStatus – Wird verwendet, um die Konnektivität zu testen und sicherzustellen, dass alle Voraussetzungen erfüllt sind. Gibt Informationen über das Tool zurück, wie z. B. Versionsnummer und Konnektivität mit der Cloud sowie den Connector-Status.

    Parameter:

    Name Beschreibung Erforderlich? Typ
    Cloud-Zugriffsparameter Siehe Cloud-Zugriffsparameter SwitchParameters
    SiteId Identifiziert die Site, mit der eine Verbindung hergestellt werden soll. String
    AdminAddress Dies ist die DNS- oder IP-Adresse des lokalen Delivery Controllers, die zur Überprüfung der Zugriffsebene der Administratoren verwendet wird. Dies ist erforderlich, wenn das Tool nicht auf einem Delivery Controller ausgeführt wird. String

Rückgabe:

-  Zeigt die Ergebnisse für jedes Element an.

  • Test-CvadAcConnectionWithSite – Testet die Verbindung mit der Cloud-Site, um zu überprüfen, ob die Kommunikationsverbindung funktioniert. Dieses Cmdlet verwendet die Cloud-Zugriffsparameter oder die Datei CustomerInfo.yml, um die Kundenverbindungsinformationen anzugeben.

    Parameter:

    Name Beschreibung Erforderlich? Typ
    Cloud-Zugriffsparameter Siehe Cloud-Zugriffsparameter SwitchParameters
    Quiet Unterdrückt die Protokollierung in der Konsole. SwitchParameter

    Rückgabe:

    • Testergebnisse werden in der Befehlszeile angezeigt.

  • Find-CvadAcConnector - Sucht vorhandene Konnektoren und bestimmt deren Ausführungsstatus. Dieses Cmdlet verwendet Informationen aus der Datei CustomerInfo.yml oder den Kunden-ID-Parameter, um die Konnektoren des Kunden zu finden.

    Parameter:

    Name Beschreibung Erforderlich? Typ
    CustomerInfoFileSpec Die Dateispezifikation, die auf eine Kundeninformationsdatei verweist, um den Standardspeicherort und -namen zu überschreiben. Dieser Parameter wird ignoriert, wenn der Parameter CustomerId angegeben wird. String
    CustomerId Die Kunden-ID. Dieser Parameter überschreibt denselben Wert in der Datei CustomerInfo.yml. String

    Rückgabe:

    • Die Ergebnisse werden in der Befehlszeile angezeigt.

  • Get-CvadAcCustomerSites - Gibt die Liste aller Kunden-Sites zurück. Dieses Cmdlet verwendet die Cloud-Zugriffsparameter oder die Datei CustomerInfo.yml, um die Kundenverbindungsinformationen anzugeben.

    Parameter:

    Rückgabe:

    • Zeigt eine Liste der gefundenen Kunden-Site-IDs an.

  • New-CvadAcTemplateToFile – Erstellt eine Vorlagendatei für ausgewählte Komponenten, sodass Sie manuell eine Importdatei erstellen können.

    Parameter:

    Name Beschreibung Erforderlich? Typ
    – – –
    Nach Komponenten migrieren Siehe Nach Komponenten migrieren SwitchParameters
    TargetFolder Gibt den Exportzielordner an. String

    Rückgabe:

  • Show-CvadAcDocument - Zeigt diese Dokumentation im Standardbrowser an.

    Parameter:

  • Keine.

Rückgabe:

  • Zeigt diese Webseite im Standard-Webbrowser an.

  • Find-CvadAcInFile – Die Dateisuche durchsucht YAML-Komponentendateien nach Membern, die einem oder mehreren Namen entsprechen, die Platzhalter enthalten können. Das Ergebnis ist ein Bericht der gefundenen Member. Die Dateisuche kann jeweils nur eine Komponente durchsuchen. Die Dateisuche durchsucht alle YAML-Dateien im aktuellen Ordner und in allen Unterordnern. Verwenden Sie FindSourceFolder, um die Anzahl der zu durchsuchenden Dateien zu begrenzen.

    Parameter:

    Name Beschreibung Erforderlich? Typ
    Komponentenweise migrieren Siehe Komponentenweise migrieren. Hinweis: Der Wert -All ist nicht gültig. SwitchParameters
    IncludeByName Eine Liste, die die Namen der Bereitstellungsgruppen angibt, die beim Festlegen des aktiven Status der Site auf “aktiv” eingeschlossen werden sollen. Die Platzhalter „*“ und „?“ werden in Namen unterstützt. Liste von Zeichenfolgen
    Unique Meldet nur eindeutig gefundene Member. SwitchParameter
    IncludeYaml Schließt die memberspezifische YAML ein. SwitchParameter
    FindSourceFolder Der Ordner, in dem die Suche beginnt. String
    DisplayLog Zeigt die Protokolldatei nach Abschluss des Cmdlets an. Auf $false setzen, um die Protokollanzeige zu unterdrücken. SwitchParameter
    Quiet Unterdrückt die Protokollierung in der Konsole. SwitchParameter

    Rückgabe:

    • Erstellt einen Bericht mit gefundenen Membern für die angegebene Komponente.

Cmdlets zur Site-Aktivierung

Weitere Informationen zur Aktivierung von Sites und zur Verwendung dieser Cmdlets finden Sie unter Sites aktivieren.

  • Set-CvadAcSiteActiveStateOnPrem – Legt den Status der lokalen Site auf „aktiv“ oder „inaktiv“ fest.

    Parameter:

    Name Beschreibung Erforderlich? Typ
    Cloud-Zugriffsparameter Siehe Cloud-Zugriffsparameter SwitchParameters
    SiteActive Wenn vorhanden, wird die lokale Site auf „aktiv“ gesetzt, wodurch der Wartungsmodus von allen Bereitstellungsgruppen entfernt wird. Wenn dieser Parameter nicht vorhanden ist, wird der Wartungsmodus für alle Bereitstellungsgruppen festgelegt. SwitchParameter
    IncludeByName Eine Liste, die die Namen der Bereitstellungsgruppen angibt, die beim Festlegen des aktiven Status der Site auf “aktiv” eingeschlossen werden sollen. Die Platzhalter „*“ und „?“ werden in Namen unterstützt. Liste von Zeichenfolgen
    ExcludeByName Eine Liste, die die Namen der Bereitstellungsgruppen angibt, die beim Festlegen des aktiven Status der Site auf “aktiv” ausgeschlossen werden sollen. Die Platzhalter „*“ und „?“ werden in Namen unterstützt. Liste von Zeichenfolgen
    Quiet Unterdrückt die Protokollierung in der Konsole. SwitchParameter
    DisplayLog Zeigt die Protokolldatei nach Abschluss des Cmdlets an. Auf $false setzen, um die Protokollanzeige zu unterdrücken. $true oder $false

    Rückgabe:

  • Set-CvadAcSiteActiveStateCloud – Legt den Status der Cloud-Site auf „aktiv“ oder „inaktiv“ fest.

    Parameter:

    Name Beschreibung Erforderlich? Typ
    Cloud-Zugriffsparameter Siehe Cloud-Zugriffsparameter SwitchParameters
    SiteActive Wenn vorhanden, wird die Cloud-Site auf „aktiv“ gesetzt, wodurch der Wartungsmodus von allen Bereitstellungsgruppen entfernt wird. Wenn dieser Parameter nicht vorhanden ist, wird der Wartungsmodus für alle Bereitstellungsgruppen festgelegt. SwitchParameter
    IncludeByName Eine Liste, die die Namen der Bereitstellungsgruppen angibt, die beim Festlegen des aktiven Status der Site auf “aktiv” eingeschlossen werden sollen. Die Platzhalter „*“ und „?“ werden in Namen unterstützt. Liste von Zeichenfolgen
    ExcludeByName Eine Liste, die die Namen der Bereitstellungsgruppen angibt, die beim Festlegen des aktiven Status der Site auf “aktiv” ausgeschlossen werden sollen. Die Platzhalter „*“ und „?“ werden in Namen unterstützt. Liste von Zeichenfolgen
    Quiet Unterdrückt die Protokollierung in der Konsole. SwitchParameter
    DisplayLog Zeigt die Protokolldatei nach Abschluss des Cmdlets an. Auf $false setzen, um die Protokollanzeige zu unterdrücken. $true oder $false

    Rückgabe:

Cmdlets zum Zusammenführen mehrerer lokaler Sites

Weitere Informationen zum Zusammenführen von Sites und zur Verwendung dieser Cmdlets finden Sie unter Mehrere Sites zu einer einzigen Site zusammenführen.

  • New-CvadAcSiteMergingInfo – Erstellt einen Informationssatz für Site-Zusammenführungs-Präfixe/-Suffixe. Es ist nicht erforderlich, alle Präfixe oder Suffixe von Anfang an zu kennen. Sie können mit Set-CvadAcSiteMergingInfo oder durch manuelles Bearbeiten der Datei SiteMerging.yml aktualisiert werden. Parameter:

    Name Beschreibung Erforderlich? Typ
    SiteName Der Name, der zur Identifizierung des Satzes von Präfixen/Suffixen für eine bestimmte Site verwendet wird. Er kann mit dem Namen der tatsächlichen Site übereinstimmen, muss es aber nicht. x String
    Parameter zum Zusammenführen von Sites Siehe Parameter zum Zusammenführen von Sites SwitchParameters
    Quiet Unterdrückt die Protokollierung in der Konsole. SwitchParameter

    Rückgabe:

  • Keine

  • Set-CvadAcSiteMergingInfo – Aktualisiert einen bestehenden Satz von Präfix-/Suffix-Informationen für die Site-Zusammenführung.

    Parameter:

    Name Beschreibung Erforderlich? Typ
    SiteName Der Name, der zur Identifizierung des Satzes von Präfixen/Suffixen für eine bestimmte Site verwendet wird. Er kann mit dem Namen der tatsächlichen Site übereinstimmen, muss es aber nicht. x String
    Parameter für die Site-Zusammenführung Siehe Parameter für die Site-Zusammenführung SwitchParameters
    Quiet Unterdrückt die Protokollierung in der Konsole. SwitchParameter

    Rückgabe:

    • Keine

  • Remove-CvadAcSiteMergingInfo – Entfernt einen bestehenden Satz von Präfix-/Suffix-Informationen für die Site-Zusammenführung.

    Parameter:

    • SiteName – identifiziert den Satz von Site-Präfixen und -Suffixen. Dies ist ein String und ist erforderlich.

    Rückgabe:

    • Keine

Parameter für die Site-Zusammenführung

Die folgenden Parameter können bei der Ausführung der Cmdlets zur Site-Zusammenführung verwendet werden. Alle aufgeführten Parameter sind Strings.

  • SiteName – der Name, der zur Identifizierung des Satzes von Präfixen/Suffixen für eine bestimmte Site verwendet wird. Er kann mit dem Namen der tatsächlichen Site übereinstimmen, muss es aber nicht. SiteName ist ein erforderlicher Parameter.
  • AdminScopedPrefix – das Präfix, das auf Administratorbereiche angewendet werden soll.
  • ApplicationPrefix – das Präfix, das auf Anwendungen angewendet werden soll.
  • ApplicationFolderPrefix – das Präfix, das auf Anwendungsordner angewendet werden soll; ApplicationFolderPrefix kann mit ApplicationFolderRoot kombiniert werden.
  • ApplicationFolderRoot – der neue Stammordner für Anwendungsordner. Dies erstellt eine zusätzliche Ordnerhierarchie. ApplicationFolderRoot kann mit ApplicationFolderPrefix kombiniert werden.
  • ApplicationGroupPrefix – das Präfix für Anwendungsgruppen.
  • ApplicationUserPrefix – das Präfix, das auf den Anwendungsnamen angewendet werden soll, den der Benutzer sieht.
  • ApplicationAdminPrefix – das Präfix, das auf den Anwendungsnamen angewendet werden soll, den der Administrator sieht.
  • DeliveryGroupPrefix – das Präfix, das auf Bereitstellungsgruppen angewendet werden soll.
  • GroupPolicyPrefix – das Präfix, das auf Richtliniennamen angewendet werden soll.
  • HostConnectionPrefix – das Präfix, das auf Hostverbindungen angewendet werden soll.
  • MachineCatalogPrefix – das Präfix, das auf Maschinenkataloge angewendet werden soll.
  • StoreFrontPrefix – das Präfix, das auf StoreFront™-Namen angewendet werden soll.
  • TagPrefix – das Präfix, das auf Tags angewendet werden soll.
  • AdminScopedSuffix – das Suffix, das auf Administratorbereiche angewendet werden soll.
  • ApplicationSuffix – das Suffix, das auf Anwendungen angewendet werden soll.
  • ApplicationFolderSuffix – das Suffix, das auf Anwendungsordner angewendet werden soll; ApplicationFolderSuffix kann mit ApplicationFolderRoot kombiniert werden.
  • ApplicationGroupSuffix – das Suffix für Anwendungsgruppen.
  • ApplicationUserSuffix – das Suffix, das auf den Anwendungsnamen angewendet werden soll, den der Benutzer sieht.
  • ApplicationAdminSuffix – das Suffix, das auf den Anwendungsnamen angewendet werden soll, den der Administrator sieht.
  • DeliveryGroupSuffix – das Suffix, das auf Bereitstellungsgruppen angewendet werden soll.
  • GroupPolicySuffix – das Suffix, das auf Richtliniennamen angewendet werden soll.
  • HostConnectionSuffix – das Suffix, das auf Hostverbindungen angewendet werden soll.
  • MachineCatalogSuffix – das Suffix, das auf Maschinenkataloge angewendet werden soll.
  • StoreFrontSuffix – das Suffix, das auf StoreFront-Namen angewendet werden soll.
  • TagSuffix – das Suffix, das auf Tags angewendet werden soll.
  • SiteRootFolder – der vollqualifizierte Ordnername, der für Exporte und Importe verwendet werden soll; dies kann ein lokaler Ordner oder eine Dateifreigabe sein.

Generische Parameter

Parameter für den Cloud-Zugriff

Alle Cmdlets, die auf die Cloud zugreifen, unterstützen die folgenden zusätzlichen Parameter.

Hinweis:

Die CustomerId, ClientId und Secret können in der Datei CustomerInfo.yml abgelegt oder mit dem Cmdlet unter Verwendung der folgenden Parameter angegeben werden. Wenn sie an beiden Stellen angegeben werden, haben die Cmdlet-Parameter Vorrang.

  • CustomerId – Die Kunden-ID, die in den Rest-APIs verwendet wird und für den Zugriff auf alle Rest-APIs erforderlich ist. Ihre Kunden-ID finden Sie in Citrix Cloud.
  • ClientId – Die Client-ID, die auf der Citrix Cloud Identity and Access Management-Website erstellt wurde. Dies ist erforderlich, um das Bearer-Token zu erhalten, das für die Authentifizierung bei allen Rest-APIs benötigt wird.
  • Secret – Der geheime Schlüssel, der auf der Citrix Cloud Identity and Access Management-Website erstellt wurde. Dies ist erforderlich, um das Bearer-Token zu erhalten, das für die Authentifizierung bei allen Rest-APIs benötigt wird.
  • CustomerInfoFileSpec – Die Dateispezifikation, die auf eine Kundeninformationsdatei verweist, um den Standardspeicherort und -namen zu überschreiben.

Parameter für den Migrationsmodus

Cmdlets, die die Cloud-Site-Konfiguration ändern (Import, Restore, Merge, New und Sync), unterstützen die folgenden zusätzlichen Parameter, um weitere Flexibilität zu bieten.

  • CheckMode – Führt den Importvorgang aus, nimmt aber keine Änderungen vor. Alle erwarteten Änderungen werden vor Abschluss des Imports gemeldet. Sie können diesen Befehl verwenden, um Ihren Import vorab zu testen.
  • BackupFirst – Sichert den Cloud-Inhalt in .yml-Dateien, bevor die Cloud-Konfiguration geändert wird. Dies ist standardmäßig aktiviert.
  • Confirm – Wenn auf “true” gesetzt, werden Benutzer aufgefordert zu bestätigen, dass sie Änderungen an der Cloud-Site-Konfiguration vornehmen möchten. Das Remove-Cmdlet zeigt aufgrund seiner destruktiven Natur eine Aufforderung an. Setzen Sie es auf “false”, wenn keine Aufforderung gewünscht ist, z. B. bei der Ausführung in automatisierten Skripten. Confirm ist standardmäßig auf “true” gesetzt.
  • SecurityFileFolder – Dies ist der vollqualifizierte Ordner, der die Datei CustomerInfo.yml enthält, die auf einen lokalen Ordner oder einen Netzwerkfreigabeordner verweisen kann, der möglicherweise unter Authentifizierungskontrolle steht. Das Tool fordert keine Anmeldeinformationen an; der Zugriff auf die kontrollierte Ressource muss vor der Ausführung des Tools erlangt werden.
  • SiteName – Gibt den Satz von Präfixen und Suffixen für die Site-Zusammenführung an, der beim Import verwendet werden soll.
  • SiteActive – Gibt an, ob die importierte Site aktiv oder inaktiv ist. Standardmäßig ist dieser Parameter auf $false gesetzt, was bedeutet, dass die importierte Site inaktiv ist.

Parameter für die Protokollanzeige

Die Cmdlets Export, Import, Sync, Restore, Backup, Compare und Remove zeigen die Protokolldatei an, wenn der Vorgang abgeschlossen ist. Sie können die Anzeige unterdrücken, indem Sie den Parameter -DisplayLog auf $false setzen. Standardmäßig wird Notepad.exe zum Anzeigen der Protokolldatei verwendet. Sie können einen anderen Editor in der Datei CustomerInfo.yml angeben.

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

Cmdlet-Rückgabewerte

ActionResult

Alle Cmdlets geben den folgenden Wert zurück.

Cmdlets für die automatisierte Konfiguration zur Migration
April 6, 2026
Beitrag von: 
C C
April 6, 2026
Beitrag von: 
C C

In diesem Artikel

Feedback zur Site | Your privacy choices footer linkIhre Datenschutzauswahl | Datenschutz und rechtliche Bestimmungen | Cookie-Einstellungen | Einstellungen für die Zustimmung | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.