Citrix DaaS

Gestire un catalogo di Microsoft Azure

In Gestire i cataloghi delle macchine sono descritte le procedure guidate per la gestione di un catalogo di macchine. Le seguenti informazioni riguardano i dettagli specifici degli ambienti cloud di Microsoft Azure Resource Manager.

Nota:

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

Portare il tipo di archiviazione a un livello inferiore quando una VM viene arrestata

È possibile risparmiare sui costi di archiviazione cambiando il tipo di archiviazione di un disco gestito portandolo a un livello inferiore quando si spegne una VM. Per fare ciò, utilizzare la proprietà personalizzata StorageTypeAtShutdown.

Il tipo di archiviazione del disco passa a un livello inferiore (come specificato nella proprietà personalizzata StorageTypeAtShutdown) quando si arresta la macchina virtuale. Dopo aver acceso la VM, il tipo di archiviazione torna all’originale (come specificato nella proprietà personalizzata StorageType o nella proprietà personalizzata WBCDiskStorageType).

Importante:

  • Il disco non esiste finché la VM non viene accesa almeno una volta. Pertanto, non è possibile modificare il tipo di archiviazione quando si accende la VM per la prima volta.
  • L’avvio di una macchina virtuale potrebbe richiedere un po’ più di tempo dopo aver modificato il tipo di archiviazione portandolo a un livello inferiore.

Requisiti

  • Applicabile a un disco gestito. Ciò implica impostare la proprietà personalizzata UseManagedDisks su true.
  • Applicabile a un catalogo persistente e non persistente con un disco del sistema operativo persistente. Ciò implica impostare la proprietà personalizzata persistOsDisk su true.
  • Applicabile a un catalogo non persistente con un disco WBC persistente. Ciò implica impostare la proprietà personalizzata persistWBC su true.

Restrizione

  • Come da Microsoft, è possibile cambiare il tipo di disco solo due volte al giorno. Vedere questo documento Microsoft. Nel caso di Citrix, l’aggiornamento di StorageType avviene ogni volta che c’è un’azione Start o Deallocate per la VM. Pertanto, limitare il numero di azioni di alimentazione per VM a due volte al giorno. Ad esempio, un’azione di alimentazione al mattino per avviare la VM e una alla sera per deallocare la VM.

Cambiare il tipo di archiviazione portandolo a un livello inferiore

