Documentazione dei prodotti
Citrix DaaS™
Visualizza PDF

Creare un catalogo VMware

May 4, 2026
Grazie al contributo di: 
C C

Creare cataloghi di macchine descrive le procedure guidate per la creazione di un catalogo di macchine.

Nota:

Prima di creare un catalogo VMware, è necessario completare la creazione di una connessione a VMware. Vedere Connessione a VMware.

Creare un catalogo di macchine utilizzando un profilo macchina

È possibile creare un catalogo di macchine MCS utilizzando un profilo macchina. L’origine dell’input del profilo macchina è un modello VMware. Il profilo macchina acquisisce le proprietà hardware da un modello VMware e le applica alle VM appena sottoposte a provisioning nel catalogo.

Nota:

  • L’input dell’immagine master (snapshot) e l’input del profilo macchina (modello VMware) devono essere entrambi con vTPM abilitato o entrambi con vTPM disabilitato. Questa regola si applica sia a New-ProvScheme che a Set-ProvScheme.
  • Se l’immagine master ha vTPM abilitato, il modello VMware può provenire solo dalla stessa origine VM dell’immagine master.

  • La policy di archiviazione crittografata supporta solo il clone completo.

  • I cataloghi basati su profilo macchina utilizzano il modello VMware fornito per raccogliere le informazioni sul controller di archiviazione, basandosi sui dischi virtuali collegati. Il modello deve includere un disco virtuale necessario per recuperare le informazioni sul controller di archiviazione utilizzate per configurare i dischi virtuali per le macchine virtuali.

  • Il modello VMware nel profilo macchina deve esistere durante il ciclo di vita del catalogo per consentire il provisioning delle VM nel catalogo. Senza un modello VMware, non è possibile eseguire il provisioning di nuove VM. Quando un modello VMware viene eliminato, è necessario fornire un nuovo modello utilizzando il comando Set-ProvScheme.

  • MCS acquisisce le proprietà di un modello VMware. È possibile creare un nuovo modello VMware facendo riferimento alle proprietà memorizzate del modello VMware utilizzando il comando Get-Provscheme.
  • In alternativa, se il catalogo di macchine e le VM sottoposte a provisioning esistono, una macchina sottoposta a provisioning MCS può essere utilizzata anche per creare un nuovo modello VMware.

  • Quando MCSIO è abilitato, è possibile aggiornare le dimensioni della memoria e della cache del disco dopo la creazione dei cataloghi MCS.

    • In base ai diversi sistemi operativi, è possibile creare un catalogo di macchine con diverse configurazioni:

    • Se Windows 11 è installato sull’immagine master, è necessario che vTPM sia abilitato per l’immagine master. Pertanto, il modello VMware, che è una fonte del profilo macchina, deve avere vTPM collegato.

  • Se Windows 10 è installato sull’immagine master senza vTPM collegato, è possibile creare un catalogo di macchine con un modello VMware senza vTPM come origine per il profilo macchina.

Esiste un’altra configurazione in cui è possibile creare un catalogo di macchine utilizzando la modalità disco a copia completa con un modello di profilo macchina applicato con una policy di archiviazione crittografata.

