Produktdokumentation
Citrix Virtual Apps and Desktops 7 2402 LTSR
PDF anzeigen

Imageverwaltung

June 5, 2026
Beitrag von: 
C

Einführung

Der MCS-Katalogerstellungs- oder -Aktualisierungsprozess umfasst zwei Phasen:

  • Mastering: Ein Quell-Image wird in ein veröffentlichtes Image umgewandelt.
  • Klonen: Neue VMs werden aus dem veröffentlichten Image erstellt.

Mit der Imageverwaltungsfunktion trennt MCS die Mastering-Phase vom gesamten Bereitstellungs-Workflow.

Sie können verschiedene MCS-Image-Versionen (Vorbereitetes Image) aus einem einzigen Quell-Image vorbereiten und diese in mehreren verschiedenen MCS-Maschinenkatalogen verwenden. Diese Implementierung reduziert die Speicher- und Zeitkosten erheblich und vereinfacht den VM-Bereitstellungs- und Image-Aktualisierungsprozess.

Die Vorteile der Verwendung dieser Imageverwaltungsfunktion sind:

  • Vorbereitete Images im Voraus generieren, ohne einen Katalog zu erstellen.
  • Vorbereitete Images in mehreren Szenarien wiederverwenden, z. B. beim Erstellen und Aktualisieren eines Katalogs.
  • Die Erstellungs- oder Aktualisierungszeit des Katalogs erheblich reduzieren.

Hinweis:

  • Diese Funktion ist derzeit für Azure- und VMware-Virtualisierungsumgebungen anwendbar.
  • Sie können einen MCS-Maschinenkatalog erstellen, ohne vorbereitete Images zu verwenden. In diesem Fall können Sie die Vorteile der Funktion nicht nutzen.
  • Die Funktion ist ab Citrix Virtual Apps and Desktops™ 2402 LTSR CU2 allgemein verfügbar.

Anwendungsfälle

Einige der Anwendungsfälle der Image-Verwaltungsfunktionalität sind:

  • Versionsverwaltung: Image-Versionen ermöglichen Ihnen:

    • verschiedene Iterationen oder Updates eines bestimmten Images zu verwalten.
    • mehrere Versionen eines Images für verschiedene Zwecke zu pflegen.

  • Logische Gruppierung: Sie können mehrere Image-Definitionen erstellen, um:

    • Image-Versionen logisch nach verschiedenen Kriterien wie Projekt, Abteilung oder Anwendungs- und Desktoptyp zu gruppieren.
    • Images innerhalb einer Organisation effizienter zu verwalten.

Was ist ein vorbereitetes Image?

Mit der Image-Verwaltungsfunktionalität entkoppelt MCS die Mastering-Phase vom gesamten Workflow zur Katalogerstellung oder -aktualisierung und unterteilt den Prozess in zwei Phasen:

  1. Vorbereitete Images aus einem einzigen Quell-Image erstellen.
  2. Das vorbereitete Image verwenden, um einen MCS-Maschinenkatalog zu erstellen oder zu aktualisieren.

Sie können die vorbereiteten Images im Voraus erstellen. Sie können ein einziges vorbereitetes Image verwenden, um mehrere von MCS bereitgestellte Maschinenkataloge zu erstellen oder zu aktualisieren.

Verstehen Sie, wie ein vorbereitetes Image über mehrere MCS-Maschinenkataloge hinweg verwendet wird, wenn Sie das Web Studio vom Image aus verwenden:

Übersicht über vorbereitete Images

Imagedefinition: Imagedefinitionen sind eine logische Gruppierung von Versionen eines Images. Die Imagedefinition enthält Informationen über:

  • warum das Image erstellt wurde
  • für welches Betriebssystem es bestimmt ist
  • weitere Informationen zur Verwendung des Images.

Ein Katalog wird nicht aus einer Imagedefinition erstellt, sondern aus den Imageversionen, die auf der Grundlage der Imagedefinition erstellt werden.

Imageversion: Imageversionen verwalten die Versionierung für die Imagedefinition. Eine Imagedefinition kann mehrere Imageversionen haben. Verwenden Sie die Imageversionen als vorbereitete Images, um einen Katalog zu erstellen oder zu aktualisieren.