Prima di procedere con i passaggi, vedere Requisiti e Restrizioni.

  1. Aggiungere la proprietà personalizzata StorageTypeAtShutdown, impostare il valore su Standard_LRS (HDD) e creare un catalogo utilizzando New-ProvScheme. Per informazioni sulla creazione di un catalogo utilizzando PowerShell, vedere https://developer-docs.citrix.com/projects/citrix-virtual-apps-desktops-sdk/en/latest/creating-a-catalog/.

    Nota:

    Se StorageTypeAtShutdown ha un valore diverso da vuoto o Standard_LRS (HDD), l’operazione ha esito negativo.

    Esempio di impostazione di proprietà personalizzate durante la creazione di un catalogo persistente:

    $customProperties='<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <Property xsi:type="StringProperty" Name="UseManagedDisks" Value="true" />
    <Property xsi:type="StringProperty" Name="StorageType" Value="Premium_LRS“ />
    <Property xsi:type="StringProperty" Name="ResourceGroups" Value="" />
    <Property xsi:type="StringProperty" Name="LicenseType" Value="Windows_Client" />
    <Property xsi:type="StringProperty" Name="SchemaVersion" Value="2" />
    <Property xsi:type="StringProperty" Name="OsType" Value="Windows" />
    <Property xsi:type="StringProperty" Name="StorageTypeAtShutdown" Value="Standard_LRS" />
    </CustomProperties>’
    <!--NeedCopy-->
    

    Esempio di impostazione di proprietà personalizzate durante la creazione di un catalogo non persistente:

    $customProperties='<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <Property xsi:type="StringProperty" Name="UseManagedDisks" Value="true" />
    <Property xsi:type="StringProperty" Name="StorageType" Value="Premium_LRS" />
    <Property xsi:type="StringProperty" Name="WbcDiskStorageType" Value="Standard_SSD_LRS" />
    <Property xsi:type="StringProperty" Name="ResourceGroups" Value="" />
    <Property xsi:type="StringProperty" Name="LicenseType" Value="Windows_Client" />
    <Property xsi:type="StringProperty" Name="SchemaVersion" Value="2" />
    <Property xsi:type="StringProperty" Name="OsType" Value="Windows" />
    <Property xsi:type="BooleanProperty" Name="persistWBC" Value=true />
    <Property xsi:type="BooleanProperty" Name="persistOsDisk" Value=true />
    <Property xsi:type="StringProperty" Name="StorageTypeAtShutdown" Value="Standard_LRS" />
    </CustomProperties>’
    <!--NeedCopy-->
    

    Nota:

    Quando si utilizza un profilo macchina, la proprietà personalizzata ha la precedenza sulla proprietà definita in MachineProfile.

  2. Arrestare la macchina virtuale e controllare il tipo di archiviazione della macchina virtuale nel portale di Azure. Il tipo di archiviazione del disco passa a un livello inferiore, come specificato nella proprietà personalizzata StorageTypeAtShutdown.
  3. Accendere la VM. Il tipo di archiviazione del disco torna al tipo di archiviazione indicato in:
    • Proprietà personalizzata StorageType per il disco del sistema operativo
    • Proprietà personalizzata WBCDiskStorageType per il disco WBC solo se specificata in CustomProperties. Altrimenti, torna al tipo di archiviazione indicato in StorageType.

Applicare StorageTypeAtShutdown a un catalogo esistente

Prima di procedere con i passaggi, vedere Requisiti e Restrizioni.

Utilizzare Set-ProvScheme per applicare StorageTypeAtShutdownalle nuove macchine virtuali aggiunte a un catalogo esistente.

Esempio di impostazione di proprietà personalizzate durante l’aggiunta di una macchina virtuale a un catalogo esistente:

$customProperties='<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="UseManagedDisks" Value="true" />
<Property xsi:type="StringProperty" Name="StorageType" Value="Premium_LRS" />
<Property xsi:type="StringProperty" Name="WbcDiskStorageType" Value="Standard_SSD_LRS" />
<Property xsi:type="StringProperty" Name="ResourceGroups" Value="" />
<Property xsi:type="StringProperty" Name="LicenseType" Value="Windows_Client" />
<Property xsi:type="StringProperty" Name="SchemaVersion" Value="2" />
<Property xsi:type="StringProperty" Name="OsType" Value="Windows" />
<Property xsi:type="BooleanProperty" Name="persistWBC" Value=true />
<Property xsi:type="BooleanProperty" Name="persistOsDisk" Value=true />
<Property xsi:type="StringProperty" Name="StorageTypeAtShutdown" Value="Standard_LRS" />
</CustomProperties>’

$ProvScheme = Get-Provscheme -ProvisioningSchemeName $CatalogName

Set-ProvScheme -ProvisioningSchemeName $ProvScheme.ProvisioningSchemeName -CustomProperties $customProperties
<!--NeedCopy-->

Cambiare il tipo di archiviazione delle VM esistenti a un livello inferiore al momento dell’arresto

Prima di procedere con i passaggi, vedere Requisiti e Restrizioni.

È possibile risparmiare sui costi di archiviazione modificando il tipo di archiviazione delle macchine virtuali esistenti su un livello inferiore quando le macchine virtuali vengono arrestate.