Per creare un catalogo di macchine utilizzando i comandi PowerShell con il profilo macchina come input:

  1. Aprire una finestra PowerShell.
  2. Eseguire asnp citrix* per caricare i moduli PowerShell specifici di Citrix.

  3. Eseguire i seguenti comandi:

    • Per creare un catalogo di macchine con un modello VMware con vTPM collegato come origine per l’input del profilo macchina e un’immagine master con Windows 11 installato:

      ```

$identityPool = New-AcctIdentityPool The Books section contains a title field. -IdentityPoolName “`<string>`” -NamingScheme “<string>-###” -NamingSchemeType Numeric -Domain “<domain name” -ZoneUid “<Uid>” -Scope @()

    <!--NeedCopy--> ```

    ```

    $provScheme =New-ProvScheme  -CleanOnBoot
    -HostingUnitName "vSanRg"
    -IdentityPoolName "<string>"
    -InitialBatchSizeHint 1
    -MasterImageVM "XDHyp:\HostingUnits\<hosting unit name>\<snapshot name>.snapshot"
    -NetworkMapping @{"0"="XDHyp:\HostingUnits\<hosting unit name>\\<network name>.network"}
    -ProvisioningSchemeName "<string>"
    -Scope @() -VMCpuCount 4  -VMMemoryMB 6144
    -MachineProfile "XDHyp:\HostingUnits\<hosting unit name>\<template name>.template"
    -TenancyType Shared
-  -FunctionalLevel "L7_20"

    <!--NeedCopy--> ```

    ```

    $catalog = New-BrokerCatalog -AllocationType "Static" -PersistUserChanges  "OnLocal"
    -Description "&lt;string&gt;"  -IsRemotePC $False
    -MinimumFunctionalLevel 'L7_9' -Name "&lt;catalog name&gt;" -ProvisioningType 'MCS'
    -Scope @()  -SessionSupport "SingleSession"
    -ZoneUid "&lt;Uid&gt;"

    <!--NeedCopy--> ```

    ```

    Set-BrokerCatalog -Name "<string>"
    -ProvisioningSchemeId $provScheme.ProvisioningSchemeUid.Guid

    <!--NeedCopy--> ```

-  Per creare un catalogo di macchine con un modello VMware senza vTPM come origine per il profilo macchina e un'immagine master con Windows 10 installato:

    ```

    $identityPool = New-AcctIdentityPool
    -IdentityPoolName "<string>"
    -NamingScheme "<string>-###"
    -NamingSchemeType Numeric
    -Domain "<domain name>"
    -ZoneUid "<Uid>"  -Scope @()

    <!--NeedCopy--> ```

    ```

$provScheme =New-ProvScheme -CleanOnBoot -HostingUnitName “<string>” -IdentityPoolName “<string>” -InitialBatchSizeHint 1 -MasterImageVM “XDHyp:\HostingUnits<hosting unit name><snapshot name>.snapshot” -NetworkMapping @{“0”=”XDHyp:\HostingUnits<hosting unit name>\<string>.network”} -ProvisioningSchemeName “<string>” -Scope @() -VMCpuCount 4 -VMMemoryMB 8192 -MachineProfile “XDHyp:\HostingUnits<hosting unit name><template name>.template” -TenancyType Shared -FunctionalLevel “L7_20”

    <!--NeedCopy--> ```

    ```

    $catalog = New-BrokerCatalog
    -AllocationType "Static"
    -PersistUserChanges  "OnLocal"  -Description "<string>"  -IsRemotePC $False
    -MinimumFunctionalLevel 'L7_9' -Name "<string>" -ProvisioningType 'MCS' -Scope @()  -SessionSupport "SingleSession" -ZoneUid "<Uid"

    <!--NeedCopy--> ```

    ```

    Set-BrokerCatalog -Name "<string>"
    -ProvisioningSchemeId $provScheme.ProvisioningSchemeUid.Guid

    <!--NeedCopy--> ```

-  Per creare un catalogo di macchine utilizzando la modalità disco a copia completa con un modello di profilo macchina applicato con una policy di archiviazione crittografata:

    ```

    $identityPool = New-AcctIdentityPool
    -IdentityPoolName "<string>"
    -NamingScheme "<string>-###"
    -NamingSchemeType Numeric
    -Domain "<domain name>"
    -ZoneUid "<Uid>"  -Scope @()

    <!--NeedCopy--> ```

    ```

    $provScheme =New-ProvScheme
    -HostingUnitName "<string>"
    -IdentityPoolName "<string>" -InitialBatchSizeHint 1
    -MasterImageVM "XDHyp:\HostingUnits\<hosting unit name>\<snapshot name>.snapshot"
    -NetworkMapping @{"0"="XDHyp:\HostingUnits\<hosting unit name>\\<string>.network"} -ProvisioningSchemeName "&lt;string&gt;"  -Scope @() -VMCpuCount 4  -VMMemoryMB 8192
-  -MachineProfile "XDHyp:\HostingUnits\<hosting unit name>\<template name>.template"

-TenancyType Shared -FunctionalLevel “L7_20” -UseFullDiskCloneProvisioning

    <!--NeedCopy--> ```

    ```

-  $catalog = New-BrokerCatalog
-  -AllocationType "Static"
-  -PersistUserChanges  "OnLocal"
-  -Description "<string>"
    -IsRemotePC $False
    -MinimumFunctionalLevel 'L7_9' -Name "<string>" -ProvisioningType 'MCS' -Scope @()
    -SessionSupport "SingleSession" -ZoneUid "<Uid>"

    <!--NeedCopy--> ```

    ```

    Set-BrokerCatalog -Name "<string>"
    -ProvisioningSchemeId $provScheme.ProvisioningSchemeUid.Guid

    <!--NeedCopy--> ```