Wenn Sie alternativ PowerShell-Befehle verwenden möchten, um ein Bereitstellungsschema zum Erstellen oder Aktualisieren eines Katalogs zu erstellen, müssen Sie eine vorbereitete Imageversionsspezifikation basierend auf der Master-Imageversionsspezifikation erstellen, wie sie für Ihre Umgebung erforderlich ist.

Anforderung

  • Für Windows-Masterimages werden nur VDA-Images der Version 2311 oder höher unterstützt. Die MCS/IO-Komponente muss explizit ausgewählt und installiert werden. Das Aktivieren oder Deaktivieren der MCS I/O-Konfiguration muss während der Erstellung oder Aktualisierung des Maschinenkatalogs festgelegt werden, da sie standardmäßig nicht aktiviert ist.

Einschränkungen

Derzeit unterstützt die Funktion Folgendes nicht:

  • Mehrere NICs in Azure
  • Funktion für persistente Datenfestplatten
  • Ruhezustand für Multisession
  • Änderung des Imagetyp

Image-Lebenszyklusverwaltung mit Web Studio

Der Lebenszyklus des Images, wenn Sie Web Studio verwenden, ist:

  1. Ein vorbereitetes Image erstellen: Eine Imagedefinition und deren anfängliche Imageversion erstellen.
  2. Imageversionen aus der anfänglichen Imageversion erstellen.
  3. Eine Imageversion als vorbereitetes Image zum Erstellen von Katalogen verwenden.
  4. Einen Maschinenkatalog mit einem anderen vorbereiteten Image aktualisieren.
  5. Die Imagedefinitionen und -versionen verwalten: Den Namen und die Beschreibung von Imageversionen sowie die Beschreibung einer Imagedefinition bearbeiten.
  6. Eine Imageversion löschen.
  7. Eine Imagedefinition löschen.

Alternativ können Sie Images auch mit PowerShell verwalten. Siehe Image-Lebenszyklusverwaltung mit PowerShell.

Einen Katalog mit einem vorbereiteten Image erstellen oder aktualisieren

Vorbereitete Images erstellen und die vorbereiteten Images zum Erstellen oder Aktualisieren eines MCS-Maschinenkatalogs verwenden mit:

Web Studio verwenden

Siehe die folgenden Themen:

Den Knoten „Bilder“ verstehen

Verwenden Sie den Knoten Bilder, um MCS-vorbereitete Images zu erstellen und zu verwalten. Die Hauptansicht ist in vier Teile unterteilt:

image-node-main-view

Bezeichnung Teil Beschreibung
A Imagedefinitionen Listet die zuvor erstellten Imagedefinitionen auf.
B Image-Versionen Zeigt Image-Versionen der ausgewählten Imagedefinition an.
C


Details


  • Die Registerkarte Details zeigt detaillierte Informationen zur ausgewählten Imagedefinition oder -version an, z. B. Master-Image, Ressource, Hypervisor, Name der Imagedefinition, Betriebssystemtyp und Sitzungstyp.
  • Die Registerkarte Image-Schema zeigt Informationen zur Vorlage an, die für die Image-Vorbereitung verwendet wurde, z. B. Festplatte, Maschinengröße, Lizenztyp, Datenträgerverschlüsselungssatz, Maschinenprofil usw.
  • Die Registerkarte Bereitstellungsschemata zeigt den Namen des Bereitstellungsschemas an, das zum Erstellen des Katalogs verwendet wurde.
  • Die Registerkarte Fehlerbehebung zeigt den Fehlerstatus der ausgewählten Imageversion an.
D Aktionsleiste Listet die Aktionen auf, die Sie für Imagdefinitionen und -versionen ausführen können, z. B. Imageversion erstellen, Beschreibung bearbeiten, Imageversion löschen und Katalog erstellen.

Maschinenkatalog mit dem vorbereiteten Image erstellen

Die wichtigsten Schritte zum Erstellen eines MCS-Maschinenkatalogs mit dem vorbereiteten Image sind:

  1. Erstellen Sie die Imagdefinition und die anfänglichen Imageversionen.
  2. Verwenden Sie die Imageversion als vorbereitetes Image, um einen Katalog zu erstellen.

Imagdefinition und anfängliche Imageversion erstellen

