Produktdokumentation
Citrix Virtual Apps and Desktops
Current Release Service 2511 2507 LTSR 2503 2411 2407 2402 LTSR 2311 2203 LTSR

Microsoft Azure-Katalog verwalten

June 5, 2026
Beitrag von: 
C

(/de-de/citrix-virtual-apps-desktops/2511/install-configure/machine-catalogs-manage.html) beschreibt die Assistenten, die einen Maschinenkatalog verwalten. Die folgenden Informationen behandeln Details, die spezifisch für Microsoft Azure Resource Manager-Cloudumgebungen sind.

Hinweis:

Bevor Sie einen Microsoft Azure-Katalog verwalten, müssen Sie die Erstellung eines Microsoft Azure-Katalogs abgeschlossen haben. Siehe (/de-de/citrix-virtual-apps-desktops/2511/install-configure/machine-catalogs-create/create-machine-catalog-citrix-azure.html).

Speichertyp beim Herunterfahren einer VM auf eine niedrigere Stufe ändern

Sie können Speicherkosten sparen, indem Sie den Speichertyp eines verwalteten Datenträgers auf eine niedrigere Stufe umstellen, wenn Sie eine VM herunterfahren. Verwenden Sie dazu die benutzerdefinierte Eigenschaft StorageTypeAtShutdown.

Der Speichertyp des Datenträgers wechselt zu einer niedrigeren Stufe (wie in der benutzerdefinierten Eigenschaft StorageTypeAtShutdown angegeben), wenn Sie die VM herunterfahren. Nachdem Sie die VM eingeschaltet haben, wechselt der Speichertyp zurück zum ursprünglichen (wie in der benutzerdefinierten Eigenschaft StorageType oder der benutzerdefinierten Eigenschaft WBCDiskStorageType angegeben).

Wichtig:

Der Datenträger existiert erst, wenn die VM mindestens einmal eingeschaltet wurde. Daher können Sie den Speichertyp beim ersten Einschalten der VM nicht ändern.

Anforderungen

  • Anwendbar auf einen verwalteten Datenträger. Dies bedeutet, dass Sie die benutzerdefinierte Eigenschaft UseManagedDisks auf „true“ setzen.
  • Anwendbar auf einen persistenten und nicht-persistenten Katalog mit einem persistenten Betriebssystemdatenträger. Dies bedeutet, dass Sie die benutzerdefinierte Eigenschaft persistOsDisk auf „true“ setzen.
  • Anwendbar auf einen nicht-persistenten Katalog mit einem persistenten WBC-Datenträger. Dies bedeutet, dass Sie die benutzerdefinierte Eigenschaft persistWBC auf „true“ setzen.

Einschränkung

  • Laut Microsoft können Sie den Datenträgertyp nur zweimal pro Tag ändern. Siehe das Microsoft-Dokument. Laut Citrix erfolgt die StorageType-Aktualisierung, wann immer eine Start- oder Deallocate-Aktion für die VM ausgeführt wird. Beschränken Sie daher die Anzahl der Energieaktionen pro VM auf zweimal pro Tag. Zum Beispiel eine Energieaktion am Morgen zum Starten der VM und eine am Abend zum Freigeben der VM.

Speichertyp in eine niedrigere Stufe ändern

Bevor Sie mit den Schritten fortfahren, beachten Sie die Anforderungen und Einschränkung.

  1. Fügen Sie die benutzerdefinierte Eigenschaft StorageTypeAtShutdown hinzu, setzen Sie den Wert auf Standard_LRS (HDD), und erstellen Sie einen Katalog mit New-ProvScheme. Informationen zum Erstellen eines Katalogs mit PowerShell finden Sie unter https://developer-docs.citrix.com/projects/citrix-virtual-apps-desktops-sdk/en/latest/creating-a-catalog/.

    Hinweis:

    Wenn StorageTypeAtShutdown einen anderen Wert als leer oder Standard_LRS (HDD) hat, schlägt der Vorgang fehl.

    Beispiel für das Festlegen benutzerdefinierter Eigenschaften beim Erstellen eines persistenten Katalogs:

    $customProperties='<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="UseManagedDisks" Value="true" />
<Property xsi:type="StringProperty" Name="StorageType" Value="Premium_LRS" />
<Property xsi:type="StringProperty" Name="ResourceGroups" Value="" />
<Property xsi:type="StringProperty" Name="LicenseType" Value="Windows_Client" />
<Property xsi:type="StringProperty" Name="SchemaVersion" Value="2" />
<Property xsi:type="StringProperty" Name="OsType" Value="Windows" />
<Property xsi:type="StringProperty" Name="StorageTypeAtShutdown" Value="Standard_LRS" />
</CustomProperties>'
<!--NeedCopy-->

    Beispiel für das Festlegen benutzerdefinierter Eigenschaften beim Erstellen eines nicht-persistenten Katalogs:

    $customProperties='<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="UseManagedDisks" Value="true" />
<Property xsi:type="StringProperty" Name="StorageType" Value="Premium_LRS" />
<Property xsi:type="StringProperty" Name="WbcDiskStorageType" Value="Standard_SSD_LRS" />
<Property xsi:type="StringProperty" Name="ResourceGroups" Value="" />
<Property xsi:type="StringProperty" Name="LicenseType" Value="Windows_Client" />
<Property xsi:type="StringProperty" Name="SchemaVersion" Value="2" />
<Property xsi:type="StringProperty" Name="OsType" Value="Windows" />
<Property xsi:type="BooleanProperty" Name="persistWBC" Value=true />
<Property xsi:type="BooleanProperty" Name="persistOsDisk" Value=true />
<Property xsi:type="StringProperty" Name="StorageTypeAtShutdown" Value="Standard_LRS" />
</CustomProperties>'
<!--NeedCopy-->

    Hinweis:

    Wenn Sie ein Maschinenprofil verwenden, hat die benutzerdefinierte Eigenschaft Vorrang vor der in MachineProfile definierten Eigenschaft.

  2. Fahren Sie die VM herunter und überprüfen Sie den Speichertyp der VM im Azure-Portal. Der Speichertyp des Datenträgers ändert sich in eine niedrigere Stufe, wie in der benutzerdefinierten Eigenschaft StorageTypeAtShutdown angegeben.
  3. Schalten Sie die VM ein. Der Speichertyp des Datenträgers wechselt zurück zu dem Speichertyp, der angegeben ist in:
    • Benutzerdefinierte Eigenschaft StorageType für das OS-Datenträger
    • Benutzerdefinierte Eigenschaft WBCDiskStorageType für den WBC-Datenträger, nur wenn Sie sie in CustomProperties angeben. Andernfalls wechselt sie zurück zu dem Speichertyp, der in StorageType angegeben ist.