-  Per aggiornare un profilo macchina, utilizzare il comando `Set-ProvScheme`. Ad esempio:

    ```

    Set-ProvScheme -ProvisioningSchemeName 'name' -IdentityPoolName 'name' -MachineProfile 'XDHyp:\HostingUnits\<hosting unit name>\<template name>.template

    <!--NeedCopy--> ```

  • Verificare la presenza di più schede di rete

  • Si ricevono vari messaggi di errore durante i controlli preliminari per più schede di rete quando si utilizza un profilo macchina e il parametro NetworkMapping nei comandi New-ProvScheme e Set-ProvScheme.

L’elenco di controllo preliminare per più schede di rete è il seguente:

  • Viene utilizzato e convalidato solo il conteggio delle schede di rete dal modello di profilo macchina. La rete a cui puntano queste schede di rete non viene utilizzata o convalidata rispetto alle reti dell’unità di hosting.
  • Se il conteggio delle schede di rete nel modello di profilo macchina è maggiore del numero di reti nell’unità di hosting, viene visualizzato un messaggio di errore.

  • Se il conteggio delle schede di rete nel modello di profilo macchina è zero, viene visualizzato un messaggio di errore. Quando il conteggio delle schede di rete nel modello di profilo macchina è uno, allora:

    • Se non è specificata alcuna mappatura di rete nel comando New-ProvScheme o Set-ProvScheme e la rete dell’unità di hosting è una, viene utilizzata la rete dell’unità di hosting.
    • Se è specificata una mappatura di rete, viene utilizzata la mappatura di rete specificata se è valida.

  • Quando il numero di NIC nel modello di profilo macchina è maggiore di 1, o il numero di reti dell’unità di hosting è maggiore di 1, allora:

    • È richiesta una mappatura di rete valida nel comando, e questa dovrebbe fornire una mappatura per ogni NIC (ovvero, il conteggio di NetworkMapping deve essere lo stesso del conteggio di NIC del profilo macchina).
    • Non è possibile mappare più NIC alla stessa rete nell’unità di hosting.
    • Il conteggio di NetworkMapping e il conteggio di NIC del profilo macchina devono essere inferiori o uguali al conteggio di reti dell’unità di hosting.
    • NetworkMapping deve essere fornito per ogni ID da 0 a n-1, dove n è il numero di schede di rete nel modello di profilo macchina.

  • Provisioning di un disco dati su VM create con MCS

Un disco dati consente l’archiviazione di dati persistenti come registri eventi, tracce di sicurezza e dati delle applicazioni. È possibile creare e assegnare un disco dati persistente o non persistente a una VM persistente o non persistente creata con MCS di un catalogo macchine MCS in VMware.

Effettuare il provisioning del disco dati dall’immagine master. Il disco dati dell’immagine master preparata viene archiviato nella cartella <Prov Scheme Name>-dataDisk-<datastoreId>.

  • È possibile creare cataloghi MCS basati su profilo macchina e non basati su profilo macchina. Per i cataloghi MCS basati su profilo macchina, è possibile utilizzare la stessa VM dell’immagine master come origine del disco dati per il profilo macchina.

  • Il disco dati della VM di cui è stato eseguito il provisioning deriva proprietà come la policy di archiviazione e le dimensioni dall’immagine master. Per i cataloghi basati su profilo macchina, può facoltativamente utilizzare il disco dati del modello di VM per derivare le proprietà. Se il modello di VM non dispone di un disco dati, viene utilizzata la policy predefinita di Storage.

  • Il disco dati della VM di cui è stato eseguito il provisioning viene creato nella stessa directory del disco del sistema operativo e del disco di identità.

  • Scenari di disco dati supportati