Per modificare il tipo di archiviazione delle macchine esistenti in un catalogo portandolo a un livello inferiore quando le macchine virtuali vengono spente:

  1. Aprire una finestra di PowerShell.
  2. Eseguire il comando asnp citrix* per caricare i moduli PowerShell specifici di Citrix.
  3. Eseguire Get-Provscheme -ProvisioningSchemeName $CatalogName.
  4. Modificare la stringa delle proprietà personalizzate.

    $customProperties = '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <Property xsi:type="StringProperty" Name="StorageTypeAtShutdown" Value="Standard_LRS" />
    </CustomProperties>'
    <!--NeedCopy-->
    
  5. Aggiornare lo schema di provisioning del catalogo esistente. L’aggiornamento si applica alle nuove VM aggiunte dopo l’esecuzione di Set-ProvScheme.

    Set-ProvScheme -ProvisioningSchemeName $CatalogName -CustomProperties $customProperties
    <!--NeedCopy-->
    
  6. Aggiornare le VM esistenti per abilitarle StorageTypeAtShutdown.

    Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
    <!--NeedCopy-->
    
  7. Alla successiva accensione delle macchine, la proprietà StorageTypeAtShutdown delle macchine viene aggiornata. Il tipo di archiviazione cambia al successivo arresto.
  8. Eseguire il comando seguente per visualizzare il valore StorageTypeAtShutdown di ciascuna macchina virtuale di un catalogo:

    Get-ProvVM -ProvisioningSchemeName <catalog-name> | foreach { $vmName = $\_.VMName; $storageTypeAtShutdown = ($\_.CustomVmData | ConvertFrom-Json).StorageTypeAtShutdown.DiskStorageAccountType; return New-Object psobject -Property @{ "VMName" = $vmName; "StorageTypeAtShutdown" = $storageTypeAtShutdown } }
    <!--NeedCopy-->
    

Aggiornare le macchine di cui è stato eseguito il provisioning allo stato corrente dello schema di provisioning

Il comando Set-ProvScheme modifica lo schema di provisioning. Tuttavia, non influisce sulle macchine esistenti. Utilizzando il comando Set-ProvVMUpdateTimeWindow di PowerShell, è possibile applicare lo schema di provisioning corrente a una macchina o a un set di macchine esistente persistente o non persistente. È inoltre possibile pianificare una fascia oraria per gli aggiornamenti della configurazione dei computer esistenti forniti da MCS. Eventuali accensioni o riavvii durante la fascia oraria pianificata applicano un aggiornamento pianificato dello schema di provisioning a una macchina. Attualmente, in Azure, è possibile aggiornare ServiceOffering, MachineProfile e le seguenti proprietà personalizzate:

  • StorageType
  • WBCDiskStorageType
  • IdentityDiskStorageType
  • LicenseType
  • DedicatedHostGroupId
  • PersistWBC
  • PersistOsDisk
  • PersistVm

Nota:

  • È possibile aggiornare StorageType, WBCDiskStorageType e le proprietà personalizzate IdentityDiskStorageType di un catalogo solo usando il disco gestito in ambienti Azure.
  • Se si esegue Set-ProvVMUpdateTimeWindow due volte, ha effetto il comando più recente.

È possibile aggiornare:

  • Una singola macchina virtuale
  • Un elenco di macchine virtuali specifiche o di tutte le macchine virtuali esistenti associate a un ID di schema di provisioning
  • Un elenco di macchine virtuali specifiche o di tutte le macchine virtuali esistenti associate a un nome di schema di provisioning (nome del catalogo macchine)

Dopo aver apportato le seguenti modifiche allo schema di provisioning, l’istanza della macchina virtuale viene ricreata per i cataloghi persistenti in Azure:

  • Cambiare MachineProfile
  • Rimuovere LicenseType
  • Rimuovere DedicatedHostGroupId

Nota:

Il disco del sistema operativo delle macchine esistenti, insieme a tutti i relativi dati, rimane invariato e al disco viene collegata una nuova VM.