StorageTypeAtShutdown auf einen vorhandenen Katalog anwenden

Bevor Sie mit den Schritten fortfahren, beachten Sie die Anforderungen und Einschränkung.

Verwenden Sie Set-ProvScheme, um eine VM zu einem vorhandenen Katalog hinzuzufügen. Die Funktion gilt für neue VMs, die nach dem Ausführen von Set-ProvScheme hinzugefügt wurden. Die vorhandenen Maschinen sind davon nicht betroffen.

Beispiel für das Festlegen benutzerdefinierter Eigenschaften beim Hinzufügen einer VM zu einem vorhandenen Katalog:

$customProperties='<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="UseManagedDisks" Value="true" />
<Property xsi:type="StringProperty" Name="StorageType" Value="Premium_LRS" />
<Property xsi:type="StringProperty" Name="WbcDiskStorageType" Value="Standard_SSD_LRS" />
<Property xsi:type="StringProperty" Name="ResourceGroups" Value="" />
<Property xsi:type="StringProperty" Name="LicenseType" Value="Windows_Client" />
<Property xsi:type="StringProperty" Name="SchemaVersion" Value="2" />
<Property xsi:type="StringProperty" Name="OsType" Value="Windows" />
<Property xsi:type="BooleanProperty" Name="persistWBC" Value=true />
<Property xsi:type="BooleanProperty" Name="persistOsDisk" Value=true />
<Property xsi:type="StringProperty" Name="StorageTypeAtShutdown" Value="Standard_LRS" />
</CustomProperties>'

$ProvScheme = Get-Provscheme -ProvisioningSchemeName $CatalogName

Set-ProvScheme -ProvisioningSchemeName $ProvScheme.ProvisioningSchemeName -CustomProperties $customProperties
<!--NeedCopy-->

Speichertyp vorhandener VMs beim Herunterfahren auf eine niedrigere Stufe ändern

Bevor Sie mit den Schritten fortfahren, siehe die Anforderungen und Einschränkung.

Sie können Speicherkosten sparen, indem Sie den Speichertyp vorhandener VMs beim Herunterfahren der VMs auf eine niedrigere Stufe ändern. Verwenden Sie dazu die benutzerdefinierte Eigenschaft StorageTypeAtShutdown.

So ändern Sie den Speichertyp vorhandener Maschinen in einem Katalog beim Herunterfahren der VMs auf eine niedrigere Stufe:

  1. Öffnen Sie ein PowerShell-Fenster.
  2. Führen Sie asnp citrix®* aus, um die Citrix-spezifischen PowerShell-Module zu laden.
  3. Führen Sie Get-Provscheme -ProvisioningSchemeName $CatalogName aus.

  4. Ändern Sie die Zeichenfolge der benutzerdefinierten Eigenschaften.

    $customProperties = '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="StorageTypeAtShutdown" Value="Standard_LRS" />
</CustomProperties>'
<!--NeedCopy-->

  5. Aktualisieren Sie das Bereitstellungsschema des vorhandenen Katalogs. Die Aktualisierung gilt für neue VMs, die nach dem Ausführen von Set-ProvScheme hinzugefügt wurden.

    Set-ProvScheme -ProvisioningSchemeName $CatalogName -CustomProperties $customProperties
<!--NeedCopy-->

  6. Aktualisieren Sie die vorhandenen VMs, um StorageTypeAtShutdown zu aktivieren.

    Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName $CatalogName -StartsNow -DurationInMinutes -1
<!--NeedCopy-->
  7. Wenn Sie die Maschinen das nächste Mal einschalten, wird die Eigenschaft StorageTypeAtShutdown der Maschinen aktualisiert. Der Speichertyp ändert sich beim nächsten Herunterfahren.

  8. Führen Sie den folgenden Befehl aus, um den Wert StorageTypeAtShutdown für jede VM in einem Katalog anzuzeigen:

    Get-ProvVM -ProvisioningSchemeName <catalog-name> | foreach { $vmName = $_.VMName; $storageTypeAtShutdown = ($_.CustomVmData | ConvertFrom-Json).StorageTypeAtShutdown.DiskStorageAccountType; return New-Object psobject -Property @{ "VMName" = $vmName; "StorageTypeAtShutdown" = $storageTypeAtShutdown } }
<!--NeedCopy-->

Bereitgestellte Maschinen auf den aktuellen Zustand des Bereitstellungsschemas aktualisieren

Der Befehl Set-ProvScheme ändert das Bereitstellungsschema. Er wirkt sich jedoch nicht auf vorhandene Maschinen aus. Mit dem PowerShell-Befehl Set-ProvVMUpdateTimeWindow können Sie das aktuelle Bereitstellungsschema auf eine vorhandene persistente oder nicht-persistente Maschine oder eine Gruppe von Maschinen anwenden. Sie können auch einen Zeitrahmen für die Konfigurationsaktualisierungen der vorhandenen MCS-bereitgestellten Maschinen planen. Jedes Einschalten oder Neustarten während des geplanten Zeitrahmens wendet ein geplantes Bereitstellungsschema-Update auf eine Maschine an. Derzeit können Sie in Azure ServiceOffering, MachineProfile und die folgenden benutzerdefinierten Eigenschaften aktualisieren:

  • StorageType
  • WBCDiskStorageType
  • IdentityDiskStorageType
  • LicenseType
  • DedicatedHostGroupId
  • PersistWBC
  • PersistOsDisk
  • PersistVm

Hinweis:

  • Sie können nur die benutzerdefinierten Eigenschaften StorageType, WBCDiskStorageType und IdentityDiskStorageType für einen Katalog aktualisieren, der verwaltete Datenträger in Azure-Umgebungen verwendet.
  • Wenn Sie Set-ProvVMUpdateTimeWindow zweimal ausführen, wird der zuletzt ausgeführte Befehl wirksam.

