Citrix DaaS

AWS-Katalog verwalten

December 1, 2023

Beitrag von:

Unter Maschinenkataloge verwalten werden die Assistenten zum Verwalten eines Maschinenkatalogs beschrieben. Die folgenden Informationen beziehen sich speziell auf AWS-Cloudumgebungen.

Hinweis:

Sie müssen einen AWS-Katalog erstellt haben, bevor Sie ihn verwalten können. Siehe AWS-Katalog erstellen.

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 zur Anwendung der Updates mit dem PowerShell-Befehl Set-ProvVMUpdateTimeWindow festlegen.

Mithilfe dieser Implementierung können Sie einzelne VMs effizient verwalten, ohne den gesamten Maschinenkatalog aktualisieren zu müssen. Derzeit gilt dieses Feature nur für AWS- und Azure-Umgebungen.

Derzeit können Sie folgende Eigenschaften aktualisieren:

ServiceOffering
MachineProfile

Mit dem Feature ist Folgendes möglich:

Eigenschaften einer VM aktualisieren
Aktualisierte Eigenschaften auf einer VM nach dem Aktualisieren des Maschinenkatalogs beibehalten
Auf eine VM angewendete Konfigurationsupdates rückgängig machen

Voraussetzungen

Vor dem Aktualisieren der Eigenschaften einer VM gehen Sie wie folgt vor:

Öffnen Sie ein PowerShell-Fenster.
Führen Sie asnp citrix* aus, um die Citrix-spezifischen PowerShell-Module zu laden.
Prüfen Sie die Konfiguration des vorhandenen Maschinenkatalogs. Beispiel:
```
Get-ProvScheme -ProvisioningSchemeName ABCCatalog

```
Überprüfen Sie die Konfiguration der VM, die Sie aktualisieren möchten. Beispiel:
```
Get-ProvVM -ProvisioningSchemeName ABCCatalog -VMName machine1

```

Eigenschaften einer VM aktualisieren

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

Aktualisieren Sie die Eigenschaften der VM. Wenn Sie beispielsweise die Eigenschaft serviceOffering der VM aktualisieren möchten, führen Sie Folgendes aus:

Set-ProvVM -ProvisioningSchemeName ABCCatalog -VMName machine1 -ServiceOffering "XDHyp:\HostingUnits<HostingUnit><serviceoffering>.serviceofferin"
<!--NeedCopy-->

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

Set-ProvVM -ProvisioningSchemeName ABCCatalog -VMName machine1 -ServiceOffering "XDHyp:\HostingUnits<HostingUnit><serviceoffering>.serviceoffering"
Set-ProvVM -ProvisioningSchemeName ABCCatalog -VMName machine2 -ServiceOffering "XDHyp:\HostingUnits<HostingUnit><serviceoffering>.serviceoffering"
<!--NeedCopy-->

Hinweis:

Die Updates werden nicht sofort angewendet.

Rufen Sie die Liste der zur Aktualisierung angegebenen Eigenschaften und die Konfigurationsversion ab. Beispiel:
```
Get-ProvVMConfiguration -ProvisioningSchemeName ABCCatalog -VMName machine1

```
Überprüfen Sie den Eigenschaftswert von Version und die Eigenschaften, die aktualisiert werden sollen (in diesem Fall ServiceOffering).
Überprüfen Sie die Konfigurationsversion. Beispiel:
```
Get-ProvVM -ProvisioningSchemeName ABCCatalog -VMName machine1

```
Überprüfen Sie den Wert der Eigenschaft ProvVMConfigurationVersion. Das Update wurde noch nicht angewendet. Die VM besitzt immer noch die alte Konfiguration.
Fordern Sie ein geplantes Update an. Beispiel:
```
Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName ABCCatalog -StartsNow -DurationInMinutes -1

```
Hinweis:

Jegliches ausstehende Provisioningschema-Update wird ebenfalls angewendet.

Starten Sie die VM neu. Beispiel:

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

Überprüfen Sie die Konfigurationsversion. Beispiel:
```
Get-ProvVM -ProvisioningSchemeName ABCCatalog -VMName machine1

```
Überprüfen Sie den Wert der Eigenschaft ProvVMConfigurationVersion. Das Update wurde angewendet. Die VM hat jetzt die neue Konfiguration.
Um weitere Konfigurationsupdates auf der VM anzuwenden, schalten Sie die VM aus und wiederholen Sie die Schritte.

Aktualisierte Eigenschaften auf einer VM nach dem Aktualisieren des Maschinenkatalogs beibehalten

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

Aktualisieren Sie den Maschinenkatalog. Wenn Sie das Maschinenprofil ändern möchten, führen Sie Folgendes aus:

Set-ProvScheme -ProvisioningSchemeName ABCCatalog
-MachineProfile "XDHyp:\HostingUnits<hosting-unit><launch-template>.launchtemplate<launch-template-version>.launchtemplateversion"
<!--NeedCopy-->