Di seguito sono riportati gli scenari supportati per il disco del sistema operativo e il disco dati:

  • Disco del sistema operativo persistente con disco dati persistente
  • Disco del sistema operativo non persistente con disco dati persistente
  • Disco del sistema operativo non persistente con disco dati non persistente

Nota:

Un catalogo macchine persistente non può avere un disco dati non persistente.

Limitazioni

Le seguenti operazioni non sono attualmente supportate:

  • Provisioning di più di un disco dati.
  • Ripristino del disco dati.
  • Aggiornamento di un catalogo MCS con un disco dati a un catalogo MCS senza disco dati. Allo stesso modo, aggiornamento di un catalogo MCS senza un disco dati a un catalogo MCS con disco dati.

Passaggi chiave

  1. Creare una VM con immagine master con un disco dati in VMware. Per un catalogo MCS basato su profilo macchina, è possibile utilizzare la stessa VM dell’immagine master come origine del disco dati per il profilo macchina.
  2. Creare un catalogo macchine MCS con VM di cui è stato eseguito il provisioning del disco dati utilizzando il comando PowerShell New-ProvScheme. Vedere Creare un catalogo con VM di cui è stato eseguito il provisioning del disco dati.
  3. Aggiungere VM al catalogo utilizzando il comando PowerShell New-ProvVM.
  4. Accedere alla VM per verificare se il disco dati è formattato correttamente. Se sul disco dati a cui si fa riferimento nella VM dell’immagine master è presente del contenuto, tale contenuto sarà presente anche sul disco dati.

Creare una VM con immagine master con disco dati in VMware

  1. Creare una VM con due dischi rigidi. Uno è il disco del sistema operativo e il secondo è il disco dati. Seguire questa guida per aggiungere un nuovo disco rigido (disco dati) a una VM esistente.
  2. Accedere alla VM per inizializzare il disco, impostare la lettera di unità desiderata e aggiungere il contenuto.

Creare un catalogo con VM di cui è stato eseguito il provisioning del disco dati

Includere i seguenti parametri nel comando PowerShell New-ProvScheme per eseguire il provisioning di un catalogo macchine MCS con disco dati.

  • DataDisk: per specificare il percorso del disco dati specificato.
  • DataDiskPersistence: per indicare se il disco dati è persistente o non persistente.

Il disco dati non può essere non persistente se CleanOnBoot è falso. Non è possibile modificare il valore di DataDiskPersistence per un catalogo macchine una volta configurato.

Dopo aver creato il catalogo, aggiungere VM utilizzando il comando New-ProvVM.

Aggiornamento dell’immagine

Eseguire il comando Publish-ProvMasterVMImage per aggiornare l’origine del disco del sistema operativo e del disco dati. Dopo aver eseguito il comando Publish-ProvMasterVMImage:

  • Le nuove VM vengono create con i dischi del sistema operativo e i dischi dati aggiornati.
  • I dischi non persistenti delle VM esistenti vengono aggiornati al successivo ciclo di accensione.
  • I dischi persistenti delle VM esistenti non vengono aggiornati al successivo ciclo di accensione.

Eliminare il disco dati

Se si elimina il catalogo, il disco dati viene eliminato a meno che non si utilizzi l’opzione forgetVM o purgeDBOnly. Se si elimina la VM, il disco dati viene eliminato a meno che non si utilizzi l’opzione forgetVM o purgeDBOnly. Queste condizioni sono applicabili solo ai cataloghi macchine MCS persistenti.

Risoluzione dei problemi

Se la creazione del catalogo non riesce, consultare CTX294978.

Dove andare dopo

Ulteriori informazioni

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