Sie können aktualisieren:

  • Eine einzelne VM
  • Eine Liste spezifischer VMs oder alle vorhandenen VMs, die einer Bereitstellungsschema-ID zugeordnet sind
  • Eine Liste spezifischer VMs oder aller vorhandenen VMs, die einem Bereitstellungsschema-Namen (Maschinenkatalogname) zugeordnet sind

Nachdem Sie die folgenden Änderungen am Bereitstellungsschema vorgenommen haben, wird die VM-Instanz für persistente Kataloge in Azure neu erstellt:

  • Ändern Sie die MachineProfile
  • Entfernen Sie LicenseType
  • Entfernen Sie DedicatedHostGroupId

Hinweis:

Die Betriebssystemfestplatte vorhandener Maschinen bleibt zusammen mit all ihren Daten unverändert, und eine neue VM wird an die Festplatte angehängt.

Vor dem Aktualisieren der vorhandenen VMs:

  1. Überprüfen Sie die Konfiguration der vorhandenen Maschinen. Zum Beispiel:

    Get-ProvScheme | select ProvisioningSchemeName, ProvisioningSchemeVersion
<!--NeedCopy-->

  2. Aktualisieren Sie das Bereitstellungsschema. Zum Beispiel:

    • Mit VM als Maschinenprofileingabe:

       Set-ProvScheme -ProvisioningSchemeName "my-catalog" -MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\machineprofile.folder\<resource-group>.resourcegroup\<virtual-machine>.vm"
 <!--NeedCopy-->

    • Mit Vorlagenspezifikation als Maschinenprofileingabe:

       Set-ProvScheme -ProvisioningSchemeName "my-catalog"
 -MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\machineprofile.folder\<resource-group>.resourcegroup\<template-spec>.templatespec\<template-spec-version>.templatespecversion"
 -ServiceOffering "XDHyp:\HostingUnits\<hosting-unit>\serviceoffering.folder\<service-offering>.serviceoffering"
 <!--NeedCopy-->

    • Nur mit Service Offering:

       Set-ProvScheme -ProvisioningSchemeName "my-catalog" -ServiceOffering "XDHyp:\HostingUnits\<hosting-unit>\serviceoffering.folder\<service-offering>.serviceoffering"
 <!--NeedCopy-->

  3. Überprüfen Sie, ob die aktuelle Eigenschaft der VM mit dem aktuellen Bereitstellungsschema übereinstimmt und ob eine ausstehende Aktualisierungsaktion für die VM vorliegt. Zum Beispiel:

    Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion
<!--NeedCopy-->

    Sie können auch Maschinen mit einer bestimmten Version finden. Zum Beispiel:

    Get-ProvVM -Filter "ProvisioningSchemeVersion -eq 1" | select VMName, ProvisioningSchemeVersion
<!--NeedCopy-->

So fordern Sie Updates für vorhandene Maschinen an, die beim nächsten Neustart angewendet werden sollen:

  1. Führen Sie die folgenden Befehle aus, um vorhandene Maschinen zu aktualisieren und die Updates beim nächsten Neustart anzuwenden.

    • So aktualisieren Sie alle vorhandenen Maschinen. Zum Beispiel:

       Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
 <!--NeedCopy-->

    • So aktualisieren Sie eine Liste bestimmter Maschinen. Zum Beispiel:

       Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -VMName <List-Of-Vm-Names> -StartsNow -DurationInMinutes -1
 <!--NeedCopy-->

    • So aktualisieren Sie Maschinen basierend auf der Ausgabe von Get-ProvVM. Zum Beispiel:

       Get-ProvVM -ProvisioningSchemeName "my-catalog" | Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
 <!--NeedCopy-->

    Hinweis:

    • StartsNow gibt an, dass die geplante Startzeit die aktuelle Zeit ist.
    • DurationInMinutes mit einer negativen Zahl (z. B. –1) bedeutet keine Obergrenze für das Zeitfenster des Zeitplans.

  2. Suchen Sie Maschinen mit einem geplanten Update. Zum Beispiel:

    Get-ProvVM -Filter "ProvisioningSchemeUpdateAfter" | select VMName, ProvisioningSchemeUpdateAfter
<!--NeedCopy-->

  3. Starten Sie die Maschinen neu. Beim nächsten Einschalten werden Eigenschaftsänderungen auf die vorhandenen Maschinen angewendet. Sie können den aktualisierten Status mit dem folgenden Befehl überprüfen. Zum Beispiel:

    Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion
<!--NeedCopy-->

So planen Sie, dass eine VM beim nächsten Start im geplanten Zeitfenster auf die neuesten Bereitstellungseinstellungen aktualisiert wird:

  1. Führen Sie die folgenden Befehle aus:

    • So planen Sie ein Update mit der aktuellen Zeit als Startzeit

       Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -VMName vm1 -StartsNow -DurationInMinutes 120
 <!--NeedCopy-->

    • So planen Sie ein Update am Wochenende

       Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName “ my-catalog “ -VMName “vm1” -StartTimeInUTC “10/15/2022 9:00am” -DurationInMinutes (New –TimeSpan –Days 2).TotalMinutes
 <!--NeedCopy-->

    Hinweis:

    • VMName ist optional. Wenn nicht angegeben, wird das Update für den gesamten Katalog geplant.
    • Verwenden Sie anstelle von StartTimeInUTC den Wert StartsNow, um anzugeben, dass die Startzeit des Zeitplans die aktuelle Zeit ist.
    • DurationInMinutes ist optional. Standardwert ist 120 Minuten. Eine negative Zahl (z. B. –1) bedeutet keine Obergrenze für das Zeitfenster des Zeitplans.

  2. Überprüfen Sie den Updatestatus.

    Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeUpdateUntil, ProvisioningSchemeVersion
<!--NeedCopy-->

  3. Schalten Sie die VM ein. Wenn Sie die Maschine nach dem geplanten Zeitfenster einschalten, wird das Konfigurationsupdate nicht angewendet. Wenn Sie die Maschine innerhalb des geplanten Zeitfensters einschalten,

    • Wenn die Maschine ausgeschaltet ist und

      • Sie die Maschine nicht einschalten, wird das Konfigurationsupdate nicht angewendet
      • Sie die Maschine einschalten, wird das Konfigurationsupdate angewendet

    • Wenn die Maschine eingeschaltet ist und

      • Sie die Maschine nicht neu starten, wird das Konfigurationsupdate nicht angewendet
      • Sie die Maschine neu starten, wird das Konfigurationsupdate angewendet