Prima di aggiornare le macchine virtuali esistenti:

  1. Verificare la configurazione delle macchine esistenti. Ad esempio,

    Get-ProvScheme | select ProvisioningSchemeName, ProvisioningSchemeVersion
    <!--NeedCopy-->
    
  2. Aggiornare lo schema di provisioning. Ad esempio,

    • Con la VM come input del profilo macchina:

       Set-ProvScheme -ProvisioningSchemeName "my-catalog" -MachineProfile "XDHyp:\HostingUnits<hosting-unit>\machineprofile.folder<resource-group>.resourcegroup<virtual-machine>.vm"
       <!--NeedCopy-->
      
    • Con le specifiche di modello come input del profilo macchina:

       Set-ProvScheme -ProvisioningSchemeName "my-catalog"
       -MachineProfile "XDHyp:\HostingUnits<hosting-unit>\machineprofile.folder<resource-group>.resourcegroup<template-spec>.templatespec<template-spec-version>.templatespecversion"
       -ServiceOffering "XDHyp:\HostingUnits<hosting-unit>\serviceoffering.folder<service-offering>.serviceoffering"
       <!--NeedCopy-->
      
    • Con solo questa offerta di servizi:

       Set-ProvScheme -ProvisioningSchemeName "my-catalog" -ServiceOffering "XDHyp:\HostingUnits<hosting-unit>\serviceoffering.folder<service-offering>.serviceoffering"
       <!--NeedCopy-->
      
  3. Verifica se la proprietà corrente della VM corrisponde allo schema di provisioning corrente e se c’è qualche azione di aggiornamento in sospeso sulla VM. Ad esempio,

    Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion
    <!--NeedCopy-->
    

    È anche possibile trovare macchine con una versione particolare. Ad esempio,

    Get-ProvVM -Filter "ProvisioningSchemeVersion -eq 1" | select VMName, ProvisioningSchemeVersion
    <!--NeedCopy-->
    

Per richiedere gli aggiornamenti delle macchine esistenti da applicare al prossimo riavvio:

  1. Eseguire i seguenti comandi per aggiornare i computer esistenti e far applicare gli aggiornamenti al successivo riavvio.

    • Per aggiornare tutte le macchine esistenti: Ad esempio,

       Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
       <!--NeedCopy-->
      
    • Per aggiornare un elenco di macchine specifiche. Ad esempio,

       Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -VMName <List-Of-Vm-Names> -StartsNow -DurationInMinutes -1
       <!--NeedCopy-->
      
    • Per aggiornare le macchine 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 vi è alcun limite superiore nella finestra oraria della pianificazione.
  2. Trovare i computer con un aggiornamento pianificato. Ad esempio,

    Get-ProvVM -Filter "ProvisioningSchemeUpdateAfter" | select VMName, ProvisioningSchemeUpdateAfter
    <!--NeedCopy-->
    
  3. Riavviare le macchine. Alla successiva accensione, le modifiche delle proprietà vengono applicate ai computer esistenti. È possibile verificare lo stato aggiornato utilizzando il comando che segue. Ad esempio,

    Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion
    <!--NeedCopy-->
    

Per pianificare l’aggiornamento di una VM alle impostazioni di provisioning più recenti la prossima volta che verrà avviata nella finestra temporale pianificata:

  1. Eseguire i seguenti comandi:

    • Per pianificare un aggiornamento con l’ora di inizio come ora corrente:

       Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -VMName vm1 -StartsNow -DurationInMinutes 120
       <!--NeedCopy-->
      
    • Per programmare un aggiornamento durante un fine settimana:

        Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName “ my-catalog “ -VMName “vm1” -StartTimeInUTC “10/15/2022 9:00am” -DurationInMinutes (New –TimeSpan –Days 2).TotalMinutes
        <!--NeedCopy-->
      

    Nota:

    • VMName è opzionale. Se non specificato, l’aggiornamento è pianificato per l’intero catalogo.
    • Invece di StartTimeInUTC, utilizzare StartsNow per indicare che l’ora di inizio della pianificazione è l’ora corrente.
    • DurationInMinutes è opzionale. L’impostazione predefinita è 120 minuti. Un numero negativo (ad esempio -1) non indica alcun limite superiore nella finestra oraria della pianificazione.
  2. Controllare lo stato dell’aggiornamento.

    Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeUpdateUntil, ProvisioningSchemeVersion
    <!--NeedCopy-->
    
  3. Accendere la VM. Se si accende il computer dopo la fascia oraria pianificata, l’aggiornamento della configurazione non viene applicato. Se si accende la macchina entro la fascia oraria pianificata,

    • Se la macchina è spenta e
      • non si accende la macchina, l’aggiornamento della configurazione non viene applicato
      • si accende la macchina, viene applicato l’aggiornamento della configurazione
    • Se la macchina è accesa e
      • non si riavvia la macchina, l’aggiornamento della configurazione non viene applicato
      • si riavvia la macchina, viene applicato l’aggiornamento della configurazione

