Citrix DaaS™

Gestire un catalogo VMware

September 16, 2025

Grazie al contributo di:

C C

Gestire i cataloghi di macchine descrive le procedure guidate che gestiscono un catalogo di macchine. Le seguenti informazioni coprono dettagli specifici per gli ambienti di virtualizzazione VMware.

Nota:

Prima di gestire un catalogo VMware, è necessario completare la creazione di un catalogo VMware. Vedere Creare un catalogo VMware.

Aggiornare le VM con provisioning allo stato corrente dello schema di provisioning

Il comando Set-ProvScheme modifica lo schema di provisioning. Tuttavia, non influisce sulle VM esistenti. Utilizzando il comando PowerShell Set-ProvVMUpdateTimeWindow, è possibile applicare lo schema di provisioning corrente a una VM esistente persistente o non persistente o a un set di VM. Questa funzionalità è applicabile ai cataloghi di macchine basati su profilo macchina e non basati su profilo macchina.

È possibile aggiornare quanto segue:

VMCpuCount: proprietà dello schema di provisioning
VMMemoryMB: proprietà dello schema di provisioning
Folder ID: proprietà personalizzata
Subnet mapping: proprietà dello schema di provisioning
Hardware version of VM: solo per cataloghi di macchine basati su profilo macchina
Machine profile: solo per cataloghi di macchine basati su profilo macchina

È possibile aggiornare:

Una singola VM
Un elenco di VM specifiche o tutte le VM esistenti associate a un ID dello schema di provisioning
Un elenco di VM specifiche o tutte le VM esistenti associate a un nome dello schema di provisioning (nome del catalogo di macchine)

Prima di aggiornare le VM esistenti

Controllare la configurazione delle VM esistenti. Ad esempio:

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

Aggiornare lo schema di provisioning. Ad esempio:

$customProperties=<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><Property xsi:type="StringProperty" Name="FolderId" Value="FOLDER_ID"/></CustomProperties>
$memoryMb=<DOUBLE THE "UPDATE" MACHINE PROFILE>
Set-ProvScheme -ProvisioningSchemeName my-catalog -VMCpuCount 4 -VmMemoryMb $memoryMb -CustomProperties $customerProperties -NetworkMapping @{"1" = "<A_NETWORK_PATH_FROM_THE_HOSTING_UNIT>"} -MachineProfile "<PATH_TO_UPDATE_MACHINE_PROFILE>"
<!--NeedCopy-->

Verificare se la proprietà corrente della VM corrisponde allo schema di provisioning corrente e se è presente un’azione di aggiornamento in sospeso sulla VM. Ad esempio:
```
Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion

```
È anche possibile trovare VM con una versione specifica. Ad esempio:
```
Get-ProvVM -Filter "ProvisioningSchemeVersion -eq 1" | select VMName, ProvisioningSchemeVersion

```

Richiedere aggiornamenti per le VM esistenti da applicare al riavvio successivo

Eseguire i seguenti comandi per aggiornare le VM esistenti e fare in modo che gli aggiornamenti vengano applicati al riavvio successivo.
- Per aggiornare tutte le VM esistenti. Ad esempio:
```
 Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
 
```
- Per aggiornare un elenco di VM specifiche. Ad esempio:
```
 Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -VMName <List-Of-Vm-Names> -StartsNow -DurationInMinutes -1
 
```
- Per aggiornare le VM in base all’output di Get-ProvVM. Ad esempio:
```
Get-ProvVM -ProvisioningSchemeName "my-catalog" | Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
 
```
Nota:
- Il parametro StartsNow indica che l’ora di inizio pianificata è l’ora corrente.
- Il parametro DurationInMinutes con un numero negativo (ad esempio, –1) indica che non esiste un limite superiore per la finestra temporale della pianificazione.

Trovare le VM con un aggiornamento pianificato. Ad esempio:

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

Riavviare le VM. Al successivo avvio, le modifiche alle proprietà vengono applicate alle VM esistenti. È possibile controllare lo stato aggiornato utilizzando il seguente comando. Ad esempio:
```
Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion

```

Annullare l’aggiornamento della configurazione

È anche possibile annullare un aggiornamento della configurazione di una singola VM, di più VM o di un intero catalogo. Per annullare un aggiornamento della configurazione:

Eseguire Clear-ProvVMUpdateTimeWindow. Ad esempio:
- Per annullare l’aggiornamento della configurazione pianificato per una singola VM:
```
 Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName “ my-catalog “ -VMName “vm1”
 
```
- Per annullare l’aggiornamento della configurazione pianificato per più VM:
```
 Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName "my-catalog" -VMName "vm1","vm2"
 
```
  Nota:
  
  Le VM devono provenire dallo stesso catalogo.

Aggiornare l’ID della cartella di un catalogo di macchine

È possibile aggiornare l’ID della cartella di un catalogo di macchine MCS specificando FolderId nelle proprietà personalizzate del comando Set-ProvScheme. Le VM create dopo l’aggiornamento dell’ID della cartella vengono create sotto questo nuovo ID della cartella. Se questa proprietà non è specificata in CustomProperties, le VM vengono create nella cartella in cui si trova l’immagine master.

Eseguire i seguenti passaggi per aggiornare l’ID della cartella di un catalogo di macchine.

Aprire un browser Web e immettere l’URL per il vSphere Web Client.
Immettere le credenziali e fare clic su Login.
Creare una cartella di posizionamento VM in vSphere Web Client.
Aprire una finestra PowerShell.
Eseguire asnp citrix®* per caricare i moduli PowerShell specifici di Citrix.