So brechen Sie das Konfigurationsupdate ab:

Sie können auch ein Konfigurationsupdate einer einzelnen VM, mehrerer VMs oder eines gesamten Katalogs abbrechen. So brechen Sie ein Konfigurationsupdate ab:

  1. Führen Sie Clear-ProvVMUpdateTimeWindow aus. Beispiel:

    • So brechen Sie das für eine einzelne VM geplante Konfigurationsupdate ab:

        Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName “ my-catalog “ -VMName “vm1”
  <!--NeedCopy-->

    • So brechen Sie die für mehrere VMs geplante Konfigurationsaktualisierung ab:

       Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName "my-catalog" -VMName "vm1","vm2"
 <!--NeedCopy-->

      Hinweis:

      Die VMs müssen aus demselben Katalog stammen.

Eigenschaften einzelner VMs aktualisieren

Sie können die Eigenschaften einzelner VMs in einem persistenten MCS-Maschinenkatalog mithilfe des PowerShell-Befehls Set-ProvVM aktualisieren. Die Updates werden jedoch nicht sofort angewendet. Sie müssen das Zeitfenster mithilfe des PowerShell-Befehls Set-ProvVMUpdateTimeWindow festlegen, damit die Updates angewendet werden.

Diese Implementierung hilft Ihnen, einzelne VMs effizient zu verwalten, ohne den gesamten Maschinenkatalog zu aktualisieren. Derzeit ist diese Funktion nur in der Azure-Umgebung anwendbar.

Derzeit können Sie folgende Eigenschaften aktualisieren:

  • CustomProperties
  • ServiceOffering
  • MachineProfile

Mit dieser Funktion können Sie:

Vor dem Aktualisieren der Eigenschaften einer VM:

  1. Öffnen Sie ein PowerShell-Fenster.
  2. Führen Sie asnp citrix* aus, um die Citrix-spezifischen PowerShell-Module zu laden.

  3. Überprüfen Sie die Konfiguration des vorhandenen Maschinenkatalogs. Beispiel:

    Get-ProvScheme -ProvisioningSchemeName AzureCatalog
<!--NeedCopy-->

  4. Überprüfen Sie die Konfiguration der VM, auf die Sie die Updates anwenden möchten. Beispiel:

    Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
<!--NeedCopy-->

Eigenschaften einer VM aktualisieren

Gehen Sie wie folgt vor, um die Eigenschaften einer VM zu aktualisieren:

  1. Schalten Sie die VM aus, auf die Sie die Updates anwenden möchten.

  2. Aktualisieren Sie die Eigenschaften der VM. Wenn Sie beispielsweise die benutzerdefinierte Eigenschaft Speichertyp (StorageType) der VM aktualisieren möchten, führen Sie Folgendes aus:

    Set-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1 -CustomProperties "...<Property Name='StorageType' Value='Premium_LRS' />..."
<!--NeedCopy-->

    Sie können die Eigenschaften von zwei VMs in einem Maschinenkatalog gleichzeitig aktualisieren. Beispiel:

    Set-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1 -CustomProperties "...<Property Name='StorageType' Value='Premium_LRS' />..."
<!--NeedCopy-->

    Set-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine2 -CustomProperties "...<Property Name='StorageType' Value='StandardSSD_LRS' />..."
<!--NeedCopy-->

    Hinweis:

    Die Updates werden nicht sofort angewendet.

  3. Rufen Sie die Liste der zur Aktualisierung angegebenen Eigenschaften und die Konfigurationsversion ab. Beispiel:

    Get-ProvVMConfiguration -ProvisioningSchemeName AzureCatalog -VMName machine1
<!--NeedCopy-->

    Überprüfen Sie den Eigenschaftswert von Version und die zu aktualisierenden Eigenschaften (in diesem Fall StorageType).

  4. Überprüfen Sie die Konfigurationsversion. Beispiel:

    Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
<!--NeedCopy-->

    Überprüfen Sie den Eigenschaftswert von ProvVMConfigurationVersion. Das Update wurde noch nicht angewendet. Die VM befindet sich noch in der alten Konfiguration.

  5. Geplante Aktualisierung anfordern. Zum Beispiel:

     Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName AzureCatalog -StartsNow -DurationInMinutes -1
 <!--NeedCopy-->

    Weitere Informationen zu geplanten Updates finden Sie unter Bereitgestellte Maschinen auf den aktuellen Bereitstellungsschemastatus aktualisieren.

    Hinweis:

    Alle ausstehenden Updates des Bereitstellungsschemas werden ebenfalls angewendet.

  6. Starten Sie die VM neu. Zum Beispiel:

    New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
<!--NeedCopy-->

  7. Überprüfen Sie die Konfigurationsversion. Zum Beispiel:

    Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
<!--NeedCopy-->

    Überprüfen Sie den Eigenschaftswert von ProvVMConfigurationVersion. Das Update wurde nun angewendet. Die VM verfügt jetzt über die neue Konfiguration.

  8. Um weitere Konfigurationsupdates auf die VM anzuwenden, schalten Sie die VM aus und wiederholen Sie die Schritte.

Beibehalten der auf einer VM aktualisierten Eigenschaften nach der Aktualisierung des Maschinenkatalogs

Gehen Sie wie folgt vor, um die auf einer VM aktualisierten Eigenschaften beizubehalten:

  1. Schalten Sie die VM aus, auf die Sie die Updates anwenden möchten.

  2. Aktualisieren Sie den Maschinenkatalog. Wenn Sie beispielsweise die VM-Größe (ServiceOffering) und den Speichertyp (StorageType) ändern möchten, führen Sie Folgendes aus:

    Set-ProvScheme -ProvisioningSchemeName AzureCatalog -ServiceOffering Standard_E4_v3 -CustomProperties "...<Property Name='StorageType' Value='StandardSSD_LRS' />..."
<!--NeedCopy-->

  3. Rufen Sie die Konfigurationsdetails des Maschinenkatalogs ab. Zum Beispiel:

    Get-ProvScheme -ProvisioningSchemeName AzureCatalog
