Documentazione dei prodotti

Unione di più siti in un unico sito

May 31, 2026
Grazie al contributo di: 
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à del nome dopo che più siti on-premise sono stati uniti a un singolo 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

  1. I prefissi e i suffissi non possono contenere nessuno dei seguenti caratteri speciali: \ , / ; : # . * ? = < > | ( ) " ' { } [ ]
  2. I prefissi e i suffissi possono contenere spazi finali ma non spazi iniziali.
  3. I prefissi e i suffissi devono essere racchiusi tra virgolette doppie per contenere spazi finali.
  4. 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.
  5. Il processo di prefissazione e suffissazione aggiunge automaticamente prefissi o suffissi ai nomi dei componenti dipendenti, quando applicabile. Ad esempio, se i nomi dei cataloghi di macchine sono prefissati con “East”, anche i gruppi di consegna che li fanno riferimento sono prefissati con “East”.
  6. 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.
  7. I prefissi e i suffissi possono essere usati individualmente o in combinazione.
  8. 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.

Raggruppa i componenti per nome

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

File di mappatura prefisso e suffisso

La prefissazione del sito inizia con il file SiteMerging.yml che contiene la mappatura del prefisso e del suffisso 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.

Esporta 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 quella 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.

Esistono due metodi per farlo:

  • 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 selezionare 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™ Est:

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

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

Dal Delivery Controller Ovest:

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

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

Dopo aver completato le esportazioni, creare i file CustomerInfo.yml e SiteMerging.yml e posizionarli in \\share.central.net\AutoConfig.

Nota:

Non utilizzare il parametro SiteRootFolder durante la creazione di SitePrefixes.yml quando si utilizza questo metodo di riferimento diretto della 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.

Automated Configuration deve essere installato sulla macchina che accede al cloud. Non vengono utilizzati né l’SDK PowerShell locale, né il 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 il Delivery Controller Est al cloud:

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

Per unire il Delivery Controller Ovest 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 SitePrefixes.yml file 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 di file utilizzando SiteMerging.yml

Questo metodo utilizza il membro SiteRootFolder del set di prefissi del sito. Sebbene più complesso del metodo di condivisione file diretto, questo metodo riduce le probabilità di selezionare 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

In questo esempio, Est è una specifica di cartella completa e Ovest è una specifica di cartella relativa.

Per indirizzare l’esportazione a una cartella specifica del sito utilizzando il file SiteMerging.yml:

Dal Delivery Controller Est:

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

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

Dal Controller di consegna Ovest:

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, il SiteRootFolder è completamente qualificato. Viene utilizzato così com’è. Nel caso di West, il SiteRootFolder non è completamente qualificato. Viene combinato con la posizione della cartella CustomerInfo.yml per recuperare una posizione di cartella completamente qualificata per West.

Per unire il Controller di consegna East al cloud:

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

Per unire il Controller di consegna West al cloud:

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

Di seguito è riportato un file SitePrefixes.yml di esempio 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 viene utilizzato un metodo di condivisione file centrale e l’importazione, l’unione o l’aggiunta viene eseguita dai singoli Controller di consegna, creare e replicare il file SiteMerging.yml su ciascun Controller di consegna 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 a un singolo sito cloud:

  1. Unire il sito iniziale al cloud utilizzando il valore SiteName appropriato.
  2. Rivedere i risultati in Studio.
  3. 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.
  4. Se la fusione iniziale è corretta, unire il secondo sito al singolo sito cloud.
  5. Ripetere i passaggi 2 e 3.
  6. Se la seconda fusione è corretta, unire il terzo sito al singolo sito cloud.
  7. Ripetere i passaggi 2 e 3.
  8. 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.

  1. Remove-CvadAcFromSite –GroupPolicies –IncludeByName “Western *”

  2. Remove-CvadAcFromSite –Applications –IncludeByName “Western *”

  3. Remove-CvadAcFromSite – ApplicationGroups –IncludeByName “Western *”

  4. Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”

  5. Remove-CvadAcFromSite –MachineCatalogs –IncludeByName “Western *”

  6. Remove-CvadAcFromSite –HostConnections –IncludeByName “Western *”

  7. Remove-CvadAcFromSite –Tags –IncludeByName “Western *”

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

Remove-CvadAcFromSite –GroupPolicies –IncludeByName “*_east”

Unione di più siti in un unico sito
May 31, 2026
Grazie al contributo di: 
C
May 31, 2026
Grazie al contributo di: 
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.