Specificare FolderID nelle CustomProperties di Set-ProvScheme. In questo esempio, il valore dell’ID della cartella è group-v2406.

Set-ProvScheme -ProvisioningSchemeUid "50bb319c-2e83-4a37-9ea1-94f630687372" -CustomProperties "<CustomProperties xmlns=""http://schemas.citrix.com/2014/xd/machinecreation"" xmlns:xsi=""http://www.w3.org/2001/XMLSchema-instance""><Property xsi:type=""StringProperty"" Name=""FolderId"" Value=""group-v2406"" /></CustomProperties>"
<!--NeedCopy-->

Aggiungere una VM al catalogo di macchine utilizzando Studio.
Controllare la nuova VM su vSphere Web Client. La nuova VM viene creata nella nuova cartella.

Trovare l’ID della cartella utilizzando i comandi PowerShell

Utilizzare il comando PowerShell Get-HypConfigurationDataForItem per trovare l’ID della cartella per una cartella esistente in un hypervisor VMware.

Creare una connessione di hosting e un gruppo di risorse per un hypervisor VMware. Quindi, eseguire i seguenti passaggi per trovare l’ID della cartella di una cartella su tale hypervisor.

Determinare il percorso XDHyp alla radice dell’albero delle cartelle VM. Ad esempio:
```
XDHyp:\Connections\VMwareConn\Datacenter.datacenter

```

Utilizzare Get-HypConfigurationDataForItem per recuperare la struttura ad albero. Ad esempio:

Get-HypConfigurationDataForItem -LiteralPath XDHyp:\Connections\VMwareConn\Datacenter.datacenter
<!--NeedCopy-->

Eseguire il seguente comando per identificare l’ID della cartella dall’output XML. In questo esempio, cercare l’ID della cartella di ExampleFolder nell’output XML.

$result = Get-HypConfigurationDataForItem -LiteralPath XDHyp:\Connections\VMwareConn\Datacenter.datacenter
$result.VmPlacementFolder
<!--NeedCopy-->

Output XML:

<?xml version="1.0" encoding="utf-16"?>
<CtxVmPlacementFolder xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Name>vm</Name>
<Id>group-v4</Id>
<SubFolder>
<CtxVmPlacementFolder>
  <Name>vCLS</Name>
  <Id>group-v75</Id>
  <SubFolder />
</CtxVmPlacementFolder>
<CtxVmPlacementFolder>
  <Name>MyOtherFolder</Name>
  <Id>group-v1110</Id>
  <SubFolder />
</CtxVmPlacementFolder>
<CtxVmPlacementFolder>
  <Name>ExampleFolder</Name>
  <Id>group-v4658</Id>
  <SubFolder />
</CtxVmPlacementFolder>
</SubFolder>
</CtxVmPlacementFolder>
<!--NeedCopy-->

Trovare l’ID della cartella in vSphere

Accedere al MOB su qualsiasi sistema server ESXi o vCenter per trovare l’ID della cartella delle VM.

Il Managed Object Browser (MOB) è un’applicazione server basata sul Web integrata in tutti i sistemi server ESX/ESXi e vCenter. Questa utilità vSphere consente di visualizzare informazioni dettagliate su oggetti come VM, datastore e pool di risorse.

Aprire un browser Web e immettere http://x.x.x.x/mob, dove x.x.x.x è l’indirizzo IP del vCenter Server o dell’host ESX/ESXi. Ad esempio, https://10.60.4.70/mob.
Nella pagina Home del MOB, fare clic sul valore della proprietà content.
Fare clic sul valore di rootFolder.
Fare clic sul valore di childEntity.
Fare clic sul valore di vmFolder.
È possibile trovare l’ID della cartella nel valore di childEntity.

Identificare le risorse create da MCS

Di seguito sono riportati i tag che MCS aggiunge alle risorse sulla piattaforma VMware. I tag nella tabella sono rappresentati come “chiave”:”valore”.

Nome risorsa	Tag
VM di preparazione	“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	“XdConfig:”XdProvisioned=True”
VM nel catalogo	“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	“XdConfig:”XdProvisioned=True”

Ulteriori informazioni

La versione ufficiale di questo contenuto è in inglese. Per alcuni dei contenuti della documentazione Cloud Software Group è stata impiegata la traduzione automatica solo per comodità. Cloud Software Group non ha alcun controllo sui contenuti tradotti in modo automatico, che possono contenere errori, imprecisioni o linguaggio inadatto. Non viene offerta alcuna garanzia di alcun tipo, espressa o implicita, circa l'accuratezza, l'affidabilità, l'idoneità o la correttezza di qualsiasi traduzione dall'originale inglese in qualsiasi altra lingua, o che il prodotto o servizio Cloud Software Group sia conforme a qualsiasi contenuto in traduzione automatica, e qualsiasi garanzia fornita ai sensi del contratto di licenza per l'utente finale applicabile o i termini di servizio, o qualsiasi altro accordo con Cloud Software Group che il prodotto o il servizio sia conforme a qualsiasi documentazione non si applicheranno nella misura in cui tale documentazione sia in traduzione automatica. Cloud Software Group non sarà ritenuta responsabile per eventuali danni o problemi che potrebbero derivare dall'utilizzo di contenuti per cui si è impiegata la traduzione automatica.

È stato utile?

Gestire un catalogo VMware

September 16, 2025

Grazie al contributo di:

C C

September 16, 2025

Grazie al contributo di:

C C

In questo articolo

Aggiornare le VM con provisioning allo stato corrente dello schema di provisioning
Aggiornare l’ID della cartella di un catalogo di macchine
Identificare le risorse create da MCS
Ulteriori informazioni

È stato utile?