Gehen Sie wie folgt vor, um eine Imagdefinition und die anfängliche Imageversion zu erstellen:

  1. Melden Sie sich bei Web Studio an und wählen Sie den Knoten Images aus. Klicken Sie auf der Seite Einführung auf Weiter.
  2. Geben Sie auf der Seite Imagdefinition den OS-Typ und den Sitzungstyp für die Imagdefinition an.

  3. Wählen Sie auf der Seite Image Ressourcen und ein Masterimage aus, das als Vorlage zum Erstellen der Imageversion verwendet werden soll. Sie können das Kontrollkästchen Maschinenprofil verwenden aktivieren und ein Maschinenprofil auswählen.

    Hinweis:

    Bevor Sie ein Image auswählen, vergewissern Sie sich, dass VDA 2311 oder höher auf dem Masterimage installiert ist und der MCSIO-Treiber auf dem VDA installiert ist.

  4. (Nur für Azure) Wählen Sie auf der Seite Speicher- und Lizenztypen den Speicher- und Lizenztyp aus, der im Rahmen des Image-Vorbereitungsprozesses verwendet werden soll.

    Hinweis:

    Wenn Sie auf der Seite Image ein Maschinenprofil auswählen, wird der Lizenztyp des Maschinenprofils basierend auf der Profileinstellung vorab ausgewählt.

  5. Auf der Seite Maschinenspezifikation:

    • Wählen Sie für Azure eine Maschinengröße aus. Wenn Sie auf der Seite Image ein Maschinenprofil auswählen, wird die Maschinengröße des Maschinenprofils standardmäßig ausgewählt.
    • Für VMware: Wenn Sie ein Maschinenprofil auswählen, wird die Anzahl der virtuellen CPUs, die vom Maschinenprofil abgeleitet wurde, angezeigt und ist nicht änderbar. Wenn Sie kein Maschinenprofil auswählen, wird nur die Speichergröße angezeigt, die vom Masterimage abgeleitet wurde.

  6. Wählen oder fügen Sie auf der Seite NICs NICs für das Vorbereitungsimage hinzu. Wählen Sie für jede NIC ein zugehöriges virtuelles Netzwerk aus.

    Für VMware: Wenn Sie kein Maschinenprofil auswählen, wird die dem Masterimage zugeordnete NIC standardmäßig ausgewählt. Wenn Sie ein Maschinenprofil auswählen, werden die NICs vom Maschinenprofil abgeleitet und die Anzahl ist nicht änderbar.

    Hinweis:

    Mehrere NICs werden in Azure nicht unterstützt.

  7. (Nur für Azure) Wählen Sie auf der Seite Datenträgereinstellungen den vom Kunden verwalteten Verschlüsselungsschlüssel (CMEK) aus. Wenn das Maschinenprofil keinen CMEK hat, das Masterimage jedoch, wird der CMEK aus dem Masterimage vorab ausgewählt.
  8. Geben Sie auf der Seite Versionsbeschreibung eine Beschreibung für die erstellte anfängliche Image-Version ein.
  9. Überprüfen Sie auf der Seite Zusammenfassung die Details der Imagestruktur und der erstellten anfänglichen Image-Version. Geben Sie einen Namen und eine Beschreibung für die Imagestruktur ein. Klicken Sie auf Fertig stellen.

Image-Versionen erstellen

Image-Versionen ermöglichen die Verwaltung verschiedener Iterationen oder Updates eines bestimmten Images. Diese Funktionalität ermöglicht es Ihnen, mehrere Versionen eines Images für verschiedene Zwecke zu verwalten.

So erstellen Sie Image-Versionen aus der ursprünglichen Image-Version:

Hinweis:

Die Hosting-Einheit aller Image-Versionen muss identisch sein.

  1. Gehen Sie zum Knoten Images, wählen Sie eine Image-Version aus und wählen Sie Image-Version erstellen.
  2. Wenn die Konfiguration der Image-Version von der ursprünglich konfigurierten Image-Version abweichen soll, konfigurieren Sie die Einstellungen auf den Seiten Image, Speicher- und Lizenztypen, Maschinenspezifikation, NICs und Datenträgereinstellungen des Dialogfelds Image-Version erstellen.
  3. Fügen Sie eine Beschreibung für die Image-Version hinzu. Klicken Sie auf Fertig stellen.

Image-Versionen erstellen

Maschinenkatalog über den Knoten Images erstellen

