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

Maschinenkataloge mit vorbereiteten Images verwalten

April 6, 2026
Beitrag von: 
C

  • Sie können einen vorhandenen MCS-Maschinenkatalog mit einem anderen vorbereiteten Image aktualisieren und die Imagedefinitionen und -versionen verwalten, indem Sie Folgendes verwenden:

  • Web Studio
  • PowerShell

Web Studio verwenden

Maschinenkatalog mit einem anderen vorbereiteten Image aktualisieren

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

  1. Klicken Sie im linken Navigationsbereich auf Maschinenkataloge und wählen Sie einen Maschinenkatalog aus, den Sie aktualisieren möchten. 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:

    Anwendbar 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 Imagezuweisung für schnelles Rollback verwenden.

    Ein neues Fenster wird geöffnet und zeigt eine Liste aller verfügbaren historischen Imagezuweisungen an. Wenn Sie ein Image aus der Liste auswählen, wird die entsprechende Version automatisch im vorbereiteten Imagebaum 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 dazu wie folgt vor:

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

Imagedefinitionen und -versionen verwalten

Sie können die Imagedefinitionen und -versionen bearbeiten und löschen, um die Verwendung verschiedener erstellter Imageversionen und -definitionen zu verwalten.

Imagedefinition bearbeiten

Sie können den Namen und die Beschreibung einer Imagedefinition bearbeiten.

Gehen Sie wie folgt vor, um eine Imagedefinition zu bearbeiten:

  1. Gehen Sie zum Knoten Images, wählen Sie eine Imagedefinition aus und wählen Sie Imagedefinition bearbeiten.

Imageversion bearbeiten

Sie können die Beschreibung einer Imageversion bearbeiten, um den Zweck dieser Imageversion anzugeben.

Gehen Sie wie folgt vor, um eine Imageversion zu bearbeiten:

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

Imageversion löschen

Gehen Sie wie folgt vor, um eine Imageversion zu löschen:

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

Hinweis:

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

  • Imagedefinition löschen

  • Gehen Sie wie folgt vor, um eine Imagedefinition zu löschen:

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

Hinweis:

Sie können eine Imagedefinition nicht löschen, wenn sie eine Imageversion enthält.

PowerShell verwenden

Katalog mit einer vorbereiteten Imageversionsspezifikation aktualisieren

Sie können einen Katalog mit dem Befehl Set-ProvSchemeImage aktualisieren. Zum 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-->

Imageänderungsverlauf für das Bereitstellungsschema abrufen 

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

Imagedefinition, Imageversion und vorbereitete Imageversionsspezifikation löschen

Beachten Sie Folgendes, bevor Sie eine Imagedefinition, Imageversion und vorbereitete Imageversionsspezifikation löschen:

  • Eine Imagedefinition kann nicht gelöscht werden, wenn sie eine Imageversion enthält.
  • Eine Imageversion kann nicht gelöscht werden, wenn sie eine Imageversionsspezifikation enthält.
  • Eine Master-Imageversionsspezifikation kann nicht gelöscht werden, wenn sie von einer anderen vorbereiteten Imageversionsspezifikation verwendet wird.
  • Eine vorbereitete Imageversionsspezifikation 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 vorbereiteten Imageversionsspezifikation verwendet wird.

Die detaillierten Schritte sind wie folgt:

  1. Entfernen Sie den Maschinenkatalog. Zum Beispiel:

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

  2. Entfernen Sie die freigegebene vorbereitete Imageversionsspezifikation. Zum Beispiel:

    Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <uid> -HostingUnitName AzureWest
<!--NeedCopy-->
    1. Entfernen Sie eine vorbereitete Imageversionsspezifikation. Zum Beispiel:
     $PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

 Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
 <!--NeedCopy-->
      1. Entfernen Sie die Master-Imageversionsspezifikation. Zum Beispiel:
     $MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"

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

    • Hinweis:

      Die Master-Imageversionsspezifikation kann nur gelöscht werden, wenn keine zugehörige vorbereitete Imageversionsspezifikation vorhanden ist.

  1. Entfernen Sie eine Imageversion. Zum Beispiel:

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

  2. Entfernen Sie die Konfiguration für die Imagedefinition in der angegebenen Hosting-Verbindung. Zum Beispiel:

    ```

  • Remove-ProvImageDefinitionConnection -ImageDefinitionName xx -HypervisorConnectionName xxx

    ```

  1. Entfernen Sie eine Imagedefinition. Zum Beispiel:

    Remove-ProvImageDefinition -ImageDefinitionName image1
<!--NeedCopy-->
    • Beispiel für den vollständigen Satz von PowerShell-Befehlen, wenn das vorbereitete Image nicht über die Host-Einheit hinweg freigegeben wird:
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 die Host-Einheit hinweg freigegeben wird:

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

Imagedefinition und Imageversion verwalten

Sie können eine Imagedefinition umbenennen und bearbeiten sowie eine Imageversion bearbeiten.

  • Benennen Sie eine Imagedefinition mit dem Befehl Rename-ProvImageDefinition um. Zum Beispiel:

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

    Oder:

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

  • Bearbeiten Sie eine Imagedefinition mit dem Befehl Set-ProvImageDefinition. Zum Beispiel:

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

    Oder:

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

  • Bearbeiten Sie eine Imageversion mit dem Befehl Set-ProvImageVersion. Zum Beispiel:

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

    Oder:

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

Details zu Imagedefinition, Imageversion, vorbereiteter Imageversionsspezifikation und Bereitstellungsschema abrufen

  • Rufen Sie Imagedefinitionsdetails mit dem Befehl Get-ProvImageDefinition ab. Zum Beispiel:

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

  • Rufen Sie Imageversionsdetails mit dem Befehl Get-ProvImageVersion ab. Zum Beispiel:

    • Um Imageversionen in einer Imagedefinition aufzulisten:

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

      Oder:

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

    • Um Details zu einer Imageversion abzurufen:

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

      Oder:

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

  • Rufen Sie die vorbereitete Imageversionsspezifikation mit dem Befehl Get-ProvImageVersionSpec ab. Zum Beispiel:

    • Um alle vorbereiteten Imageversionsspezifikationen in einer Imageversion aufzulisten:

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

    • Um Master-Imageversionsspezifikationen in einer vorbereiteten Imageversionsspezifikation aufzulisten:

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

    • Um vorbereitete Imageversionsspezifikationen in einer Imageversion aufzulisten, die einem Master-Image zugeordnet ist:

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

    • Um erfolgreiche vorbereitete Imageversionsspezifikationen in einer Imageversion abzurufen:

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

    • Um Details zu einer vorbereiteten Imageversionsspezifikation abzurufen:

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

  • Rufen Sie Details zum Bereitstellungsschema mit dem Befehl Get-ProvScheme ab. Zum 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 vorbereiteten Imageversionsspezifikation eines Bereitstellungsschemas mit dem Befehl Get-ProvSchemeImageVersionSpecHistory ab. Zum 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

Maschinenkataloge mit vorbereiteten Images verwalten
April 6, 2026
Beitrag von: 
C
April 6, 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.