Per annullare l’aggiornamento della configurazione:

È anche possibile annullare un aggiornamento della configurazione di una singola macchina virtuale, di più macchine virtuali 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 macchina virtuale:

       Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName “ my-catalog “ -VMName “vm1”
       <!--NeedCopy-->
      
    • Per annullare l’aggiornamento della configurazione pianificato per più macchine virtuali:

        Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName "my-catalog" -VMName "vm1","vm2"
       <!--NeedCopy-->
      

Nota:

Le macchine virtuali devono appartenere allo stesso catalogo.

Aggiornare le proprietà delle singole macchine virtuali

È possibile aggiornare le proprietà delle singole macchine virtuali incluse in un catalogo di macchine MCS persistente utilizzando il comando PowerShell Set-ProvVM. Tuttavia, gli aggiornamenti non vengono applicati immediatamente. È necessario impostare la finestra temporale utilizzando il comando PowerShell Set-ProvVMUpdateTimeWindow per applicare gli aggiornamenti.

Questa implementazione consente di gestire le singole macchine virtuali in modo efficiente senza aggiornare l’intero catalogo di macchine. Attualmente, questa funzionalità è applicabile solo all’ambiente Azure.

Attualmente, le proprietà che è possibile aggiornare sono:

  • CustomProperties
  • ServiceOffering
  • MachineProfile

Utilizzando questa funzionalità, è possibile:

Prima di aggiornare le proprietà di una macchina virtuale:

  1. Aprire una finestra di PowerShell.
  2. Eseguire il comando asnp citrix* per caricare i moduli PowerShell specifici di Citrix.
  3. Verificare la configurazione del catalogo di macchine esistente. Ad esempio:

    Get-ProvScheme -ProvisioningSchemeName AzureCatalog
    <!--NeedCopy-->
    
  4. Verificare la configurazione della macchina virtuale a cui si desidera applicare gli aggiornamenti. Ad esempio:

    Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
    <!--NeedCopy-->
    

Aggiornare le proprietà di una macchina virtuale

Effettuare le seguenti operazioni per aggiornare le proprietà su una macchina virtuale:

  1. Disattivare la macchina virtuale a cui si intende applicare gli aggiornamenti.
  2. Aggiornare le proprietà della macchina virtuale. Ad esempio, se si desidera aggiornare la proprietà personalizzata del tipo di archiviazione (StorageType) della macchina virtuale, eseguire i comandi seguenti:

    Set-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1 -CustomProperties "...<Property Name='StorageType' Value='Premium_LRS' />..."
    <!--NeedCopy-->
    

    È possibile aggiornare contemporaneamente le proprietà di due macchine virtuali appartenenti a un catalogo di macchine. Ad esempio:

    Set-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1 -CustomProperties "...<Property Name='StorageType' Value='Premium_LRS' />..."
    <!--NeedCopy-->
    
    Set-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine2 -CustomProperties "...<Property Name='StorageType' Value='StandardSSD_LRS' />..."
    <!--NeedCopy-->
    

    Nota:

    Gli aggiornamenti non vengono applicati immediatamente.

  3. Ottenere l’elenco delle proprietà specificate per l’aggiornamento e la versione di configurazione. Ad esempio:

    Get-ProvVMConfiguration -ProvisioningSchemeName AzureCatalog -VMName machine1
    <!--NeedCopy-->
    

    Controllare il valore della proprietà di Version e le proprietà da aggiornare (in questo caso, StorageType).

  4. Controllare la versione della configurazione. Ad esempio:

    Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
    <!--NeedCopy-->
    

    Controllare il valore della proprietà di ProvVMConfigurationVersion. L’aggiornamento non è ancora stato applicato. La VM è ancora nella vecchia configurazione.

  5. Richiedere un aggiornamento pianificato. Ad esempio:

     Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName AzureCatalog -StartsNow -DurationInMinutes -1
     <!--NeedCopy-->
    

    Per ulteriori informazioni, vedere Aggiornare le macchine di cui è stato eseguito il provisioning allo stato corrente dello schema di provisioning.

    Nota:

    Viene inoltre applicato qualsiasi aggiornamento dello schema di provisioning in sospeso.

  6. Riavviare la macchina virtuale. Ad esempio:

    New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
    <!--NeedCopy-->
    
  7. Controllare la versione della configurazione. Ad esempio:

    Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
    <!--NeedCopy-->
    

    Controllare il valore della proprietà di ProvVMConfigurationVersion. L’aggiornamento viene ora applicato. La VM ora ha la nuova configurazione.

  8. Per applicare ulteriori aggiornamenti della configurazione alla macchina virtuale, arrestare la macchina virtuale e ripetere i passaggi.