Verwenden Sie die Option Katalog erstellen im Knoten Images, um einen Katalog mit der Image-Version zu erstellen.

Alternativ können Sie die Version auswählen, wenn Sie einen Katalog im Knoten Maschinenkataloge erstellen, indem Sie auf die Option für vorbereitete Images im Workflow zur Katalogerstellung verweisen. Siehe Maschinenkatalog über den Knoten Maschinenkataloge erstellen

So erstellen Sie einen MCS-Maschinenkatalog über den Knoten Images:

  1. Wählen Sie eine Image-Version aus und klicken Sie auf Katalog erstellen. Klicken Sie auf der Seite Einführung auf Weiter.
  2. Wählen Sie auf der Seite Desktop-Erfahrung die gewünschte Desktop-Erfahrung aus.
  3. Von der Seite Image bis zur Seite Datenträgereinstellungen sind die Einstellungen basierend auf der ausgewählten Image-Version vorausgewählt.
  4. (Für Azure) Auf der Seite Ressourcengruppe können Sie wählen, ob Sie eine neue Ressourcengruppe erstellen oder eine vorhandene Ressourcengruppe verwenden möchten, um die Ressourcen dieses Katalogs zu platzieren.
  5. Nehmen Sie die Einstellungen auf den folgenden Seiten vor.
  6. Überprüfen Sie auf der Seite Zusammenfassung die Details des Maschinenkatalogs. Geben Sie einen Namen und eine Beschreibung für den Maschinenkatalog ein. Klicken Sie auf Fertig stellen.
  7. Gehen Sie zum Knoten Maschinenkataloge, um den erstellten Maschinenkatalog anzuzeigen.

Einen Maschinenkatalog vom Knoten Maschinenkataloge aus erstellen

Um einen MCS-Maschinenkatalog vom Knoten Maschinenkataloge aus zu erstellen, gehen Sie wie folgt vor:

  1. Klicken Sie im linken Navigationsbereich auf Maschinenkataloge.
  2. Klicken Sie auf Maschinenkatalog erstellen. Die Seite Maschinenkatalog-Setup wird angezeigt. Klicken Sie auf den Seiten Einführung, Maschinentyp und Maschinenverwaltung auf Weiter.
  3. Auf der Seite Image:
    1. Wählen Sie Vorbereitetes Image.
    2. Wählen Sie unter Vorbereitetes Image eine Image-Version einer Image-Definition aus.
    3. Klicken Sie auf den Namen der Image-Version. Um weitere Details zur ausgewählten Image-Version anzuzeigen, klicken Sie auf die unterstrichene Versionsnummer.
    4. Wenn die ausgewählte Image-Version mit einem Maschinenprofil konfiguriert ist, wählen Sie ein Maschinenprofil aus. Wenn die ausgewählte Image-Version nicht mit einem Maschinenprofil konfiguriert ist, können Sie kein Maschinenprofil verwenden.
  4. Konfigurieren Sie die Einstellungen auf den folgenden Seiten.
  5. Auf der Seite Datenträgereinstellungen können Sie, wenn das ausgewählte vorbereitete Image einen Datenträgerverschlüsselungssatz verwendet, den Verschlüsselungssatz nicht entfernen, aber Sie können den Schlüssel in einen anderen Verschlüsselungsschlüssel ändern.
  6. (Für Azure) Auf der Seite Ressourcengruppe können Sie wählen, ob Sie eine neue Ressourcengruppe erstellen oder eine bestehende Ressourcengruppe verwenden möchten, um die Ressourcen dieses Katalogs zu platzieren.
  7. Schließen Sie die Einstellungen auf den folgenden Seiten ab.
  8. Überprüfen Sie auf der Seite Zusammenfassung die Details des Maschinenkatalogs. Geben Sie einen Namen und eine Beschreibung für den Maschinenkatalog ein. Klicken Sie auf Fertig stellen.

Einen Maschinenkatalog mit einem anderen vorbereiteten Image aktualisieren

Um einen bestehenden 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.
  3. Wählen Sie auf der Seite Rollout-Strategie aus, wann Sie diesen Katalog mit dem ausgewählten vorbereiteten Image aktualisieren möchten.
  4. Ü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 unter der Registerkarte Vorlageneigenschaften im Feld Vorbereitetes Image auf Image-Verlauf anzeigen.