<!--NeedCopy-->

    Der ProvisioningSchemeVersion wird nun um eins erhöht. Die VM-Größe und der Speichertyp werden ebenfalls aktualisiert.

  4. Aktualisieren Sie die Eigenschaften der VM. Geben Sie beispielsweise ein Maschinenprofil für die VM an.

    Set-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1 -MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\machineprofile.folder\<resource-group>.resourcegroup\<template-spec>.templatespec\<template-spec-version>.templatespecversion"
<!--NeedCopy-->

    Hinweis:

    Die Eingabe des Maschinenprofils hat ein Tag und eine andere VM-Größe (ServiceOffering) angegeben.

  5. Rufen Sie die Liste der Eigenschaften ab, die die VM nach dem Zusammenführen der Konfigurationsaktualisierungen auf der VM mit den Maschinenkatalogaktualisierungen haben wird. Zum Beispiel:

    Get-ProvVMConfigurationResultantSet -ProvisioningSchemeName AzureCatalog -VMName machine1
<!--NeedCopy-->

    Hinweis:

    Alle Aktualisierungen an der VM überschreiben die Aktualisierungen, die am Maschinenkatalog vorgenommen wurden.

  6. Fordern Sie eine geplante Aktualisierung für die VM an. Zum Beispiel:

    Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName AzureCatalog -VMName machine1 -StartsNow -DurationInMinutes -1
<!--NeedCopy-->

  7. Starten Sie die VM neu. Zum Beispiel:

    New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
<!--NeedCopy-->

    Die VM behält ihre aktualisierte VM-Größe, wie sie aus dem Maschinenprofil abgeleitet wurde. Die im Maschinenprofil angegebenen Tag-Werte werden ebenfalls auf die VM angewendet. Der Speichertyp wird jedoch vom neuesten Bereitstellungsschema abgeleitet.

  8. Rufen Sie die Konfigurationsversion der VM ab. Zum Beispiel:

    Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
<!--NeedCopy-->

    Die ProvisioningSchemeVersion und ProvVMConfigurationVersion zeigen nun die neueste Version an.

Konfigurationsaktualisierungen, die auf eine VM angewendet wurden, rückgängig machen

  1. Nachdem Sie die Aktualisierungen auf eine VM angewendet haben, schalten Sie die VM aus.

  2. Führen Sie den folgenden Befehl aus, um die auf die VM angewendeten Aktualisierungen zu entfernen. Zum Beispiel:

    Set-ProvVM -RevertToProvSchemeConfiguration -ProvisioningSchemeName AzureCatalog -VMName machine1
<!--NeedCopy-->

  3. Fordern Sie eine geplante Aktualisierung für die VM an. Zum Beispiel:

    Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName AzureCatalog -VMName machine1 -StartsNow -DurationInMinutes -1
<!--NeedCopy-->

  4. Starten Sie die VM neu. Zum Beispiel:

    New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
<!--NeedCopy-->

  5. Überprüfen Sie die Konfigurationsversion der VM. Zum Beispiel:

    Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
<!--NeedCopy-->

    Der Wert ProvVMConfigurationVersion ist jetzt die Konfigurationsversion des Maschinenkatalogs.

Datenträgerverschlüsselung ändern

