Manage an AWS catalog

June 28, 2023

Contributed by:

Manage machine catalogsdescribes the wizards that manage a machine catalog. The following information covers details specific to AWS cloud environments.

Note:

Before managing an AWS catalog, you need to finish creating an AWS catalog. SeeCreate an AWS catalog.

Remove tags

When you create a catalog or a VM, tags are created on the following resources:

Virtual machine
Root disk volume
Identity disk volume
NIC
Root disk image (AMI)
Launch template
Snapshot of AMI or root disk

You can remove VMs and machine catalogs from Citrix database and remove tags. You can use:

Remove-ProvVMwithForgetVMparameter to remove VMs and tags from a single VM or a list of VMs from a machine catalog.
Remove-ProvSchemewithForgetVMparameter to remove a machine catalog from the Citrix database and resources from a machine catalog.

This feature is only applicable to persistent VMs.

To do this:

Open aPowerShellwindow.
Runasnp citrix*to load the Citrix-specific PowerShell modules.
Unlock the VM before removing the VMs. For example:
```
Unlock-ProvVM -ProvisioningSchemeName "" -VMID "
```
Run one of the following commands to remove VMs, machine catalog, and tags from resources.
- RunRemove-ProvVMwithForgetVMto remove VMs from Citrix database and tags from VMs. For example:
```
Remove-ProvVM -ProvisioningSchemeName "" -VMName "" -ForgetVM 
```
- RunRemove-ProvSchemeto remove machine catalog from Citrix database and resources from a machine catalog. For example:
```
Run Remove-ProvScheme -ProvisioningSchemeName "" -ForgetVM 
```
Verify that the VM is removed from the Delivery Controller, however, not from the hypervisor.
1. RunGet-ProvVM -ProvisioningSchemeName "" -VMName "". This must return nothing.
2. Go to AWS EC2 console. You must see the VMs, however, the tags are now removed. Tags from the following resources are removed:
  - Virtual machine
  - Root disk volume
  - Identity disk volume
  - NIC
If you remove the machine catalog, verify that the catalog is removed from the Delivery Controller.
1. RunGet-ProvScheme -ProvisioningSchemeName "forgetvmdemo". This must return an error.
2. Verify in AWS EC2 console that the following resources are removed.
  - Root disk image (AMI)
  - Launch template
  - Snapshot of AMI or root disk

Identify resources created by MCS

Following are the tags that MCS adds to the resources on AWS platform. The tags in the table are represented as “key”:”value”.

Resource name	Tag
ID disk	“Name”: “VMName_IdentityDisk”
	:“XdConfig XdProvisioned = true”
	“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
Image	:“XdConfig XdProvisioned = true”
	“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
NIC	“Description”: “XD Nic”
	:“XdConfig XdProvisioned = true”
	“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
OS disk	“Name”: “VMName_rootDisk”
	“XdConfig”: “XdProvisioned=True”
	“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	[when AwsCaptureInstanceProperties = true] “Citrix Resource”: “”
	[when AwsCaptureInstanceProperties = true and AwsOperationalResourcesTagging = true] “CitrixOperationalResource”: “”
PrepVM	“Name”: “Preparation - CatalogName - xxxxxxxxxx”
	:“XdConfig XdProvisioned = true”
	“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	[when AwsCaptureInstanceProperties = true] “Citrix Resource”: “”
	[when AwsCaptureInstanceProperties = true and AwsOperationalResourcesTagging = true] “CitrixOperationalResource”: “”
Published snapshot	:“XdConfig XdProvisioned = true”
	如果不是一个快照卷工人AMI,那么“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
Template	[when AwsCaptureInstanceProperties = true] “XdConfig”: “XdProvisioned=true”
	[when AwsCaptureInstanceProperties = true] “CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	[when AwsCaptureInstanceProperties = true] “CitrixResource”: “”
	[when AwsCaptureInstanceProperties = true and AwsOperationalResourcesTagging = true] “CitrixOperationalResource”: “”
VM in catalog	:“XdConfig XdProvisioned = true”
	“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	[when AwsCaptureInstanceProperties = true] “CitrixResource”: “”
	[when AwsCaptureInstanceProperties = true] “aws:ec2launchtemplate:id”:”lt-xxxx”
	[when AwsCaptureInstanceProperties = true] “aws:ec2launchtemplate:version”: “n”
	[when AwsCaptureInstanceProperties = true and AwsOperationalResourcesTagging = true] “CitrixOperationalResource”: “”
Volume worker AMI	:“XdConfig XdProvisioned = true”
Volume worker bootstraper	“Name”: “XenDesktop Temp”
	:“XdConfig XdProvisioned = true”
	“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	[when AwsCaptureInstanceProperties = true and AwsOperationalResourcesTagging = true] “CitrixVolumeWorkerBootstrapper”: “”
Volume worker instance	“Name”: “Citrix.XD.Volumeworker-xxxx-xx-xx-xx-xxxx”
	:“XdConfig XdProvisioned = true”

Manage an AWS catalog

Remove tags

Identify resources created by MCS

更多的信息

In this article