Imagedefinitionen und -versionen verwalten

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

Eine Imagedefinition bearbeiten

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

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

  1. Gehen Sie zum Knoten Bilder, wählen Sie eine Bilddefinition aus und wählen Sie Bilddefinition bearbeiten.

Bildversion bearbeiten

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

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

  1. Gehen Sie zum Knoten Bilder, wählen Sie eine Bildversion aus und wählen Sie Beschreibung bearbeiten.

Bildversion löschen

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

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

Hinweis:

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

Bilddefinition löschen

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

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

Hinweis:

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

Image-Lebenszyklusverwaltung mit PowerShell

Wenn Sie PowerShell-Befehle zum Erstellen eines Bereitstellungsschemas verwenden möchten, müssen Sie eine vorbereitete Image-Versionsspezifikation basierend auf der Master-Image-Versionsspezifikation erstellen, wie es für Ihre Umgebung erforderlich ist.

Master-Image-Versionsspezifikation: Eine Master-Image-Versionsspezifikation ist ein spezifisches Image, das unter einer Image-Version hinzugefügt oder erstellt wurde. Sie können ein vorhandenes Image im Hypervisor als Master-Image-Versionsspezifikation hinzufügen oder eine vorbereitete Image-Versionsspezifikation basierend auf der Master-Image-Versionsspezifikation erstellen, wie es für Ihre Umgebung erforderlich ist. Die vorbereitete Image-Versionsspezifikation kann für mehrere Bereitstellungsschemata verwendet werden.

Der Lebenszyklus eines Images bei Verwendung von PowerShell-Befehlen ist:

  1. Ein Image erstellen:

    1. Eine Image-Definition erstellen.
    2. Eine Image-Version erstellen.
    3. Eine Master-Image-Versionsspezifikation hinzufügen.
    4. Eine vorbereitete Image-Versionsspezifikation erstellen.

  2. Einen MCS-Maschinenkatalog mit einer vorbereiteten Image-Versionsspezifikation erstellen:

    1. Einen Broker-Katalog erstellen.
    2. Einen Identitätspool erstellen.
    3. Erstellen Sie ein Bereitstellungsschema mit dem Parameter der vorbereiteten Image-Versionsspezifikation Uid unter Verwendung des Befehls New-ProvScheme.
    4. Verknüpfen Sie den Broker-Katalog mit dem Bereitstellungsschema.
  3. Erstellen Sie VMs im MCS-Maschinenkatalog.
  4. Ändern Sie die Spezifikation der vorbereiteten Image-Version eines Bereitstellungsschemas mit dem Set-ProvScheme Befehl.
  5. Verwalten Sie die Image-Definitionen und -Versionen: Bearbeiten Sie die Image-Versionen und Image-Definitionen.
  6. Löschen Sie einen MCS-Maschinenkatalog: Die Löschreihenfolge ist: Spezifikation der vorbereiteten Image-Version > Spezifikation der Master-Image-Version > Image-Version > Image-Definition. Bevor Sie die Spezifikation der Image-Version löschen, stellen Sie sicher, dass die Spezifikation der vorbereiteten Image-Version keinem MCS-Maschinenkatalog zugeordnet ist.

PowerShell verwenden

Mit PowerShell-Befehlen können Sie Folgendes tun:

Ein vorbereitetes Image erstellen

Die detaillierten PowerShell-Befehle zum Erstellen einer Spezifikation für eine vorbereitete Image-Version lauten wie folgt:

  1. Überprüfen Sie die verfügbaren Namen der Image-Definitionen mithilfe von Test-ProvImageDefinitionNameAvailable command. Zum Beispiel:

    Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]>
<!--NeedCopy-->

  2. Erstellen Sie eine Image-Definition mithilfe des Befehls New-ProvImageDefinition. Zum Beispiel:

    New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
<!--NeedCopy-->

  3. Erstellen Sie eine Image-Version mithilfe des Befehls New-ProvImageVersion. Zum Beispiel:

    New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"
<!--NeedCopy-->

  4. Fügen Sie der Image-Version eine Master-Image-Versionsspezifikation mithilfe des Befehls Add-ProvImageVersionSpec hinzu. Zum Beispiel:

    Add-ProvImageVersionSpec -ImageDefinitionName  image1  -ImageVersionNumber  1 -HostingUnitName azure -MasterImagePath "XDHyp:\HostingUnits\azure\image.folder\azureresourcegroup.resourcegroup\win2022-snapshot.snapshot"