Conservare le proprietà aggiornate di una macchina virtuale dopo l’aggiornamento del catalogo delle macchine

Effettuare le seguenti operazioni per mantenere le proprietà aggiornate su una macchina virtuale:

  1. Disattivare la macchina virtuale a cui si intende applicare gli aggiornamenti.
  2. Aggiornare il catalogo delle macchine. Ad esempio, se si desidera modificare la dimensione della macchina virtuale (ServiceOffering) e il tipo di archiviazione (StorageType), eseguire i comandi seguenti:

    Set-ProvScheme -ProvisioningSchemeName AzureCatalog -ServiceOffering Standard_E4_v3 -CustomProperties "...<Property Name='StorageType' Value='StandardSSD_LRS' />..."
    <!--NeedCopy-->
    
  3. Ottenere i dettagli di configurazione del catalogo di macchine. Ad esempio:

    Get-ProvScheme -ProvisioningSchemeName AzureCatalog
    <!--NeedCopy-->
    

    Ora ProvisioningSchemeVersion è incrementato di uno. Vengono inoltre aggiornate le dimensioni e il tipo di archiviazione della VM.

  4. Aggiornare le proprietà della macchina virtuale. Ad esempio, fornire un profilo macchina alla macchina virtuale.

    Set-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1 -MachineProfile "XDHyp:\HostingUnits<hosting-unit>\machineprofile.folder<resource-group>.resourcegroup<template-spec>.templatespec<template-spec-version>.templatespecversion"
    <!--NeedCopy-->
    

    Nota:

    L’input del profilo macchina ha un tag e una dimensione di VM diversa (ServiceOffering) specificata.

  5. Ottenere l’elenco delle proprietà che la macchina virtuale avrà dopo aver unito gli aggiornamenti di configurazione effettuati sulla macchina virtuale con gli aggiornamenti del catalogo delle macchine. Ad esempio:

    Get-ProvVMConfigurationResultantSet -ProvisioningSchemeName AzureCatalog -VMName machine1
    <!--NeedCopy-->
    

    Nota:

    Qualsiasi aggiornamento avvenuto sulla macchina virtuale sovrascriverà gli aggiornamenti effettuati sul catalogo delle macchine.

  6. Richiedere un aggiornamento pianificato per la macchina virtuale. Ad esempio:

    Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName AzureCatalog -VMName machine1 -StartsNow -DurationInMinutes -1
    <!--NeedCopy-->
    
  7. Riavviare la macchina virtuale. Ad esempio:

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

    La macchina virtuale mantiene le proprie dimensioni aggiornate derivate dal profilo macchina. I valori dei tag specificati nel profilo macchina vengono applicati anche alla macchina virtuale. Tuttavia, il tipo di archiviazione deriva dallo schema di provisioning più recente.

  8. Ottenere la versione di configurazione della VM. Ad esempio:

    Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
    <!--NeedCopy-->
    

    ProvisioningSchemeVersion e ProvVMConfigurationVersion ora mostrano la versione più recente.

