Image-Verwaltung (Vorschau)

Einführung

Der MCS-Katalogerstellungs- oder -Aktualisierungsprozess besteht aus zwei Phasen:

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

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

Sie können verschiedene MCS-Image-Versionen (Vorbereitetes Image) aus einem einzigen Quellimage 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 Image-Verwaltungsfunktion 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.

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 Master-Phase vom gesamten Workflow zur Katalogerstellung oder -aktualisierung und unterteilt den Prozess in zwei Stufen:

1. Erstellen Sie vorbereitete Images aus einem einzigen Quell-Image.
2. Verwenden Sie das vorbereitete Image, 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:

Image-Definition: Image-Definitionen sind eine logische Gruppierung von Versionen eines Images. Die Image-Definition enthält Informationen über:

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

Ein Katalog wird nicht aus einer Imagestruktur erstellt, sondern aus den Imageversionen, die auf der Imagestruktur basieren.

Imageversion: Imageversionen verwalten die Versionierung für die Imagestruktur. Eine Imagestruktur 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.

An der Tech Preview teilnehmen

Wenn Sie an der Teilnahme an der Tech Preview interessiert sind, geben Sie bitte Ihre Kontaktdaten hier an.

Wir helfen Ihnen bei der Einrichtung der Testumgebung und bieten bei Bedarf technischen Support.

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

Image-Lebenszyklusverwaltung mit Web Studio

Der Lebenszyklus des Images bei Verwendung von Web Studio ist:

1. Ein vorbereitetes Image erstellen: Erstellen Sie eine Imagedefinition und deren anfängliche Imageversion.
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. Imagedefinitionen und -versionen verwalten: Bearbeiten Sie den Namen und die Beschreibung von Imageversionen sowie die Beschreibung einer Imagedefinition.
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
• PowerShell-Befehle

Web Studio verwenden

Siehe die folgenden Themen:

• Den Knoten “Bilder” verstehen
• Eine Bilddefinition und die erste Bildversion erstellen
• Bildversionen erstellen
• Maschinenkatalog über den Knoten “Bilder” erstellen
• Maschinenkatalog über den Knoten “Maschinenkataloge” erstellen
• Maschinenkatalog mit einem anderen vorbereiteten Image aktualisieren
• Bilddefinitionen und -versionen verwalten

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:

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

Eine 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 die Option Ressourcen und ein Masterimage aus, das als Vorlage für die Erstellung 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, stellen Sie sicher, dass auf dem Masterimage VDA 2311 oder höher 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 vorausgewä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 gilt: Wenn Sie ein Maschinenprofil auswählen, wird die vom Maschinenprofil abgeleitete Anzahl virtueller CPUs angezeigt, und diese ist unveränderlich. 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 gilt: 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 unveränderlich.

   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 einen, wird der CMEK aus dem Masterimage vorausgewählt.
8. Geben Sie auf der Seite Versionsbeschreibung eine Beschreibung für die erstellte anfängliche Imageversion ein.
9. Auf der Seite Zusammenfassung überprüfen Sie die Details der Image-Definition und der erstellten anfänglichen Image-Version. Geben Sie einen Namen und eine Beschreibung für die Image-Definition 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.

Um Image-Versionen aus der anfänglichen Image-Version zu erstellen, gehen Sie wie folgt vor:

Hinweis:

Die Hosting-Einheit aller Image-Versionen muss dieselbe 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 anfä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.

Einen Maschinenkatalog aus dem Images-Knoten erstellen

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

Alternativ können Sie die Version beim Erstellen eines Katalogs im Knoten Maschinenkataloge auswählen, indem Sie auf die Option für das vorbereitete Image im Workflow zur Katalogerstellung verweisen. Siehe Maschinenkatalog aus dem Knoten Maschinenkataloge erstellen

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

1. Wählen Sie eine Image-Version aus und klicken Sie auf Katalog erstellen. Klicken Sie auf der Seite Einführung auf Weiter.
2. Auf der Seite Desktop-Erfahrung wählen Sie die gewünschte Desktop-Erfahrung aus.
3. Von der Seite Image bis zur Seite Disk Settings 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. Schließen Sie die Einstellungen auf den folgenden Seiten ab.
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.

Maschinenkatalog vom Knoten „Maschinenkataloge“ erstellen

Um einen MCS-Maschinenkatalog vom Knoten Maschinenkataloge 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 jeweils auf Weiter.
3. Auf der Seite Image:
   1. Wählen Sie Vorbereitetes Image aus.
   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 Versionsnummer, die unterstrichen ist.
   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. Wenn auf der Seite Datenträgereinstellungen das ausgewählte vorbereitete Image einen Datenträgerverschlüsselungssatz verwendet, können Sie 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 vorhandene 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.

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.
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 Image-Änderungen eines Katalogs 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 Image-Verlauf anzeigen.