<!--NeedCopy-->

    Hinweis:

    Sie können nur eine Master-Image-Versionsspezifikation zu einer Image-Version für eine Hosting-Einheit hinzufügen.

  5. Erstellen Sie eine vorbereitete Image-Versionsspezifikation aus der Master-Image-Versionsspezifikation mithilfe des Befehls New-ProvImageVersionSpec. Zum Beispiel:

    New-ProvImageVersionSpec
-SourceImageVersionSpecUid  c6e7384c-b2f8-46d6-9519-29a2c57ed3cb
-NetworkMapping @{"0"="XDHyp:\HostingUnits\azure\virtualprivatecloud.folder\azureresourcegroup.resourcegroup\azure-vnet-eastus.virtualprivatecloud\dev.network"
-ServiceOffering "XDHyp:\HostingUnits\azure\serviceoffering.folder\Standard_B2ms.serviceoffering" -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"></CustomProperties>" -RunAsynchronously
<!--NeedCopy-->

    Hinweis:

    Eine Hosting-Einheit und ein Vorbereitungstyp können nur eine vorbereitete Instanz haben.

Beispiel für den vollständigen Satz von PowerShell-Befehlen zum Erstellen einer Image-Definition, einer Image-Version und einer vorbereiteten Image-Versionsspezifikation in Azure:

$ImageDefintion = New-ProvImageDefinition
-ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
 $ImageVersion = New-ProvImageVersion -ImageDefinitionName $ImageDefintion.ImageDefinitionName -Description "version 1"
$MasterImagePath = "XDHyp:\HostingUnits\azure\image.folder\azureresourcegroup.resourcegroup\win2022-snapshot.snapshot"
$SourceImageVersionSpec = Add-ProvImageVersionSpec -ImageDefinitionName $ImageVersion.ImageDefinitionName -ImageVersionNumber $ImageVersion.ImageVersionNumber -HostingUnitName azure -MasterImagePath $MasterImagePath
$Task = New-ProvImageVersionSpec -SourceImageVersionSpecUid  $SourceImageVersionSpec.ImageVersionSpecUid -NetworkMapping @{"0"="XDHyp:\HostingUnits\azure\virtualprivatecloud.folder\azureresourcegroup.resourcegroup\azure-vnet-eastus.virtualprivatecloud\dev.network"} -ServiceOffering "XDHyp:\HostingUnits\azure\serviceoffering.folder\Standard_B2ms.serviceoffering" -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"></CustomProperties>" -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
<!--NeedCopy-->

Beispiel für den vollständigen Satz von PowerShell-Befehlen zum Erstellen einer Image-Definition, einer Image-Version und einer vorbereiteten Image-Versionsspezifikation in VMware:

$ImageDefintion = New-ProvImageDefinition -ImageDefinitionName image2 -OsType Windows -VdaSessionSupport SingleSession
$ImageVersion = New-ProvImageVersion -ImageDefinitionName $ImageDefintion.ImageDefinitionName -Description "version 1"
$MasterImagePath = "XDHyp:\HostingUnits\vmware\win10-master.vm\win10-master-snap.snapshot"
$SourceImageVersionSpec = Add-ProvImageVersionSpec -ImageDefinitionName $ImageVersion.ImageDefinitionName -ImageVersionNumber $ImageVersion.ImageVersionNumber -HostingUnitName vmware -MasterImagePath $MasterImagePath
$Task = New-ProvImageVersionSpec -SourceImageVersionSpecUid  $SourceImageVersionSpec.ImageVersionSpecUid -NetworkMapping @{"0"="XDHyp:\HostingUnits\vmware\\DSwitch-VM Network.network"} -VMCpuCount 2 -VMMemoryMB 4096 -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
<!--NeedCopy-->

Hinweis:

  • Alle Image-Versionsspezifikationen in einer Image-Definition müssen zur selben Hosting-Einheit gehören.
  • Eine Image-Version kann nur eine Master-Image-Versionsspezifikation und eine vorbereitete Image-Versionsspezifikation haben.
  • Alle Image-Versionsspezifikationen müssen entweder ein Maschinenprofil haben oder keine der Image-Versionsspezifikationen darf ein Maschinenprofil haben.
  • Sie können keine Ressourcengruppe angeben, während Sie eine Image-Versionsspezifikation erstellen.

Katalog mit einer vorbereiteten Image-Versionsspezifikation erstellen

Erstellen Sie einen MCS-Maschinenkatalog aus der vorbereiteten Image-Versionsspezifikation mit dem Befehl New-ProvScheme. Zum Beispiel:

New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-VMCpuCount <int>] [-VMMemoryMB <int>] [-UseWriteBackCache] [-NetworkMapping <Hashtable>] [-CleanOnBoot] [-Scope <string[]>] [-Metadata <Hashtable>] [-ServiceOffering <string>] [-SecurityGroup <string[]>] [-TenancyType <string>] [-MachineProfile <string>] [-CustomProperties <string>] [-ResetAdministratorPasswords] [-UseFullDiskCloneProvisioning] [-RunAsynchronously] [-PurgeJobOnSuccess] [-ProvisioningSchemeType <ProvisioningSchemeType>]
<!--NeedCopy-->