Ripristinare gli aggiornamenti di configurazione applicati a una macchina virtuale

  1. Dopo aver applicato gli aggiornamenti a una macchina virtuale, arrestare la macchina virtuale.
  2. Eseguire il comando seguente per rimuovere gli aggiornamenti applicati alla macchina virtuale. Ad esempio:

    Set-ProvVM -RevertToProvSchemeConfiguration -ProvisioningSchemeName AzureCatalog -VMName machine1
    <!--NeedCopy-->
    
  3. Richiedere un aggiornamento pianificato per la macchina virtuale. Ad esempio:

    Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName AzureCatalog -VMName machine1 -StartsNow -DurationInMinutes -1
    <!--NeedCopy-->
    
  4. Riavviare la macchina virtuale. Ad esempio:

    New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
    <!--NeedCopy-->
    
  5. Controllare la versione di configurazione della VM. Ad esempio:

    Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
    <!--NeedCopy-->
    

    Il valore ProvVMConfigurationVersion è ora la versione di configurazione del catalogo macchine.

Recuperare informazioni per le macchine virtuali di Azure, le snapshot, il disco del sistema operativo e la definizione delle immagini della raccolta

È possibile visualizzare informazioni per una macchina virtuale di Azure, inclusi il disco e il tipo del sistema operativo, la snapshot e la definizione delle immagini della raccolta. Queste informazioni vengono visualizzate per le risorse sull’immagine master quando viene assegnato un catalogo delle macchine. Utilizzare questa funzionalità per visualizzare e selezionare un’immagine Linux o Windows. Una proprietà PowerShell, TemplateIsWindowsTemplate, è stata aggiunta al parametro AdditionDatafield. Questo campo contiene informazioni specifiche di Azure: tipo di macchina virtuale, disco del sistema operativo, informazioni sulle immagini della raccolta e informazioni sul tipo di sistema operativo. L’impostazione di TemplateIsWindowsTemplate su True indica che il tipo di sistema operativo è Windows; l’impostazione di TemplateIsWindowsTemplate su False indica che il tipo di sistema operativo è Linux.

Suggerimento:

Le informazioni visualizzate dalla proprietà PowerShell TemplateIsWindowsTemplate derivano dall’API di Azure. A volte, questo campo potrebbe essere vuoto. Ad esempio, una snapshot di un disco di dati non contiene il campo TemplateIsWindowsTemplate perché il tipo di sistema operativo non può essere recuperato da una snapshot.

Ad esempio, impostare il parametro AdditionData della macchina virtuale di Azure su True per il tipo di sistema operativo Windows utilizzando PowerShell:

PS C:\Users\username> (get-item XDHyp:\HostingUnits\mynetwork\image.folder\username-dev-testing-rg.resourcegroup\username-dev-tsvda.vm).AdditionalData
Key Value
ServiceOfferingDescription Standard_B2ms
HardDiskSizeGB 127
ResourceGroupName FENGHUAJ-DEV-TESTING-RG
ServiceOfferingMemory 8192
ServiceOfferingCores 2
TemplateIsWindowsTemplate True
ServiceOfferingWithTemporaryDiskSizeInMb 16384
SupportedMachineGenerations Gen1,Gen2
<!--NeedCopy-->

Recuperare informazioni sui nomi delle regioni per macchine virtuali di Azure, dischi gestiti, snapshot, Azure VHD e modelli ARM

È possibile visualizzare informazioni sul nome della regione per una macchina virtuale di Azure, dischi gestiti, snapshot, Azure VHD e modelli ARM. Queste informazioni vengono visualizzate per le risorse sull’immagine master quando viene assegnato un catalogo delle macchine. Una proprietà PowerShell denominata RegionName visualizza le informazioni sul nome della regione quando si esegue il comando PowerShell con il parametro AdditionalData.

