Documentazione dei prodotti
Citrix DaaS™
Visualizza PDF

Gestire un catalogo VMware

May 4, 2026
Grazie al contributo di: 
C C

Gestire i cataloghi di macchine descrive le procedure guidate per la gestione di un catalogo di macchine. Le seguenti informazioni riguardano i dettagli specifici degli 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 o a un set di VM esistenti, persistenti o non persistenti. Questa funzionalità è applicabile ai cataloghi di macchine basati su profili macchina e non basati su profili macchina.

  • È possibile aggiornare quanto segue:

  • VMCpuCount: Proprietà dello schema di provisioning
  • VMMemoryMB: Proprietà dello schema di provisioning
  • ID cartella: Proprietà personalizzata
  • Mappatura subnet: Proprietà dello schema di provisioning
  • Versione hardware della VM: Solo per cataloghi di macchine basati su profili macchina
  • Profilo macchina: Solo per cataloghi di macchine basati su profili macchina

È possibile aggiornare:

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

Prima di aggiornare le VM esistenti

  1. Controllare la configurazione delle VM esistenti. Ad esempio:

    
Get-ProvScheme | select ProvisioningSchemeName, ProvisioningSchemeVersion

<!--NeedCopy-->

  2. 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-->
      1. 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

<!--NeedCopy-->

    È anche possibile trovare VM con una versione particolare. Ad esempio:

    
Get-ProvVM -Filter "ProvisioningSchemeVersion -eq 1" | select VMName, ProvisioningSchemeVersion

<!--NeedCopy-->

Richiedere aggiornamenti per le VM esistenti da applicare al riavvio successivo

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

 <!--NeedCopy-->

    • Per aggiornare un elenco di VM specifiche. Ad esempio:

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

 <!--NeedCopy-->

    • 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

 <!--NeedCopy-->

    Nota:

    • StartsNow indica che l’ora di inizio pianificata è l’ora corrente.
    • DurationInMinutes con un numero negativo (ad esempio, –1) indica che non esiste un limite superiore per la finestra temporale della pianificazione.

  2. Trovare le VM con un aggiornamento pianificato. Ad esempio:

    
Get-ProvVM -Filter "ProvisioningSchemeUpdateAfter" | select VMName, ProvisioningSchemeUpdateAfter

<!--NeedCopy-->

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

<!--NeedCopy-->

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:

  1. Eseguire Clear-ProvVMUpdateTimeWindow. Ad esempio:

    • Per annullare l’aggiornamento della configurazione pianificato per una singola VM:

      
 Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName “ my-catalog “ -VMName “vm1”

 <!--NeedCopy-->

    • Per annullare l’aggiornamento della configurazione pianificato per più VM:

      
 Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName "my-catalog" -VMName "vm1","vm2"

 <!--NeedCopy-->

      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.

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

  6. 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-->
  7. Aggiungere una VM al catalogo di macchine utilizzando Studio.
  8. 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.

  1. Determinare il percorso XDHyp alla radice dell’albero delle cartelle VM. Ad esempio:

    
XDHyp:\Connections\VMwareConn\Datacenter.datacenter

<!--NeedCopy-->

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

    ```

  • Get-HypConfigurationDataForItem -LiteralPath XDHyp:\Connections\VMwareConn\Datacenter.datacenter

    ```

    1. 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 disponibile 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.

  1. Aprire un browser Web e immettere http://x.x.x.x/mob, dove x.x.x.x è l’indirizzo IP del server vCenter o dell’host ESX/ESXi. Ad esempio, https://10.60.4.70/mob.
  2. Nella pagina Home del MOB, fare clic sul valore della proprietà content.
  3. Fare clic sul valore di rootFolder.
  4. Fare clic sul valore di childEntity.
  5. Fare clic sul valore di vmFolder.
  6. È 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

Gestire un catalogo VMware
May 4, 2026
Grazie al contributo di: 
C C
May 4, 2026
Grazie al contributo di: 
C C

In questo articolo

Feedback sito | Your privacy choices footer linkScelte di privacy | Privacy e condizioni legali | Preferenze cookie | Impostazioni di consenso | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.