Oder:

New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitName <string> -IdentityPoolName <string> [-VMCpuCount <int>] [-VMMemoryMB <int>] [-UseWriteBackCache] [-NetworkMapping <Hashtable>] [-CleanOnBoot] [-Scope <string[]>] [-Metadata <Hashtable>] [-ServiceOffering <string>] [-SecurityGroup <string[]>] [-TenancyType <string>] [-MachineProfile <string>] [-CustomProperties <string>] [-ResetAdministratorPasswords] [-UseFullDiskCloneProvisioning] [-RunAsynchronously] [-PurgeJobOnSuccess] [-ProvisioningSchemeType <ProvisioningSchemeType>]
<!--NeedCopy-->

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

$Catalog = New-BrokerCatalog  -AllocationType "Random"  -IsRemotePC $False  -MinimumFunctionalLevel "L7_20" -Name "azurecatalog" -PersistUserChanges "Discard" -ProvisioningType "MCS" -Scope @() -SessionSupport "MultiSession"
$IdentityPool = New-AcctIdentityPool  -AllowUnicode  -Domain "azure.local" -IdentityPoolName "azurecatalog" -IdentityType "ActiveDirectory"  -NamingScheme "azure##" -NamingSchemeType "Numeric" -Scope @()
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
$Task = New-ProvScheme -ProvisioningSchemeName azurecatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -HostingUnitName azure -IdentityPoolName azurecatalog -CleanOnBoot -Scope @() -SecurityGroup @() -ServiceOffering "XDHyp:\HostingUnits\azure\serviceoffering.folder\Standard_B2s.serviceoffering" -NetworkMapping @{"0"="XDHyp:\HostingUnits\azure\virtualprivatecloud.folder\azureresourcegroup.resourcegroup\azure-vnet-eastus.virtualprivatecloud\dev.network"} -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"StorageAccountType`" Value=`"StandardSSD_LRS`" /></CustomProperties>" -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
$ProvScheme = Get-ProvScheme -ProvisioningSchemeName azurecatalog
Set-BrokerCatalog -Name $Catalog.Name -ProvisioningSchemeId $ProvScheme.ProvisioningSchemeUid
<!--NeedCopy-->

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

$Catalog = New-BrokerCatalog  -AllocationType "Random"  -IsRemotePC $False  -MinimumFunctionalLevel "L7_20" -Name "vmwarecatalog" -PersistUserChanges "Discard" -ProvisioningType "MCS" -Scope @() -SessionSupport "MultiSession"
$IdentityPool = New-AcctIdentityPool  -AllowUnicode  -Domain "vmware.local" -IdentityPoolName "vmwarecatalog" -IdentityType "ActiveDirectory"  -NamingScheme "vmware##" -NamingSchemeType "Numeric" -Scope @()
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image2 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
$Task = New-ProvScheme -ProvisioningSchemeName vmwarecatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -HostingUnitName vmware -IdentityPoolName vmwarecatalog -CleanOnBoot -Scope @() -SecurityGroup @() -NetworkMapping @{"0"="XDHyp:\HostingUnits\vmware\\DSwitch-VM Network.network"} -VMCpuCount 2 -VMMemoryMB 4096 -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
$ProvScheme = Get-ProvScheme -ProvisioningSchemeName vmwarecatalog
Set-BrokerCatalog -Name $Catalog.Name -ProvisioningSchemeId $ProvScheme.ProvisioningSchemeUid
<!--NeedCopy-->