Ad esempio, utilizzare il seguente comando PowerShell per ottenere informazioni su una macchina virtuale in Azure.

PS C:\Windows\system32> (get-item XDHyp:\HostingUnits\myAzureNetwork\image.folder\hu-dev-testing-rg.resourcegroup\hu-dev-tsvda.vm).AdditionalData
Key Value
HardDiskSizeGB 127
ResourceGroupName HU-DEV-TESTING-RG
RegionName East US
TemplateIsWindowsTemplate True
LicenseType
ServiceOfferingDescription Standard_B2ms
ServiceOfferingMemory 8192
ServiceOfferingCores 2
SupportedMachineGenerations Gen1,Gen2
ServiceOfferingWithTemporaryDiskSizeInMb 16384
SecurityType
SecureBootEnabled
VTpmEnabled
<!--NeedCopy-->

Identificare le risorse create da MCS

Di seguito sono riportati i tag che MCS aggiunge alle risorse sulla piattaforma Azure. I tag nella tabella sono rappresentati come “key”:”value”.

Nome della risorsa Tag
Disco ID “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “CitrixResource” : “Internal”
Immagine “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “CitrixResource” : “Internal”
NIC “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “CitrixResource” : “Internal”
Disco del sistema operativo “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “CitrixResource” : “Internal”
PrepVM “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “CitrixResource” : “Internal”
Snapshot pubblicata “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “CitrixResource” : “Internal”
Gruppo di risorse “CitrixResource” : “Internal”
  CitrixSchemaVersion: 2.0
  “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
Account di archiviazione “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “CitrixResource” : “Internal”
Macchina virtuale nel catalogo “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “CitrixResource” : “Internal”
Disco WBC “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “CitrixResource” : “Internal”

Nota:

Una macchina virtuale non è visibile nell’inventario Citrix se viene aggiunto un tag CitrixResource per identificarla come risorsa creata da MCS. È possibile rimuovere o rinominare il tag per renderlo visibile.

Rimuovere i tag

Quando si crea un catalogo o una macchina virtuale, vengono creati tag sulle risorse seguenti:

  • Gruppo di risorse
  • Macchina virtuale
  • Disco del sistema operativo
  • Disco di identità
  • Interfaccia di rete
  • Account di archiviazione

È possibile rimuovere macchine virtuali e cataloghi di macchine dal database Citrix e rimuovere i tag. È possibile usare:

  • Remove-ProvVM con il parametro ForgetVM per rimuovere macchine virtuali e tag da una singola macchina virtuale o un elenco di macchine virtuali da un catalogo di macchine.
  • Remove-ProvScheme con il parametro ForgetVM per rimuovere un catalogo di macchine dal database Citrix e tag da un intero catalogo di macchine.

Questa funzionalità è applicabile solo alle macchine virtuali persistenti.

A questo scopo:

  1. Aprire una finestra di PowerShell.
  2. Eseguire il comando asnp citrix* per caricare i moduli PowerShell specifici di Citrix.
  3. Eseguire Remove-ProvVM per eliminare le VM dal database Citrix e i tag dalle VM. Ad esempio:

    Remove-ProvVM -ProvisioningSchemeName “ProvisioningSchemeName” -VMName “vmname” -ForgetVM
    <!--NeedCopy-->
    
  4. Eseguire Remove-ProvScheme per eliminare il catalogo macchine dal database Citrix e i tag dai cataloghi di macchine. Ad esempio:

    Remove-ProvScheme -ProvisioningSchemeName “ProvisioningSchemeName” -ForgetVM
    <!--NeedCopy-->
    

    Nota:

    Dopo aver utilizzato il parametro ForgetVM in Remove-ProvScheme, MCS elimina tutte le snapshot, inclusa la snapshot del disco di base, se lo schema di provisioning è presente in Bring your own resource group (BYORG) o nel gruppo di risorse gestito da Citrix.

Ulteriori informazioni