Rufen Sie die Konfigurationsdetails des Maschinenkatalogs ab. Beispiel:
```
Get-ProvScheme -ProvisioningSchemeName ABCCatalog

```
ProvisioningSchemeVersion wird jetzt um eins erhöht.
Aktualisieren Sie die Eigenschaften der VM. Stellen Sie der VM beispielsweise ein Maschinenprofil bereit.
Rufen Sie die Liste der Eigenschaften ab, die die VM nach dem Zusammenführen der Konfigurationsupdates auf der VM mit den Maschinenkatalog-Updates haben wird. Beispiel:
```
Get-ProvVMConfigurationResultantSet -ProvisioningSchemeName ABCCatalog -VMName machine1

```
Hinweis:

Alle Updates der VM setzen die Updates am Maschinenkatalog außer Kraft.

Fordern Sie ein geplantes Update für die VM an. Beispiel:

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

Starten Sie die VM neu. Beispiel:
```
New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn

```
Die VM behält die aktualisierte Eigenschaft serviceoffering gemäß der Ableitung aus Set-ProvVM auf Maschine 1 bei. Die Tag-Werte werden jedoch aus dem neuesten Provisioningschema abgeleitet.
Rufen Sie die Konfigurationsversion der VM ab. Beispiel:
```
Get-ProvVM -ProvisioningSchemeName ABCCatalog -VMName machine1

```
Für ProvisioningSchemeVersion und ProvVMConfigurationVersion wird jetzt die neueste Version angegeben.

Auf eine VM angewendete Konfigurationsupdates rückgängig machen

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

Führen Sie den folgenden Befehl aus, um die Updates zu entfernen, die auf die VM angewendet wurden. Beispiel:

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

Fordern Sie ein geplantes Update für die VM an. Beispiel:

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

Starten Sie die VM neu. Beispiel:

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

Überprüfen Sie die Konfigurationsversion der VM. Beispiel:
```
Get-ProvVM -ProvisioningSchemeName ABCCatalog -VMName machine1

```
Der Wert für ProvVMConfigurationVersion gibt jetzt die Konfigurationsversion des Maschinenkatalogs wieder.

Tags entfernen

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

Virtuelle Maschine
Stammdatenträger-Volume
Identitätsdatenträger-Volume
Netzwerkkarte
Stammdatenträgerimage (AMI)
Startvorlage
Snapshot von AMI oder Stammdatenträger

Sie können VMs und Maschinenkataloge aus der Citrix Datenbank sowie Tags entfernen. Optionen:

Remove-ProvVM mit dem Parameter ForgetVM zum Entfernen von VMs und Tags aus einer einzelnen VM oder einer Liste von VMs aus einem Maschinenkatalog.
Remove-ProvScheme mit Parameter ForgetVM zum Entfernen eines Maschinenkatalogs aus der Citrix Datenbank und von Ressourcen aus einem Maschinenkatalog.

Dieses Feature ist nur für persistente VMs verfügbar.

Gehen Sie hierzu folgendermaßen vor:

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

Entsperren Sie die VM, bevor Sie die VMs entfernen. Beispiel:

Unlock-ProvVM -ProvisioningSchemeName "<name>" -VMID "<id"
<!--NeedCopy-->

Führen Sie einen der folgenden Befehle aus, um VMs, Maschinenkataloge und Tags aus Ressourcen zu entfernen.
- Führen Sie Remove-ProvVM mit ForgetVM aus, um VMs aus der Citrix-Datenbank und Tags aus VMs zu entfernen. Beispiel:
```
 Remove-ProvVM -ProvisioningSchemeName "<name>" -VMName "<name>" -ForgetVM
 
```
- Führen Sie Remove-ProvScheme aus, um einen Maschinenkatalog aus der Citrix Datenbank und Ressourcen aus einem Maschinenkatalog zu entfernen. Beispiel:
```
 Run Remove-ProvScheme -ProvisioningSchemeName "<name>" -ForgetVM
 
```
Vergewissern Sie sich, dass die VM aus Delivery Controller, nicht aber dem Hypervisor entfernt wurde.
1. Führen Sie Get-ProvVM -ProvisioningSchemeName "<name>" -VMName "<name>" aus. Es darf nichts zurückgegeben werden.
2. Rufen Sie die AWS-EC2-Konsole auf. Die VMs müssten angezeigt werden, die Tags sind jetzt jedoch entfernt. Tags aus den folgenden Ressourcen wurden entfernt:
  - Virtuelle Maschine
  - Stammdatenträger-Volume
  - Identitätsdatenträger-Volume
  - Netzwerkkarte
Wenn Sie den Maschinenkatalog entfernen, vergewissern Sie sich, dass der Katalog vom Delivery Controller entfernt wurde.
1. Führen Sie Get-ProvScheme -ProvisioningSchemeName "forgetvmdemo" aus. Dies muss einen Fehler zurückgeben.
2. Vergewissern Sie sich in der AWS-EC2-Konsole, dass die folgenden Ressourcen entfernt wurden.
  - Stammdatenträgerimage (AMI)
  - Startvorlage
  - Snapshot von AMI oder Stammdatenträger

