Citrix Virtual Apps and Desktops

Unione di più siti in un unico sito

April 27, 2026

Grazie al contributo di:

C C

Il supporto multisito per la configurazione automatizzata fornisce un metodo per unire più siti on-premise in un unico sito cloud.

Il supporto multisito aggiunge prefissi e suffissi univoci ai nomi dei componenti per ogni sito on-premise, garantendo l’unicità dei nomi dopo che più siti on-premise sono stati uniti in un unico sito cloud.

Prefissi e suffissi possono essere assegnati per ciascuno dei seguenti componenti per ogni sito on-premise.

AdminScope
AdminRole
ApplicationAdmin
ApplicationFolder
ApplicationGroup
ApplicationUser
DeliveryGroup
GroupPolicy
HostConnection
MachineCatalog
StoreFront
Tag

Le cartelle delle applicazioni supportano la prefissazione, la suffissazione e il re-rooting. Il re-rooting aggiunge una cartella di livello superiore aggiuntiva alla struttura di cartelle esistente di un’applicazione.

Regole di prefissazione e suffissazione

Prefissi e suffissi non possono contenere nessuno dei seguenti caratteri speciali: \ , / ; : # . * ? = < > | ( ) " ' { } [ ]
Prefissi e suffissi possono contenere spazi finali ma non spazi iniziali.
Prefissi e suffissi devono essere racchiusi tra virgolette doppie per contenere spazi finali.
Prefissi e suffissi vengono applicati al momento dell’importazione, dell’unione e dell’aggiunta. I file .yml di origine non vengono mai modificati.
Il processo di prefissazione e suffissazione aggiunge automaticamente prefissi o suffissi ai nomi dei componenti dipendenti, ove applicabile. Ad esempio, se i nomi dei cataloghi di macchine sono prefissati con “East”, anche i gruppi di consegna che li fanno riferimento vengono prefissati con “East”.
Se un nome di componente inizia già con il prefisso o il suffisso, non viene aggiunto alcun prefisso o suffisso. I nomi dei componenti non possono contenere doppi prefissi o suffissi identici.
Prefissi e suffissi possono essere utilizzati singolarmente o in combinazione.
L’uso di un prefisso o di un suffisso su un componente è facoltativo.

Nota:

Studio visualizza i componenti in ordine alfabetico.

Raggruppare i componenti per sito

Utilizzare la prefissazione per raggruppare visivamente i componenti di un singolo sito. Ogni sito è elencato nel proprio gruppo, con la prefissazione che controlla alfabeticamente l’ordinamento dei diversi gruppi di siti.

Raggruppare i componenti per nome

Utilizzare la suffissazione per raggruppare visivamente i componenti con nomi simili da più siti. I componenti con nomi simili provenienti da siti diversi si alternano visivamente.

File di mappatura prefissi e suffissi

La prefissazione del sito inizia con il file SiteMerging.yml che contiene la mappatura dei prefissi e dei suffissi del sito per uno o più siti on-premise. È possibile gestire il file SiteMerging.yml manualmente o utilizzando i cmdlet disponibili elencati nella sezione Cmdlet per l’unione di più siti on-premise.

Esportare il sito on-premise

L’unione non può iniziare finché non è stato esportato un sito on-premise. Per esportare un sito on-premise, vedere Esportare la configurazione on-premise.

Cartella di destinazione dell’esportazione centrale

I metodi descritti in questa sezione posizionano più esportazioni di siti in una posizione di condivisione file centrale. Il file SiteMerging.yml, il file CustomerInfo.yml e tutti i file di esportazione risiedono in tale posizione di condivisione file, consentendo di eseguire l’importazione da un’unica posizione indipendentemente dai siti on-premise.

Le operazioni di accesso al cloud non fanno mai riferimento ai siti on-premise o ad Active Directory, consentendo quindi di eseguire operazioni di accesso al cloud da qualsiasi luogo.

Condivisione file diretta

Esistono due metodi per eseguire questa operazione:

Condivisione file diretta: per importare, unire o aggiungere da una condivisione file diretta, è necessario decidere da quale macchina si desidera eseguire l’operazione di accesso al cloud.
Riferimento alla condivisione file tramite SiteMerging.yml: questo metodo utilizza il membro SiteRootFolder del set di prefissi del sito e riduce le probabilità di specificare la cartella sbagliata durante l’esportazione, l’importazione, l’unione o l’aggiunta.

