Citrix Virtual Apps and Desktops

Unione di più siti in un unico sito

January 23, 2026

Grazie al contributo di:

Il supporto multisito per la configurazione automatizzata offre un metodo per unire più siti locali in un unico sito cloud.

Il supporto multisito aggiunge prefissi e suffissi univoci ai nomi dei componenti per ogni sito locale, garantendo l’unicità del nome dopo che più siti locali sono stati uniti a un singolo sito cloud.

È possibile assegnare prefissi e suffissi per ciascuno dei seguenti componenti, per ogni sito locale.

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

Le cartelle delle applicazioni supportano l’aggiunta di prefissi, suffissi e il rerooting. Il rerooting aggiunge una cartella di livello superiore extra alla struttura di cartelle esistente di un’applicazione.

Regole per l’aggiunta di prefissi e suffissi

I prefissi e i suffissi non possono contenere nessuno dei seguenti caratteri speciali: \ , / ; : # . * ? = < > | ( ) " ' { } [ ]
I prefissi e i suffissi possono contenere spazi finali, ma non spazi iniziali.
I prefissi e i suffissi devono essere racchiusi tra virgolette doppie per contenere spazi finali.
I prefissi e i suffissi vengono applicati al momento dell’importazione, dell’unione e dell’aggiunta. I file .yml di origine non vengono mai modificati.
Il processo di prefisso e suffisso aggiunge automaticamente prefissi o suffissi ai nomi dei componenti dipendenti, quando applicabile. Ad esempio, se i nomi dei cataloghi di macchine sono preceduti da “East”, anche i gruppi di consegna che li fanno riferimento sono preceduti da “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 prefissi o suffissi doppi identici.
I prefissi e i suffissi possono essere usati 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 i prefissi per raggruppare visivamente i componenti di un singolo sito. Ogni sito è elencato nel proprio gruppo, con i prefissi che controllano alfabeticamente l’ordinamento dei diversi gruppi di siti.

Raggruppare i componenti per nome

Utilizzare i suffissi 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 di prefissi e suffissi

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

Esportare il sito locale

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

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

Le operazioni di accesso al cloud non fanno mai riferimento ai siti locali 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 dalla 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 indirizzare 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 creazione/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 indirizzare l’esportazione a 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`
<!--NeedCopy-->

Dal Delivery Controller West:

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

`Export-CvadAcToFile   –TargetFolder   \\share.central.net\AutoConfig\SiteWest`
<!--NeedCopy-->

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 il file SitePrefixes.yml con questo metodo di riferimento diretto alla condivisione file.

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

Uno dei Delivery Controller locali 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 locale, né i Delivery Controller, né Active Directory, quindi i requisiti di esecuzione per l’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`
<!--NeedCopy-->

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`
<!--NeedCopy-->

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

        East:
          SiteRootFolder: "" # Importante: lasciare vuoto
          AdminScopePrefix: "East_"
          AdminRolePrefix: "East_"
          ApplicationAdminPrefix: "East_"
          ApplicationFolderPrefix: "" # Nota: viene utilizzata una nuova cartella radice padre
          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: "" # Importante: lasciare vuoto
          AdminScopePrefix: "Western "
          AdminRolePrefix: "Western "
          ApplicationAdminPrefix: "Western "
          ApplicationFolderPrefix: "" # Nota: viene utilizzata una nuova cartella radice padre
          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 indirizzare la cartella sbagliata durante l’esportazione, l’importazione, l’unione o l’aggiunta.

Innanzitutto, impostare il 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`
<!--NeedCopy-->

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

Per indirizzare l’esportazione a 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`
<!--NeedCopy-->

Dal Delivery Controller West:

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

`Export-CvadAcToFile   -SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml`
<!--NeedCopy-->

Il cmdlet di esportazione utilizza la posizione della cartella CustomerInfo.yml per individuare il file SiteMerging.yml. Nel caso di East, il SiteRootFolder è completo. Viene utilizzato così com’è. Nel caso di West, il 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`
<!--NeedCopy-->

Per unire il Delivery Controller West al cloud:

`Merge-CvadAcToSite –SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml`
<!--NeedCopy-->

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

          East:
          SiteRootFolder: "\\\\share.central.net\\AutoConfig\\SiteEast"
          AdminScopePrefix: "East_"
          AdminRolePrefix: "East_"
          ApplicationAdminPrefix: "East_"
          ApplicationFolderPrefix: "" # Nota: viene utilizzata una nuova cartella radice padre
          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: "" # Nota: viene utilizzata una nuova cartella radice padre
          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ù passaggi 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 rieseguire 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 *”`
<!--NeedCopy-->

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”`
<!--NeedCopy-->

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

January 23, 2026

Grazie al contributo di:

January 23, 2026

Grazie al contributo di:

In questo articolo

Regole per l’aggiunta di prefissi e suffissi
Esportare il sito locale
Condivisione file diretta
Unire i siti
Rimuovere un componente utilizzando il prefisso del sito

È stato utile?