Identifizieren der von MCS erstellten Ressourcen

Nachfolgend werden die Tags aufgeführt, die MCS den Ressourcen auf der AWS-Plattform hinzufügt. Die Tags werden in der Tabelle als in der Form “Schlüssel”: “Wert” dargestellt.

Ressourcenname	Tag
ID-Datenträger	“Name”: “VMName_IdentityDisk”
	“XdConfig”: “XdProvisioned=true”
	“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
Image	“XdConfig”: “XdProvisioned=true”
	“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
Netzwerkkarte	“Description”: “XD Nic”
	“XdConfig”: “XdProvisioned=true”
	“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
OS-Datenträger	“Name”: “VMName_rootDisk”
	“XdConfig”: “XdProvisioned=True”
	“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	[Wenn AwsCaptureInstanceProperties = true] “Citrix Resource”: “”
	[Wenn AwsCaptureInstanceProperties = true und AwsOperationalResourcesTagging = true] “CitrixOperationalResource”: “”
Vorbereitungs-VM	“Name”: “Preparation - CatalogName - xxxxxxxxxx”
	“XdConfig”: “XdProvisioned=true”
	“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	[Wenn AwsCaptureInstanceProperties = true] “Citrix Resource”: “”
	[Wenn AwsCaptureInstanceProperties = true und AwsOperationalResourcesTagging = true] “CitrixOperationalResource”: “”
Veröffentlichter Snapshot	“XdConfig”: “XdProvisioned=true”
	Wenn kein Snapshot für Volumeworker-AMI, dann “CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxx”
Vorlage	[Wenn AwsCaptureInstanceProperties = true] “XdConfig”: “XdProvisioned=true”
	[Wenn AwsCaptureInstanceProperties = true] “CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	[Wenn AwsCaptureInstanceProperties = true] “CitrixResource”: “”
	[Wenn AwsCaptureInstanceProperties = true und AwsOperationalResourcesTagging = true] “CitrixOperationalResource”: “”
VM im Katalog	“XdConfig”: “XdProvisioned=true”
	“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	[Wenn AwsCaptureInstanceProperties = true] “CitrixResource”: “”
	[Wenn AwsCaptureInstanceProperties = true] “aws:ec2launchtemplate:id”:”lt-xxxx”
	[Wenn AwsCaptureInstanceProperties = true] “aws:ec2launchtemplate:version”: “n”
	[Wenn AwsCaptureInstanceProperties = true und AwsOperationalResourcesTagging = true] “CitrixOperationalResource”: “”
Volumeworker-AMI	“XdConfig”: “XdProvisioned=true”
Volumeworker-Bootstrapper	“Name”: “XenDesktop Temp”
	“XdConfig”: “XdProvisioned=true”
	“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	[Wenn AwsCaptureInstanceProperties = true und AwsOperationalResourcesTagging = true] “CitrixVolumeWorkerBootstrapper”: “”
Volumeworker-Instanz	“Name”: “Citrix.XD.Volumeworker-xxxx-xx-xx-xx-xxxx”
	“XdConfig”: “XdProvisioned=true”

Weitere Informationen

Die offizielle Version dieses Inhalts ist auf Englisch. Für den einfachen Einstieg wird Teil des Inhalts der Cloud Software Group Dokumentation maschinell übersetzt. Cloud Software Group hat keine Kontrolle über maschinell übersetzte Inhalte, die Fehler, Ungenauigkeiten oder eine ungeeignete Sprache enthalten können. Es wird keine Garantie, weder ausdrücklich noch stillschweigend, für die Genauigkeit, Zuverlässigkeit, Eignung oder Richtigkeit von Übersetzungen aus dem englischen Original in eine andere Sprache oder für die Konformität Ihres Cloud Software Group Produkts oder Ihres Diensts mit maschinell übersetzten Inhalten gegeben, und jegliche Garantie, die im Rahmen der anwendbaren Endbenutzer-Lizenzvereinbarung oder der Vertragsbedingungen oder einer anderen Vereinbarung mit Cloud Software Group gegeben wird, dass das Produkt oder den Dienst mit der Dokumentation übereinstimmt, gilt nicht in dem Umfang, in dem diese Dokumentation maschinell übersetzt wurde. Cloud Software Group kann nicht für Schäden oder Probleme verantwortlich gemacht werden, die durch die Verwendung maschinell übersetzter Inhalte entstehen können.

War dieser Artikel hilfreich?

AWS-Katalog verwalten

December 1, 2023

Beitrag von:

December 1, 2023

Beitrag von:

In diesem Artikel

Eigenschaften einzelner VMs aktualisieren
Tags entfernen
Identifizieren der von MCS erstellten Ressourcen
Weitere Informationen

War dieser Artikel hilfreich?