Se non si utilizza un metodo di condivisione file centrale, eseguire l’importazione, l’unione o l’aggiunta dai singoli Delivery Controller. Creare e replicare il file SiteMerging.yml su ogni Delivery Controller migrato nel cloud. La posizione predefinita è %HOMEPATH%\Documents\Citrix\AutoConfig. È necessario specificare il parametro –SiteName per selezionare i prefissi del sito corretti.

Condivisione file diretta

Le operazioni di esportazione, importazione, unione e nuova/aggiunta forniscono un parametro per specificare una cartella di destinazione o di origine diversa dalla cartella predefinita, %HOMEPATH%\Documents\Citrix\AutoConfig. Gli esempi seguenti utilizzano una condivisione file centrale situata in \\share.central.net a cui l’amministratore ha già accesso, avendo fornito le credenziali necessarie.

Per specificare la destinazione dell’esportazione in una cartella specifica del sito, utilizzare il parametro –TargetFolder:

Dal Delivery Controller East™:

mkdir \\share.central.net\AutoConfig\SiteEast

Export-CvadAcToFile –TargetFolder \\share.central.net\AutoConfig\SiteEast

Dal Delivery Controller West:

mkdir \\share.central.net\AutoConfig\SiteWest

Export-CvadAcToFile –TargetFolder \\share.central.net\AutoConfig\SiteWest

Una volta completate le esportazioni, creare i file CustomerInfo.yml e SiteMerging.yml e posizionarli in \\share.central.net\AutoConfig.

Nota:

Non utilizzare il parametro SiteRootFolder quando si crea SitePrefixes.yml con questo metodo di riferimento diretto alla condivisione file.

Per importare, unire o aggiungere da una condivisione file diretta, è necessario decidere da quale macchina si desidera eseguire l’operazione di accesso al cloud. Le opzioni includono:

Uno dei Delivery Controller on-premise in cui lo strumento è già installato.
La macchina che ospita la condivisione file.
Una macchina diversa.

La configurazione automatizzata deve essere installata sulla macchina che accede al cloud. Non vengono utilizzati né l’SDK PowerShell on-premise, né i Delivery Controller, né Active Directory, quindi i requisiti di esecuzione dell’accesso al cloud sono più semplici rispetto ai requisiti di esportazione.

Per unire i Delivery Controller East al cloud:

Merge-CvadAcToSite –SiteName East –SourceFolder \\share.central.net\AutoConfig\SiteEast -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml

Per unire i Delivery Controller West al cloud:

Merge-CvadAcToSite –SiteName West –SourceFolder \\share.central.net\AutoConfig\SiteWest -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml

Di seguito è riportato un esempio di file SitePrefixes.yml utilizzato nell’esempio precedente.

        East:
          SiteRootFolder: "" # Important: leave this empty
          AdminScopePrefix: "East_"
          AdminRolePrefix: "East_"
          ApplicationAdminPrefix: "East_"
          ApplicationFolderPrefix: "" # Note that a new parent root folder is used instead
          ApplicationFolderRoot: "East"
          ApplicationGroupPrefix: "East_"
          ApplicationUserPrefix: "East_"
          DeliveryGroupPrefix: "East_"
          GroupPolicyPrefix: "East_"
          HostConnectionPrefix: "East_"
          MachineCatalogPrefix: "East_"
          StoreFrontPrefix: "East_"
          TagPrefix: "East_"
          AdminScopeSuffix: "_east"
          AdminRoleSuffix: "_east"
          ApplicationAdminSuffix: "_east"
          ApplicationFolderSuffix: "_east"
          ApplicationGroupSuffix: "_east"
          ApplicationUserSuffix: "_east"
          DeliveryGroupSuffix: "_east"
          GroupPolicySuffix: "_east"
          HostConnectionSuffix: "_east"
          MachineCatalogSuffix: "_east"
          StoreFrontSuffix: "_east"
          TagSuffix: "_east"
        West:
          SiteRootFolder: "" # Important: leave this empty
          AdminScopePrefix: "Western "
          AdminRolePrefix: "Western "
          ApplicationAdminPrefix: "Western "
          ApplicationFolderPrefix: "" # Note that a new parent root folder is used instead
          ApplicationFolderRoot: "Western"
          ApplicationGroupPrefix: "Western "
          ApplicationUserPrefix: "Western "
          DeliveryGroupPrefix: "Western "
          GroupPolicyPrefix: "Western "
          HostConnectionPrefix: "Western "
          MachineCatalogPrefix: "Western "
          StoreFrontPrefix: "Western "
          TagPrefix: "Western "
          AdminScopeSuffix: ""
          AdminRoleSuffix: ""
          ApplicationAdminSuffix: ""
          ApplicationFolderSuffix: ""
          ApplicationGroupSuffix: ""
          ApplicationUserSuffix: ""
          DeliveryGroupSuffix: ""
          GroupPolicySuffix: ""
          HostConnectionSuffix: ""
          MachineCatalogSuffix: ""
          StoreFrontSuffix: ""
          TagSuffix: ""