Sie können die Datenträgerverschlüsselung in Azure-Virtualisierungsumgebungen ändern und Folgendes tun:

  • Erstellen Sie einen MCS-Maschinenkatalog mit einem Datenträgerverschlüsselungssatz (DES), der sich vom DES des Masterimages unterscheidet, indem Sie den Befehl New-ProvScheme verwenden. Zum Beispiel:

     $customProperties = @"
 <CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <Property xsi:type="DiskEncryptionSetId" Name="Zones" Value="/subscriptions/XXXXXXXXXXXXXXXXXXXXXXXXXXXXX/resourceGroups/testrsg/providers/Microsoft.Compute/diskEncryptionSets/test-diskEncryptionSet"/>
 </CustomProperties>
 "@
 New-ProvScheme -CleanOnBoot `
 -ProvisioningSchemeName $provisioningSchemeName `
 -HostingUnitName $hostingUnitName `
 -IdentityPoolName $identityPoolName `
 -InitialBatchSizeHint $numberOfVms `
 -masterImagePath $masterImagePath `
 -NetworkMapping $networkMapping `
 -CustomProperties $customProperties
 <!--NeedCopy-->

  • Ändern Sie den Datenträgerverschlüsselungstyp von einem DES-Schlüssel zu einem anderen DES-Schlüssel eines vorhandenen MCS-Maschinenkatalogs und vorhandener VMs mithilfe der Befehle Set-ProvScheme und Set-ProvVMUpdateTimeWindow. Nach dem Neustart der VMs sehen Sie den aktualisierten DES-Schlüssel. Zum Beispiel:

     $customProperties = '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <Property xsi:type="StringProperty" Name="DiskEncryptionSetId" Value="/subscriptions/456c683e2ed7/resourceGroups/testrg/providers/Microsoft.Compute/diskEncryptionSets/diskEncryptionSet1" />
 </CustomProperties>'
 Set-ProvScheme -ProvisioningSchemeName azure-catalog -CustomProperties $customProperties
 Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName azure-catalog -VMName azu01, azu02 -StartsNow -DurationInMinutes -1
 <!--NeedCopy-->

  • Aktualisieren Sie einen MCS-Maschinenkatalog und eine VM, die zuvor nicht CMEK-fähig waren, um eine kundenverwaltete Verschlüsselung (CMEK) (DES), Datenträgerverschlüsselung auf dem Host oder doppelte Verschlüsselung mithilfe der Befehle Set-ProvScheme und Set-ProvVMUpdateTimeWindow zu ermöglichen. Informationen zu verschiedenen Verschlüsselungstypen finden Sie unter Azure serverseitige Verschlüsselung, Azure Datenträgerverschlüsselung auf dem Host und Doppelte Verschlüsselung auf verwaltetem Datenträger.

  • Aktualisieren Sie einen vorhandenen MCS-Maschinenkatalog und VMs, die zuvor verschlüsselt waren, um sie unverschlüsselt zu machen, indem Sie die Befehle Set-ProvScheme und Set-ProvVMUpdateTimeWindow verwenden. Zum Beispiel:

     $customProperties = '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <Property xsi:type="StringProperty" Name="DiskEncryptionSetId" Value="" />
 </CustomProperties>'
 Set-ProvScheme -ProvisioningSchemeName azure-catalog -CustomProperties $customProperties
 Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName azure-catalog -VMName azu01, azu02 -StartsNow -DurationInMinutes -1
 <!--NeedCopy-->

  • Aktivieren Sie die Datenträgerverschlüsselung mit privatem Endpunkt (ein MCS-Maschinenkatalog, der eine Hostverbindung mit ProxyHypervisorTrafficThroughConnector verwendet hat). Informationen zum Aktivieren der Datenträgerverschlüsselung mit privaten Endpunkten finden Sie unter Datenträgerverschlüsselung mit privatem Endpunkt aktivieren.

Datenträgerverschlüsselung mit privatem Endpunkt aktivieren

Aufgrund der Azure-Einschränkung ist es derzeit nicht möglich, serverseitige Verschlüsselung mit kundenverwalteten Schlüsseln für private Endpunkte zu verwenden. Sie können jedoch einen vorhandenen MCS-Maschinenkatalog und VMs mit privaten Endpunkten aktualisieren, um sie mit dem DES-Schlüssel zu verschlüsseln.

Vorhandenen Maschinenkatalog mit privaten Endpunkten aktualisieren

Die detaillierten Schritte zum Aktualisieren eines vorhandenen Maschinenkatalogs mit privaten Endpunkten sind wie folgt:

  1. Erstellen Sie einen Katalog ohne Datenträgerverschlüsselung über ProxyHypervisorTrafficThroughConnector.

  2. Führen Sie Set-ProvScheme aus, um den Katalog mit DiskEncryptionSetId zu aktualisieren.

    Hinweis:

    DiskEcryptionSetId kann über CustomProperties oder MachineProfile konfiguriert werden. Wenn es sowohl in CustomProperties als auch in MachineProfile definiert ist, werden die in CustomProperties definierten Eigenschaften angewendet.

    Beispiel bei Verwendung von CustomProperties:

    $customProperties = '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="DiskEncryptionSetId" Value="/subscriptions/456c683e2ed7/resourceGroups/testrg/providers/Microsoft.Compute/diskEncryptionSets/diskEncryptionSet1"/>
</CustomProperties>'
Set-ProvScheme -ProvisioningSchemeName azure-catalog -CustomProperties $customProperties
<!--NeedCopy-->

    Beispiel bei Verwendung von MachineProfile: Verwenden Sie eine VM mit aktivierter Datenträgerverschlüsselung oder eine Vorlagenspezifikation mit Datenträgerverschlüsselungseinstellungen:

    Set-ProvScheme -ProvisioningSchemeName azure-catalog -MachineProfile "XDHyp:\HostingUnits\azureunit\machineprofile.folder\testrg.resourcegroup\new-template.vm"
<!--NeedCopy-->

    Alternativ können Sie ein Maschinenprofil über Web Studio aktualisieren.

  3. Führen Sie Set-ProvVMUpdateTimeWindow aus, um vorhandene Katalog-VMs zu aktualisieren. Zum Beispiel:

    Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName azure-catalog -VMName azu01, azu02 -StartsNow -DurationInMinutes -1
<!--NeedCopy-->
  4. Nachdem Sie die VMs neu gestartet haben, können Sie die aktualisierte Datenträgerverschlüsselung auf den Datenträgern der VM im Azure-Portal sehen.

  5. Führen Sie Set-ProvScheme aus, um die Datenträgerverschlüsselung aufzuheben, bevor Sie neue Katalog-VMs hinzufügen.

    Hinweis:

    Dieser Schritt ist erforderlich, da Sie einen Katalog mit privatem Endpunkt aktualisieren. Wenn Sie diesen Schritt nicht ausführen, erhalten Sie Fehler beim Versuch, neue VMs zum Katalog hinzuzufügen.

    Zum Beispiel:

    $customProperties = '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="DiskEncryptionSetId" Value="" />
</CustomProperties>'
Set-ProvScheme -ProvisioningSchemeName azure-catalog -CustomProperties $customProperties
<!--NeedCopy-->
  6. Fügen Sie neue VMs zum Katalog hinzu.

Einzelne Katalog-VMs aktualisieren

Die detaillierten Schritte zum Aktualisieren einzelner Katalog-VMs sind wie folgt:

  1. Erstellen Sie einen Katalog ohne Datenträgerverschlüsselung über ProxyHypervisorTrafficThroughConnector.

  2. Führen Sie Set-ProvVM aus, um die Katalog-VM mit DiskEncryptionSetId zu aktualisieren.

    Hinweis:

    DiskEcryptionSetId kann entweder über CustomProperties oder MachineProfile konfiguriert werden.

    Beispiel bei Verwendung von CustomProperties:

    $customProperties = '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="DiskEncryptionSetId" Value="/subscriptions/456c683e2ed7/resourceGroups/testrg/providers/Microsoft.Compute/diskEncryptionSets/diskEncryptionSet1" />
</CustomProperties>'
Set-ProvVM -ProvisioningSchemeName azure-catalog  -VMName azu01 -CustomProperties $customProperties
<!--NeedCopy-->

    Beispiel bei Verwendung von MachineProfile:

    Set-ProvVM -ProvisioningSchemeName azure-catalog  -VMName azu01 -MachineProfile "XDHyp:\HostingUnits\azureunit\machineprofile.folder\testrg.resourcegroup\new-template.vm"
<!--NeedCopy-->

  3. Führen Sie Set-ProvVMUpdateTimeWindow aus, um vorhandene Katalog-VMs zu aktualisieren. Zum Beispiel:

    Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName azure-catalog -VMName azu01 -StartsNow -DurationInMinutes -1
<!--NeedCopy-->
  4. Nach dem Neustart der VMs sehen Sie die aktualisierte Datenträgerverschlüsselung auf den VM-Datenträgern im Azure-Portal.
  5. Fügen Sie dem Katalog neue VMs hinzu.

Temporären Datenträger als WBC-Datenträger für vorhandene Kataloge verwenden

Sie können einen temporären Azure-Datenträger als Write-Back-Cache-Datenträger (WBC-Datenträger) für vorhandene MCS-Maschinenkataloge verwenden. Verwenden Sie den PowerShell-Befehl Set-ProvScheme, um vorhandene Kataloge und VMs zu aktualisieren.

Voraussetzungen

Der vorhandene Katalog muss die folgenden Bedingungen erfüllen:

Hinweis:

Wenn der vorhandene Katalog die folgenden Anforderungen nicht erfüllt, wird der WBC-Datenträger nicht auf dem temporären Datenträger platziert.

  • MCSIO ist aktiviert: Die benutzerdefinierten Eigenschaften WriteBackCacheMemorySize, WriteBackCacheDiskSize und UseWriteBackCache sind aktiviert.
  • Der ephemere Betriebssystemdatenträger ist nicht aktiviert.
  • WBC ist nicht persistent: PersistWBC ist false.
  • UseTempDiskForWBC ist null oder falsch.
  • Die Größe des temporären Datenträgers muss größer sein als die Gesamtgröße von (Größe des Write-Back-Cache-Datenträgers + reservierter Speicherplatz für die Auslagerungsdatei + 1 GB Pufferspeicher).

Wichtig:

Das Ändern eines Service Offerings von einem mit temporärem Datenträger zu einem ohne oder umgekehrt ist nicht zulässig.

Vorhandene Kataloge aktualisieren

Führen Sie die folgenden Befehle aus, um einen vorhandenen Katalog zu aktualisieren:

  1. Führen Sie Set-ProvScheme für den vorhandenen Katalog aus, um UseTempDiskForWBC auf true zu aktualisieren. Beispiel:

    Set-ProvScheme -ProvisioningSchemeName name -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=`"Standard_LRS`"/><Property xsi:type=`"StringProperty`" Name=`"UseManagedDisks`" Value=`"True`"/><Property xsi:type=`"StringProperty`" Name=`"ManagedDisksPreview`" Value=`"False`"/><Property xsi:type=`"StringProperty`" Name=`"PersistOsDisk`" Value=`"False`"/><Property xsi:type=`"StringProperty`" Name=`"UseTempDiskForWBC`" Value=`"True`"/><Property xsi:type=`"StringProperty`" Name=`"PersistWBC`" Value=`"False`"/></CustomProperties>"
