Produktdokumentation
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
PDF anzeigen

Verwalten von Maschinenkatalogen mit vorbereiteten Images

March 31, 2026
Beitrag von: 
C

Sie können einen vorhandenen MCS-Maschinenkatalog mit einem anderen vorbereiteten Image aktualisieren und die Image-Definitionen und -Versionen mithilfe von Folgendem verwalten:

Verwenden von Web Studio

Aktualisieren eines Maschinenkatalogs mit einem anderen vorbereiteten Image

Gehen Sie wie folgt vor, um einen vorhandenen MCS-Maschinenkatalog mit einem anderen vorbereiteten Image zu aktualisieren:

  1. Klicken Sie im linken Navigationsbereich auf Maschinenkataloge, wählen Sie einen zu aktualisierenden Maschinenkatalog aus, klicken Sie mit der rechten Maustaste und wählen Sie Vorbereitetes Image ändern.

  2. Wählen Sie auf der Seite Image ein vorbereitetes Image aus. Fügen Sie bei Bedarf eine Notiz für das ausgewählte vorbereitete Image hinzu.

    Hinweis:

    Gilt für Azure: Sie können auch ein Image auswählen, bei dem ACG nicht aktiviert ist, und später das Kontrollkästchen Vorbereitetes Image in Azure Compute Gallery platzieren aktivieren, um die Images in der Galerie zu platzieren.

  3. Um zu einem zuvor zugewiesenen vorbereiteten Image zurückzukehren, klicken Sie unten im Assistenten auf Vorherige Image-Zuweisung für schnelles Rollback verwenden.

    Ein neues Fenster wird geöffnet und zeigt eine Liste aller verfügbaren historischen Image-Zuweisungen an. Wenn Sie ein Image aus der Liste auswählen, wird die entsprechende Version automatisch im vorbereiteten Image-Baum auf der Image-Seite ausgewählt.

  4. Wählen Sie auf der Seite Rollout-Strategie aus, wann Sie diesen Katalog mit dem ausgewählten vorbereiteten Image aktualisieren möchten.
  5. Überprüfen Sie auf der Seite Zusammenfassung die Details. Klicken Sie auf Fertig stellen.

Sie können den Verlauf der an einem Katalog vorgenommenen Image-Änderungen einsehen. Gehen Sie wie folgt vor, um den Verlauf anzuzeigen:

  1. Wählen Sie einen Maschinenkatalog aus.
  2. Klicken Sie auf der Registerkarte Vorlageneigenschaften im Feld Vorbereitetes Image auf Image-Verlauf anzeigen.

Verwalten der Image-Definitionen und -Versionen

Sie können die Image-Definitionen und -Versionen bearbeiten und löschen, um die Verwendung verschiedener erstellter Image-Versionen und -Definitionen zu verwalten.

Bearbeiten einer Image-Definition

Sie können den Namen und die Beschreibung einer Image-Definition bearbeiten.

Gehen Sie wie folgt vor, um eine Image-Definition zu bearbeiten:

  1. Gehen Sie zum Knoten Images, wählen Sie eine Image-Definition aus und wählen Sie Image-Definition bearbeiten.

Bearbeiten einer Image-Version

Sie können die Beschreibung einer Image-Version bearbeiten, um den Zweck dieser Image-Version anzugeben.

Gehen Sie wie folgt vor, um eine Image-Version zu bearbeiten:

  1. Gehen Sie zum Knoten Images, wählen Sie eine Image-Version aus und wählen Sie Beschreibung bearbeiten.

Löschen einer Image-Version

Gehen Sie wie folgt vor, um eine Image-Version zu löschen:

  1. Gehen Sie zum Knoten Images, wählen Sie eine Image-Version aus und wählen Sie Image-Version löschen.

Hinweis:

Sie können eine Image-Version nicht löschen, wenn sie von einem Maschinenkatalog verwendet wird.

Löschen einer Image-Definition

Gehen Sie wie folgt vor, um eine Image-Definition zu löschen:

  1. Gehen Sie zum Knoten Images, wählen Sie eine Image-Definition aus und wählen Sie Image-Definition löschen.

Hinweis:

Sie können eine Image-Definition nicht löschen, wenn sie eine Image-Version enthält.

Verwenden von PowerShell

Aktualisieren eines Katalogs mithilfe einer Spezifikation für vorbereitete Image-Versionen

Sie können einen Katalog mithilfe des Befehls Set-ProvSchemeImage aktualisieren. Beispiel:

Set-ProvSchemeImage -ProvisioningSchemeUid <Guid> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess][-ImageAssignmentNote <string>]
<!--NeedCopy-->