<!--NeedCopy-->

Riferimento alla condivisione file tramite SiteMerging.yml

Questo metodo utilizza il membro SiteRootFolder del set di prefissi del sito. Sebbene più complesso del metodo di condivisione file diretta, questo metodo riduce le probabilità di specificare la cartella sbagliata durante l’esportazione, l’importazione, l’unione o l’aggiunta.

Innanzitutto, impostare SiteRootFolder per ogni sito nel file SiteMerging.yml. È necessario eseguire questa operazione nella posizione condivisa.

New-CvadAcSiteMergingInfo –SiteName East –SiteRootFolder \\share.central.net\AutoConfig\SiteEast -SitePrefixesFolder \\share.central.net\AutoConfig

New-CvadAcSiteMergingInfo –SiteName West –SiteRootFolder SiteWest -SitePrefixesFolder \\share.central.net\AutoConfig

In questo esempio, East è una specifica di cartella completa e West è una specifica di cartella relativa.

Per specificare la destinazione dell’esportazione in una cartella specifica del sito utilizzando il file SiteMerging.yml:

Dal Delivery Controller East:

mkdir \\share.central.net\AutoConfig\SiteEast

Export-CvadAcToFile -SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml

Dal Delivery Controller West:

mkdir \\share.central.net\AutoConfig\SiteWest

Export-CvadAcToFile -SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml

Il cmdlet di esportazione utilizza la posizione della cartella CustomerInfo.yml per individuare il file SiteMerging.yml. Nel caso di East, SiteRootFolder è completo. Viene utilizzato così com’è. Nel caso di West, SiteRootFolder non è completo. Viene combinato con la posizione della cartella CustomerInfo.yml per recuperare una posizione di cartella completa per West.

Per unire il Delivery Controller East al cloud:

Merge-CvadAcToSite –SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml

Per unire il Delivery Controller West al cloud:

Merge-CvadAcToSite –SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml

Di seguito è riportato un esempio di file SitePrefixes.yml utilizzato nell’esempio precedente.

          East:
          SiteRootFolder: "\\\\share.central.net\\AutoConfig\\SiteEast"
          AdminScopePrefix: "East_"
          AdminRolePrefix: "East_"
          ApplicationAdminPrefix: "East_"
          ApplicationFolderPrefix: "" # Note that a new parent root folder is used instead
          ApplicationFolderRoot: "East"
          ApplicationGroupPrefix: "East_"
          ApplicationUserPrefix: "East_"
          DeliveryGroupPrefix: "East_"
          GroupPolicyPrefix: "East_"
          HostConnectionPrefix: "East_"
          MachineCatalogPrefix: "East_"
          StoreFrontPrefix: "East_"
          TagPrefix: "East_"
          AdminScopeSuffix: "_east"
          AdminRoleSuffix: "_east"
          ApplicationAdminSuffix: "_east"
          ApplicationFolderSuffix: "_east"
          ApplicationGroupSuffix: "_east"
          ApplicationUserSuffix: "_east"
          DeliveryGroupSuffix: "_east"
          GroupPolicySuffix: "_east"
          HostConnectionSuffix: "_east"
          MachineCatalogSuffix: "_east"
          StoreFrontSuffix: "_east"
          TagSuffix: "_east"
        West:
          SiteRootFolder: "\\\\share.central.net\\AutoConfig\\SiteWest"
          AdminScopePrefix: "Western "
          AdminRolePrefix: "Western "
          ApplicationAdminPrefix: "Western "
          ApplicationFolderPrefix: "" # Note that a new parent root folder is used instead
          ApplicationFolderRoot: "Western"
          ApplicationGroupPrefix: "Western "
          ApplicationUserPrefix: "Western "
          DeliveryGroupPrefix: "Western "
          GroupPolicyPrefix: "Western "
          HostConnectionPrefix: "Western "
          MachineCatalogPrefix: "Western "
          StoreFrontPrefix: "Western "
          TagPrefix: "Western "
          AdminScopeSuffix: ""
          AdminRoleSuffix: ""
          ApplicationAdminSuffix: ""
          ApplicationFolderSuffix: ""
          ApplicationGroupSuffix: ""
          ApplicationUserSuffix: ""
          DeliveryGroupSuffix: ""
          GroupPolicySuffix: ""
          HostConnectionSuffix: ""
          MachineCatalogSuffix: ""
          StoreFrontSuffix: ""
          TagSuffix: ""