<!--NeedCopy-->

  2. Fügen Sie dem Katalog neue Maschinen hinzu und schalten Sie sie ein. Die neuen VMs verfügen über einen WBC-Datenträger innerhalb des temporären Datenträgers.

Informationen für Azure-VMs, Snapshots, Betriebssystemdatenträger und Katalog-Image-Definition abrufen

Sie können Informationen für eine Azure-VM anzeigen, einschließlich Betriebssystemdatenträger und -typ, Snapshot und Katalog-Image-Definition. Diese Informationen werden für Ressourcen auf dem Masterimage angezeigt, wenn ein Maschinenkatalog zugewiesen wird. Verwenden Sie diese Funktion, um ein Linux- oder Windows-Image anzuzeigen und auszuwählen. Eine PowerShell-Eigenschaft, TemplateIsWindowsTemplate, wurde dem Parameter AdditionDatafield hinzugefügt. Dieses Feld enthält Azure-spezifische Informationen: VM-Typ, Betriebssystemdatenträger, Katalog-Image-Informationen und Betriebssystemtyp-Informationen. Wenn TemplateIsWindowsTemplate auf True gesetzt ist, bedeutet dies, dass der Betriebssystemtyp Windows ist; wenn TemplateIsWindowsTemplate auf False gesetzt ist, bedeutet dies, dass der Betriebssystemtyp Linux ist.

Tipp:

Die von der PowerShell-Eigenschaft TemplateIsWindowsTemplate angezeigten Informationen stammen aus der Azure-API. Manchmal kann dieses Feld leer sein. Ein Snapshot von einem Datenträger enthält beispielsweise das Feld TemplateIsWindowsTemplate nicht, da der Betriebssystemtyp nicht aus einem Snapshot abgerufen werden kann.

Setzen Sie beispielsweise den Azure-VM-Parameter AdditionData für den Windows-Betriebssystemtyp mit PowerShell auf True:

PS C:\Users\username> (get-item XDHyp:\HostingUnits\mynetwork\image.folder\username-dev-testing-rg.resourcegroup\username-dev-tsvda.vm).AdditionalData
Key Value
ServiceOfferingDescription Standard_B2ms
HardDiskSizeGB 127
ResourceGroupName FENGHUAJ-DEV-TESTING-RG
ServiceOfferingMemory 8192
ServiceOfferingCores 2
TemplateIsWindowsTemplate True
ServiceOfferingWithTemporaryDiskSizeInMb 16384
SupportedMachineGenerations Gen1,Gen2
<!--NeedCopy-->

Einen MCS-Katalog klonen

Teilen Sie einen vorhandenen persistenten und nicht-persistenten MCS-Katalog in mehrere Kataloge auf. Durch das Erstellen eines Klons des ursprünglichen Bereitstellungsschemas können Sie verschiedene richtlinien- und katalogspezifische Konfigurationen auf bestimmte VM-Untergruppen anwenden. Diese Funktionalität ist besonders nützlich, wenn verschiedene funktionale Rollen innerhalb einer Organisation, wie z. B. Finanzen oder Führungskräfte, im Vergleich zu Standardbenutzern unterschiedliche Ressourcenkonfigurationen (z. B. Sicherungslimits) benötigen.

Anwendungsbeispiel

Ein Administrator verwaltet einen großen VM-Katalog. Das Führungsteam benötigt eine höhere Anzahl von Sicherungen, als die Standardrichtlinie zulässt. Der Administrator verwendet den Befehl Copy-ProvScheme, um das vorhandene Katalogbereitstellungsschema in einen neuen Katalog zu klonen. Dadurch kann der Administrator eine dedizierte Sicherungsrichtlinie auf den neuen Führungskräfte-Katalog anwenden, während die ursprünglichen Einstellungen für den Rest der Organisation beibehalten werden.

Anwendbarkeit

  • Azure-Umgebungen
  • Persistente und nicht-persistente MCS-Kataloge
  • MCS-bereitgestellte Citrix Provisioning-Kataloge