Oder,

Set-ProvSchemeImage -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess][-ImageAssignmentNote <string>]
<!--NeedCopy-->

Beispiel für den vollständigen Satz von PowerShell-Befehlen zum Aktualisieren eines Katalogs:

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 2 -Filter "PreparationType -eq 'Mcs'"

Set-ProvSchemeImage -ProvisioningSchemeName azurecatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously -ImageAssignmentNote "Update from VST team"
<!--NeedCopy-->

Abrufen des Image-Änderungsverlaufs für das Bereitstellungsschema 

Get-ProvSchemeImageVersionSpecHistory -ProvisioningSchemeName azurecatalog
<!--NeedCopy-->

Löschen von Image-Definition, Image-Version und Spezifikation für vorbereitete Image-Versionen

Beachten Sie Folgendes, bevor Sie eine Image-Definition, eine Image-Version und eine Spezifikation für vorbereitete Image-Versionen löschen:

  • Eine Image-Definition kann nicht gelöscht werden, wenn sie eine Image-Version enthält.
  • Eine Image-Version kann nicht gelöscht werden, wenn sie eine Image-Versionsspezifikation enthält.
  • Eine Master-Image-Versionsspezifikation kann nicht gelöscht werden, wenn sie von einer anderen Spezifikation für vorbereitete Image-Versionen verwendet wird.
  • Eine Spezifikation für vorbereitete Image-Versionen kann nicht gelöscht werden, wenn sie von einem MCS-Maschinenkatalog verwendet wird.
  • Eine Hosting-Einheit kann nicht gelöscht werden, wenn sie von einer anderen Spezifikation für vorbereitete Image-Versionen verwendet wird.

Die detaillierten Schritte sind wie folgt:

  1. Entfernen Sie den Maschinenkatalog. Beispiel:

    Remove-ProvScheme -ProvisioningScheneName decouplingCatalog
<!--NeedCopy-->

  2. Entfernen Sie die freigegebene Spezifikation für vorbereitete Image-Versionen. Beispiel:

    Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <uid> -HostingUnitName AzureWest
<!--NeedCopy-->

  3. Entfernen Sie eine Spezifikation für vorbereitete Image-Versionen. Beispiel:

    $PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
<!--NeedCopy-->

  4. Entfernen Sie die Master-Image-Versionsspezifikation. Beispiel:

    $MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronousl
<!--NeedCopy-->

    Hinweis:

    Eine Master-Image-Versionsspezifikation kann nur gelöscht werden, wenn keine zugehörige Spezifikation für vorbereitete Image-Versionen vorhanden ist.

  5. Entfernen Sie eine Image-Version. Beispiel:

    Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1
<!--NeedCopy-->

  6. Entfernen Sie die Konfiguration für die Image-Definition in der angegebenen Hosting-Verbindung. Beispiel:

    Remove-ProvImageDefinitionConnection -ImageDefinitionName xx -HypervisorConnectionName xxx
<!--NeedCopy-->

  7. Entfernen Sie eine Image-Definition. Beispiel:

    Remove-ProvImageDefinition -ImageDefinitionName image1
<!--NeedCopy-->

Beispiel für den vollständigen Satz von PowerShell-Befehlen, wenn das vorbereitete Image nicht über Host-Einheiten hinweg freigegeben ist:

Remove-ProvScheme -ProvisioningSchemeName decouplingCatalog

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

$MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $MasterImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1

Remove-ProvImageDefinition -ImageDefinitionName image1
<!--NeedCopy-->

Beispiel für den vollständigen Satz von PowerShell-Befehlen, wenn das vorbereitete Image über Host-Einheiten hinweg freigegeben ist:

Remove-ProvScheme -ProvisioningSchemeName decouplingCatalog

Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <uid> 
-HostingUnitName AzureWest

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

$MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $MasterImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1

Remove-ProvImageDefinitionConnection -ImageDefinitionName xx -HypervisorConnectionName xxx

-  Remove-ProvImageDefinition -ImageDefinitionName image1
<!--NeedCopy-->

Verwalten von Image-Definition und Image-Version