Katalog mit einer vorbereiteten Image-Versionsspezifikation aktualisieren

Sie können einen Katalog mit dem Befehl Set-ProvSchemeImage aktualisieren. Zum Beispiel:

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

Oder:

Set-ProvSchemeImage -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess]
<!--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
<!--NeedCopy-->

Imagedefinition, Image-Version und vorbereitete Image-Versionsspezifikation löschen

Beachten Sie Folgendes, bevor Sie eine Imagedefinition, Image-Version und vorbereitete Image-Versionsspezifikation löschen:

  • Eine Imagedefinition 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 vorbereiteten Image-Versionsspezifikation verwendet wird.
  • Eine vorbereitete Image-Versionsspezifikation kann nicht gelöscht werden, wenn sie von einem Bereitstellungsschema verwendet wird.

Die detaillierten Schritte sind wie folgt:

  1. Entfernen Sie eine vorbereitete Image-Versionsspezifikation. Zum Beispiel,

    $PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
<!--NeedCopy-->

    Hinweis:

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

  2. Entfernen Sie die Master-Image-Versionsspezifikation. Zum Beispiel,

    $MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"
Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
<!--NeedCopy-->

  3. Entfernen Sie eine Image-Version. Zum Beispiel,

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

  4. Entfernen Sie eine Image-Definition. Zum Beispiel,

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

Beispiel für den vollständigen Satz von PowerShell-Befehlen:

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
$Task = Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
$MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"
$Task = Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1
Remove-ProvImageDefinition -ImageDefinitionName image1
<!--NeedCopy-->

Image-Definition und Image-Version verwalten

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. Zum 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. Zum Beispiel:

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

    Oder,

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

  • Eine Image-Version mit dem Befehl Set-ProvImageVersion bearbeiten. Zum Beispiel:

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

    Oder,

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

Image-Definition, Image-Version, Spezifikation der vorbereiteten Image-Version und Details des Bereitstellungsschemas abrufen

  • Details der Image-Definition mit dem Befehl Get-ProvImageDefinition abrufen. Zum Beispiel:

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

  • Details der Image-Version mit dem Befehl Get-ProvImageVersion abrufen. Zum Beispiel:

    • Um Image-Versionen in einer Image-Definition aufzulisten,

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

      Oder,

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

    • Um ein Detail einer Image-Version abzurufen,

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

      Oder,

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

  • Spezifikation der vorbereiteten Image-Version mit dem Befehl Get-ProvImageVersionSpec abrufen. Zum Beispiel:

    • Um alle Spezifikationen der vorbereiteten Image-Versionen in einer Image-Version aufzulisten,

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

    • Um Spezifikationen der Master-Image-Version in einer Spezifikation der vorbereiteten Image-Version aufzulisten,

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

    • Um Spezifikationen der vorbereiteten Image-Versionen in einer Image-Version aufzulisten, die mit einem Master-Image verknüpft ist,

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

    • Um erfolgreiche Spezifikationen der vorbereiteten Image-Versionen in einer Image-Version abzurufen,

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

    • Um ein Detail einer Spezifikation der vorbereiteten Image-Version abzurufen,

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

  • Details des Bereitstellungsschemas mithilfe des Get-ProvScheme-Befehls abrufen. Zum Beispiel:

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

  • Den Verlauf der Spezifikation der vorbereiteten Image-Version eines Bereitstellungsschemas mithilfe des Get-ProvSchemeImageVersionSpecHistory-Befehls abrufen. Zum Beispiel:

     Get-ProvSchemeImageVersionSpecHistory [-ProvisioningSchemeName <String>] [-ProvisioningSchemeUid <Guid>] [-ImageVersionSpecUid <Guid>] [-ImageVersionSpecHistoryUid <Guid>] [-ReturnTotalRecordCount] [-MaxRecordCount <Int32>] [-Skip <Int32>] [-SortBy <String>] [-Filter <String>] [-FilterScope <Guid>]
 <!--NeedCopy-->
Imageverwaltung
June 5, 2026
Beitrag von: 
C
June 5, 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.