<!--NeedCopy-->

Se non si utilizza un metodo di condivisione file centrale e l’importazione, l’unione o l’aggiunta viene eseguita dai singoli Delivery Controller, creare e replicare il file SiteMerging.yml su ogni Delivery Controller migrato nel cloud. La posizione predefinita è %HOMEPATH%\Documents\Citrix\AutoConfig. È necessario specificare il parametro –SiteName per selezionare i prefissi del sito corretti.

Unire i siti

Citrix® consiglia di eseguire le operazioni cloud in più fasi e di effettuare una revisione completa di ogni risultato prima di eseguire l’operazione cloud successiva. Ad esempio, se si uniscono tre siti in un unico sito cloud:

Unire il sito iniziale al cloud utilizzando il valore SiteName appropriato.
Rivedere i risultati in Studio.
Se i risultati non sono corretti, determinare il problema e la sua causa, correggerlo e quindi eseguire nuovamente l’unione. Se necessario, rimuovere i componenti cloud e ricominciare da capo utilizzando Remove-CvadAcFromSite per il componente e i membri selezionati. Se i risultati sono corretti, continuare.
Se l’unione iniziale è corretta, unire il secondo sito al singolo sito cloud.
Ripetere i passaggi 2 e 3.
Se la seconda unione è corretta, unire il terzo sito al singolo sito cloud.
Ripetere i passaggi 2 e 3.
Rivedere le risorse dal punto di vista dell’utente e verificare che la visualizzazione sia nello stato desiderato.

Rimuovere un componente utilizzando il prefisso del sito

È possibile rimuovere selettivamente i componenti di un singolo sito utilizzando il prefisso sul parametro –IncludeByName del cmdlet Remove-CvadAcFromSite. Nell’esempio seguente, i gruppi di consegna del Delivery Controller West non sono corretti. Per rimuovere i gruppi di consegna solo per il sito West:

Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”

Per rimuovere tutti i componenti West, eseguire i seguenti cmdlet in ordine.

Remove-CvadAcFromSite –GroupPolicies –IncludeByName “Western *”
Remove-CvadAcFromSite –Applications –IncludeByName “Western *”
Remove-CvadAcFromSite – ApplicationGroups –IncludeByName “Western *”
Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”
Remove-CvadAcFromSite –MachineCatalogs –IncludeByName “Western *”
Remove-CvadAcFromSite –HostConnections –IncludeByName “Western *”
Remove-CvadAcFromSite –Tags –IncludeByName “Western *”

Per rimuovere i criteri di gruppo dei componenti East, utilizzare il suffisso:

Remove-CvadAcFromSite –GroupPolicies –IncludeByName “*_east”

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?

Unione di più siti in un unico sito

April 27, 2026

Grazie al contributo di:

C C

April 27, 2026

Grazie al contributo di:

C C

In questo articolo

Regole di prefissazione e suffissazione
Esportare il sito on-premise
Condivisione file diretta
Unire i siti
Rimuovere un componente utilizzando il prefisso del sito

È stato utile?