Image-Definitionen und -Versionen verwalten

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

Image-Definition bearbeiten

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

Um eine Image-Definition zu bearbeiten, führen Sie folgende Schritte aus:

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

Image-Version bearbeiten

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

Um eine Image-Version zu bearbeiten, führen Sie folgende Schritte aus:

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

Image-Version löschen

Um eine Image-Version zu löschen, führen Sie folgende Schritte aus:

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.

Image-Definition löschen

Um eine Image-Definition zu löschen, gehen Sie wie folgt vor:

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.

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, die für Ihre Umgebung erforderlich ist.

Master-Image-Versionsspezifikation: Eine Master-Image-Versionsspezifikation ist ein bestimmtes 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, die 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. Ein Bereitstellungsschema mit dem Parameter der Spezifikation der vorbereiteten Image-Version Uid mithilfe des New-ProvScheme Befehls erstellen.
   4. Den Broker-Katalog mit dem Bereitstellungsschema verknüpfen.
3. VMs im MCS-Maschinenkatalog erstellen.
4. Die Spezifikation der vorbereiteten Image-Version eines Bereitstellungsschemas mithilfe des Set-ProvScheme Befehls ändern.
5. Die Image-Definitionen und -Versionen verwalten: Die Image-Versionen und Image-Definitionen bearbeiten.
6. Einen MCS-Maschinenkatalog löschen: Die Löschreihenfolge ist: Spezifikation der vorbereiteten Image-Version > Spezifikation der Master-Image-Version > Image-Version > Image-Definition. Stellen Sie vor dem Löschen der Spezifikation der Image-Version 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

• Einen Katalog mithilfe der Spezifikation der vorbereiteten Image-Version erstellen

• Einen Katalog mithilfe einer Spezifikation der vorbereiteten Image-Version aktualisieren

• Image-Definition, Image-Version und Spezifikation der vorbereiteten Image-Version löschen

• Image-Definition und Image-Version verwalten

• Details zu Image-Definition, Image-Version, Spezifikation der vorbereiteten Image-Version und Bereitstellungsschema abrufen

Vorbereitetes Image erstellen

Die detaillierten PowerShell-Befehle zum Erstellen einer vorbereiteten Image-Versionsspezifikation lauten wie folgt:

1. Überprüfen Sie die verfügbaren Namen der Imagedefinitionen mit Test-ProvImageDefinitionNameAvailable command. Zum Beispiel:

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

2. Erstellen Sie eine Imagedefinition mit dem Befehl New-ProvImageDefinition. Zum Beispiel:

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

3. Erstellen Sie eine Imageversion mit dem Befehl New-ProvImageVersion. Zum Beispiel:

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

4. Fügen Sie der Imageversion eine Master-Image-Versionsspezifikation mit dem Befehl 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 Imageversion für eine Hosting-Einheit hinzufügen.

5. Erstellen Sie eine vorbereitete Image-Versionsspezifikation aus der Master-Image-Versionsspezifikation mit dem Befehl 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 Imagedefinition, Imageversion und 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 Imagedefinition, Imageversion und 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 Imagedefinition 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 mithilfe einer vorbereiteten Image-Versionsspezifikation erstellen

Erstellen Sie einen MCS-Maschinenkatalog aus der vorbereiteten Image-Versionsspezifikation mithilfe des Befehls 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 mithilfe einer vorbereiteten Image-Versionsspezifikation aktualisieren

Sie können einen Katalog mithilfe des Befehls 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-->

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

Beachten Sie Folgendes, bevor Sie eine Image-Definition, Image-Version und vorbereitete Image-Versionsspezifikation 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 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:

   Eine 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 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 Image-Definition mit dem Set-ProvImageDefinition Befehl. Zum Beispiel:

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

  Oder,

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

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

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

  Oder,

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

Details zu Image-Definition, Image-Version, vorbereiteter Image-Versionsspezifikation und Bereitstellungsschema abrufen

• Rufen Sie Details zur Image-Definition mit dem Get-ProvImageDefinition Befehl ab. Zum Beispiel:

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

• Rufen Sie Details zur Image-Version mit dem Get-ProvImageVersion Befehl ab. 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-->
    

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

  • Um alle vorbereiteten Image-Versionsspezifikationen in einer Image-Version aufzulisten,

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

  • Um Master-Image-Versionsspezifikationen in einer vorbereiteten Image-Versionsspezifikation aufzulisten,

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

  • Um vorbereitete Image-Versionsspezifikationen 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 für vorbereitete Image-Versionen in einer Image-Version zu erhalten,

     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 Spezifikation für eine vorbereitete Image-Version zu erhalten,

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

• Details zum Bereitstellungsschema 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-->
  

• Verlauf der Spezifikation für vorbereitete Image-Versionen 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-->