Einschränkungen

  • Bereitstellungsschema: Nur die neueste Version des Bereitstellungsschemas wird kopiert.
  • Sicherungszeitpläne: Der Sicherungszeitplan wird nicht in den neuen Katalog kopiert; der neue Katalog muss einen eigenen Sicherungszeitplan konfiguriert haben.
  • Identitätspools: Identitätsbezogene Objekte werden nicht geklont und bleiben über denselben ADAccountIdentityPool gemeinsam genutzt.
  • Bereitstellungsgruppen: Bereitstellungsgruppenoperationen und Benutzerzuweisungen werden während des Klonvorgangs nicht geändert oder zugeordnet.

Wichtige Überlegungen

  • Ressourcengruppen (TargetLocation):

    • Wenn Sie keine TargetLocation (Azure-Ressourcengruppe) angeben:
      • Für eine von Citrix verwaltete Ressourcengruppe wird eine neue von Citrix verwaltete Ressourcengruppe erstellt.
      • Für eine BYO-Ressourcengruppe (Bring Your Own) werden die Ressourcen des neuen Bereitstellungsschemas in derselben Ressourcengruppe erstellt.

    • Wenn Sie eine TargetLocation angeben:

      • Die Ressourcen werden in der angegebenen Ressourcengruppe erstellt.
      • Die angegebene Ressourcengruppe muss bereits in Azure vorhanden sein.

  • Basisdatenträger-Snapshot: Eine Kopie des Basisdatenträger-Snapshots wird immer erstellt, unabhängig von der Konfiguration der Ressourcengruppe.

Voraussetzungen

  • Ein vorhandenes Bereitstellungsschema (Quellkatalog) muss verfügbar sein.
  • Wenn Sie einen Zielspeicherort angeben, muss die Ziel-Azure-Ressourcengruppe vorhanden sein.

Konfigurieren mit PowerShell

  1. Öffnen Sie ein PowerShell-Fenster.

  2. Führen Sie den Befehl Copy-ProvScheme mit den erforderlichen Parametern aus: SourceProvisioningSchemeName (oder SourceProvisioningSchemeUid) und TargetProvisioningSchemeName.

    Beispiel 1: Kopieren eines Bereitstellungsschemas nach Namen.

    Dieses Beispiel kopiert das Schema mit dem Namen „Backup“ in ein neues Schema mit dem Namen „TestCopy“.

    Copy-ProvScheme -SourceProvisioningSchemeName Backup -TargetProvisioningSchemeName TestCopy
<!--NeedCopy-->

    Beispiel 2: Kopieren eines Bereitstellungsschemas nach Uid in eine bestimmte Ressourcengruppe

    Dieses Beispiel kopiert ein Schema unter Verwendung seiner Uid und gibt eine Zielressourcengruppe mit dem Namen „TestRg“ an.

    Copy-ProvScheme -SourceProvisioningSchemeUid 771e205d-1ee5-4ad2-b044-ecf3d7f24ec7 -TargetProvisioningSchemeName TestCopy -TargetLocation TestRg
<!--NeedCopy-->

Von MCS erstellte Ressourcen identifizieren

Im Folgenden sind die Tags aufgeführt, die MCS den Ressourcen hinzufügt. Die Tags in der Tabelle werden als „key“:„value“ dargestellt.

Ressourcenname Tag
ID-Datenträger “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “CitrixResource” : “Internal”
Image “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “CitrixResource” : “Internal”
NIC “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “CitrixResource” : “Internal”
OS-Datenträger “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “CitrixResource” : “Internal”
PrepVM “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “CitrixResource” : “Internal”
Veröffentlichter Snapshot “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “CitrixResource” : “Internal”
Ressourcengruppe “CitrixResource” : “Internal”
  CitrixSchemaVersion: 2.0
  “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
Speicherkonto “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “CitrixResource” : “Internal”
VM im Katalog “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “CitrixResource” : “Internal”
WBC-Datenträger “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “CitrixResource” : “Internal”

Hinweis:

Eine VM ist im Citrix-Bestand nicht sichtbar, wenn ein CitrixResource-Tag hinzugefügt wird, um sie als von MCS erstellte Ressource zu identifizieren. Sie können den Tag entfernen oder umbenennen, um die VM sichtbar zu machen.

Tags entfernen

Wenn Sie einen Katalog oder eine VM erstellen, werden Tags für die folgenden Ressourcen erstellt:

  • Ressourcengruppe
  • Virtueller Computer
  • Betriebssystemdatenträger
  • Identitätsdatenträger
  • Netzwerkschnittstelle
  • Speicherkonto

Sie können VMs und Maschinenkataloge aus der Citrix-Datenbank entfernen und Tags löschen. Sie können Folgendes verwenden:

  • Remove-ProvVM mit dem Parameter ForgetVM, um VMs und Tags von einer einzelnen VM oder einer Liste von VMs aus einem Maschinenkatalog zu entfernen.
  • Remove-ProvScheme mit dem Parameter ForgetVM, um einen Maschinenkatalog aus der Citrix-Datenbank und Tags von einem gesamten Maschinenkatalog zu entfernen.

Diese Funktion ist nur für persistente VMs anwendbar.

Gehen Sie wie folgt vor:

  1. Öffnen Sie ein PowerShell-Fenster.
  2. Führen Sie asnp citrix* aus, um die Citrix-spezifischen PowerShell-Module zu laden.

  3. Führen Sie Remove-ProvVM aus, um VMs aus der Citrix-Datenbank und Tags von VMs zu löschen. Zum Beispiel:

    Remove-ProvVM -ProvisioningSchemeName “ProvisioningSchemeName” -VMName “vmname” -ForgetVM
<!--NeedCopy-->

  4. Führen Sie Remove-ProvScheme aus, um den Maschinenkatalog aus der Citrix-Datenbank und Tags von Maschinenkatalogen zu löschen. Zum Beispiel:

    Remove-ProvScheme -ProvisioningSchemeName “ProvisioningSchemeName” -ForgetVM
<!--NeedCopy-->

    Hinweis:

    Nachdem Sie den Parameter ForgetVM in Remove-ProvScheme verwendet haben, löscht MCS alle Snapshots, einschließlich des Basisdatenträger-Snapshots, wenn das Bereitstellungsschema entweder in einer selbstverwalteten Ressourcengruppe (BYORG) oder einer von Citrix verwalteten Ressourcengruppe vorhanden ist.

Weitere Informationen

Microsoft Azure-Katalog verwalten
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.