Sie können eine Image-Definition umbenennen und bearbeiten sowie eine Image-Version bearbeiten.

  • Benennen Sie eine Image-Definition mithilfe des Befehls Rename-ProvImageDefinition um. Beispiel:

     Rename-ProvImageDefinition -ImageDefinitionUid <Guid> -NewImageDefinitionName <string>
 <!--NeedCopy-->

    Oder,

     Rename-ProvImageDefinition -ImageDefinitionName <string> -NewImageDefinitionName <string>
 <!--NeedCopy-->

  • Bearbeiten Sie eine Image-Definition mithilfe des Befehls Set-ProvImageDefinition. Beispiel:

     Set-ProvImageDefinition -ImageDefinitionUid <Guid> [-Description <string>]
 <!--NeedCopy-->

    Oder,

     Set-ProvImageDefinition -ImageDefinitionName <string> [-Description <string>]
 <!--NeedCopy-->

  • Bearbeiten Sie eine Image-Version mithilfe des Befehls Set-ProvImageVersion. Beispiel:

     Set-ProvImageVersion -ImageVersionUid <Guid> [-Description <string>]
 <!--NeedCopy-->

    Oder,

     Set-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int> [-Description <string>]
 <!--NeedCopy-->

Abrufen von Details zu Image-Definition, Image-Version, Spezifikation für vorbereitete Image-Versionen und Bereitstellungsschema

  • Rufen Sie Image-Definitionsdetails mithilfe des Befehls Get-ProvImageDefinition ab. Beispiel:

     Get-ProvImageDefinition [-ImageDefinitionName <string>] [-ImageDefinitionUid <Guid>] [-ReturnTotalRecordCount] [-MaxRecordCount <int>] [-Skip <int>] [-SortBy <string>] [-Filter <string>]
 <!--NeedCopy-->

  • Rufen Sie Image-Versionsdetails mithilfe des Befehls Get-ProvImageVersion ab. Beispiel:

    • So listen Sie Image-Versionen in einer Image-Definition auf:

       Get-ProvImageVersion -ImageDefinitionUid <Guid>
 <!--NeedCopy-->

      Oder,

       Get-ProvImageVersion -ImageDefinitionName <string>
 <!--NeedCopy-->

    • So rufen Sie Details zu einer Image-Version ab:

       Get-ProvImageVersion -ImageVersionUid <Guid>
 <!--NeedCopy-->

      Oder,

       Get-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int>
 <!--NeedCopy-->

  • Rufen Sie die Spezifikation für vorbereitete Image-Versionen mithilfe des Befehls Get-ProvImageVersionSpec ab. Beispiel:

    • So listen Sie alle Spezifikationen für vorbereitete Image-Versionen in einer Image-Version auf:

       Get-ProvImageVersionSpec -ImageVersionUid <Guid>
 <!--NeedCopy-->

    • So listen Sie Master-Image-Versionsspezifikationen in einer Spezifikation für vorbereitete Image-Versionen auf:

       Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "None"'
 <!--NeedCopy-->

    • So listen Sie Spezifikationen für vorbereitete Image-Versionen in einer Image-Version auf, die einem Master-Image zugeordnet ist:

       Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "MCS" -and SourceImageVersionSpecUid -eq "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"'
 <!--NeedCopy-->

    • So rufen Sie erfolgreiche Spezifikationen für vorbereitete Image-Versionen in einer Image-Version ab:

       Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "MCS" -and SourceImageVersionSpecUid -eq "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -and ImageVersionSpecStatus -eq "Complete"'
 <!--NeedCopy-->

    • So rufen Sie Details zu einer Spezifikation für vorbereitete Image-Versionen ab:

       Get-ProvImageVersionSpec -ImageVersionSpecUid <Guid>
 <!--NeedCopy-->

  • Rufen Sie Details zum Bereitstellungsschema mithilfe des Befehls Get-ProvScheme ab. Beispiel:

     Get-ProvScheme [[-ProvisioningSchemeName] <String>] [-ProvisioningSchemeUid <Guid>] [-ScopeId <Guid>] [-ScopeName <String>] [-ReturnTotalRecordCount] [-MaxRecordCount <Int32>] [-Skip <Int32>] [-SortBy <String>] [-Filter <String>] [-FilterScope <Guid>]
 <!--NeedCopy-->

  • Rufen Sie den Verlauf der Spezifikation für vorbereitete Image-Versionen eines Bereitstellungsschemas mithilfe des Befehls Get-ProvSchemeImageVersionSpecHistory ab. Beispiel:

     Get-ProvSchemeImageVersionSpecHistory [-ProvisioningSchemeName <String>] [-ProvisioningSchemeUid <Guid>] [-ImageVersionSpecUid <Guid>] [-ImageVersionSpecHistoryUid <Guid>] [-ReturnTotalRecordCount] [-MaxRecordCount <Int32>] [-Skip <Int32>] [-SortBy <String>] [-Filter <String>] [-FilterScope <Guid>]
 <!--NeedCopy-->

Weitere Informationen

Verwalten von Maschinenkatalogen mit vorbereiteten Images
March 31, 2026
Beitrag von: 
C
March 31, 2026
Beitrag von: 
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.