複数のサイトを単一のサイトに統合する

最終公開日 : Oct 24, 2026
自動構成のマルチサイトサポートは、複数のオンプレミスサイトを単一のクラウドサイトに統合する方法を提供します。
マルチサイトサポートは、オンプレミスサイトごとにコンポーネント名に一意のプレフィックスとサフィックスを追加し、複数のオンプレミスサイトが単一のクラウドサイトに統合された後の名前の一意性を確保します。
プレフィックスとサフィックスは、オンプレミスサイトごとに次の各コンポーネントに割り当てることができます。
  • AdminScope
  • AdminRole
  • ApplicationAdmin
  • ApplicationFolder
  • ApplicationGroup
  • ApplicationUser
  • DeliveryGroup
  • GroupPolicy
  • HostConnection
  • MachineCatalog
  • StoreFront
  • Tag
アプリケーションフォルダーは、プレフィックス、サフィックス、および再ルートをサポートします。再ルートは、アプリケーションの既存のフォルダー構造に、追加のトップレベルフォルダーを追加します。
Related information
構成をCitrix Cloud™に移行する

プレフィックスとサフィックスのルール

  1. プレフィックスとサフィックスには、次の特殊文字を含めることはできません。\ , / ; : # . * ? = < > | ( ) " ' { } [ ]
  2. プレフィックスとサフィックスには末尾のスペースを含めることができますが、先頭のスペースは含めることはできません。
  3. プレフィックスとサフィックスは、末尾のスペースを含めるために二重引用符で囲む必要があります。
  4. プレフィックスとサフィックスは、インポート、マージ、追加時に適用されます。ソースの .yml ファイルは変更されません。
  5. プレフィックスとサフィックスの処理は、該当する場合、依存するコンポーネント名に自動的にプレフィックスまたはサフィックスを付けます。たとえば、マシンカタログ名に「East」というプレフィックスが付いている場合、それらを参照するデリバリーグループにも「East」というプレフィックスが付けられます。
  6. コンポーネント名がすでにプレフィックスまたはサフィックスで始まっている場合、プレフィックスまたはサフィックスは追加されません。コンポーネント名に、同じプレフィックスまたはサフィックスが二重に含まれることはできません。
  7. プレフィックスとサフィックスは個別に、または組み合わせて使用できます。
  8. コンポーネントへのプレフィックスまたはサフィックスの使用はオプションです。
注:
Studioはコンポーネントをアルファベット順に表示します。

サイト別にコンポーネントをグループ化する

プレフィックスを使用して、単一サイトのコンポーネントを視覚的にグループ化します。各サイトは独自のグループにリストされ、プレフィックスによって異なるサイトグループの順序がアルファベット順に制御されます。

名前でコンポーネントをグループ化

複数のサイトから同じ名前のコンポーネントを視覚的にグループ化するには、サフィックスを使用します。異なるサイトの同じ名前のコンポーネントは、視覚的に交互に表示されます。

プレフィックスとサフィックスのマッピングファイル

サイトのプレフィックス付けは、1つ以上のオンプレミスサイトのサイトプレフィックスとサフィックスのマッピングを含む SiteMerging.yml ファイルから始まります。SiteMerging.yml ファイルは手動で管理することも、複数のオンプレミスサイトの結合コマンドレット セクションに記載されている利用可能なコマンドレットを使用して管理することもできます。

オンプレミスサイトのエクスポート

オンプレミスサイトをエクスポートするまで、結合を開始できません。オンプレミスサイトをエクスポートするには、オンプレミス構成のエクスポート を参照してください。

中央エクスポートターゲットフォルダー

このセクションで説明する方法では、複数のサイトのエクスポートを中央のファイル共有場所に配置します。SiteMerging.yml ファイル、CustomerInfo.yml ファイル、およびすべてのエクスポートファイルは、そのファイル共有場所に存在するため、オンプレミスサイトとは独立して1つの場所からインポートを実行できます。
クラウドアクセス操作は、オンプレミスサイトやActive Directoryを参照しないため、どこからでもクラウドアクセス操作を実行できます。
これを行うには、2つの方法があります。
  • 直接ファイル共有: 直接ファイル共有からインポート、結合、または追加するには、どのマシンからクラウドアクセス操作を実行するかを決定する必要があります。
  • SiteMerging.yml を使用したファイル共有参照: この方法では、サイトのプレフィックスセットの SiteRootFolder メンバーを使用し、エクスポート、インポート、結合、または追加時に誤ったフォルダーをターゲットにする可能性を低減します。
中央ファイル共有方法を使用しない場合は、個々のDelivery Controllerからインポート、結合、または追加を実行します。クラウドに移行される各Delivery Controllerで SiteMerging.yml ファイルを作成し、レプリケートします。デフォルトの場所は %HOMEPATH%\Documents\Citrix\AutoConfig です。正しいサイトプレフィックスを選択するには、–SiteName パラメーターを指定する必要があります。

直接ファイル共有

エクスポート、インポート、結合、および新規/追加操作では、デフォルトフォルダーである %HOMEPATH%\Documents\Citrix\AutoConfig 以外のフォルダーをターゲットまたはソースとするパラメーターが提供されます。以下の例では、管理者がすでにアクセス権を持ち、必要に応じて資格情報を提供している \\share.central.net の中央ファイル共有を使用しています。
エクスポートをサイト固有のフォルダーにターゲット設定するには、–TargetFolder パラメーターを使用します。
イースト デリバリーコントローラー™ から:
mkdir  \\share.central.net\AutoConfig\SiteEast

Export-CvadAcToFile   –TargetFolder   \\share.central.net\AutoConfig\SiteEast
ウェスト デリバリーコントローラー から:
mkdir  \\share.central.net\AutoConfig\SiteWest

Export-CvadAcToFile   –TargetFolder   \\share.central.net\AutoConfig\SiteWest`
エクスポートが完了したら、CustomerInfo.yml および SiteMerging.yml ファイルを作成し、\\share.central.net\AutoConfig に配置します。
注:
この直接ファイル共有参照方法を使用する場合、SitePrefixes.yml を作成するときに SiteRootFolder パラメーターを使用しないでください。
直接ファイル共有からインポート、マージ、または追加するには、どのマシンからクラウドアクセス操作を実行するかを決定する必要があります。オプションは次のとおりです。
  • ツールがすでにインストールされているオンプレミスの Delivery Controller のいずれか。
  • ファイル共有をホストしているマシン。
  • 別のマシン。
クラウドにアクセスするマシンには、Automated Configuration がインストールされている必要があります。オンプレミスの PowerShell SDK、Delivery Controller、Active Directory は使用されないため、クラウドアクセス実行の要件はエクスポートの要件よりも単純です。
East Delivery Controller をクラウドにマージするには:
Merge-CvadAcToSite –SiteName East –SourceFolder  \\share.central.net\AutoConfig\SiteEast -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
West Delivery Controller をクラウドにマージするには:
Merge-CvadAcToSite –SiteName West –SourceFolder  \\share.central.net\AutoConfig\SiteWest -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
以下は、前の例で使用された SitePrefixes.yml ファイルのサンプルです。
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: ""

SiteMerging.yml を使用したファイル共有参照

この方法では、サイトのプレフィックスセットのSiteRootFolderメンバーを使用します。直接ファイル共有方法よりも複雑ですが、この方法を使用すると、エクスポート、インポート、マージ、または追加時に誤ったフォルダーをターゲットにする可能性が低減されます。
まず、SiteMerging.ymlファイルで各サイトのSiteRootFolderを設定します。これは共有場所で行う必要があります。
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
この例では、Eastは完全修飾フォルダー指定であり、Westは相対フォルダー指定です。
SiteMerging.ymlファイルを使用して、エクスポートをサイト固有のフォルダーにターゲット設定するには：
イースト デリバリー コントローラーから:
mkdir  \\share.central.net\AutoConfig\SiteEast

Export-CvadAcToFile   -SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
ウェスト デリバリー コントローラーから:
mkdir  \\share.central.net\AutoConfig\SiteWest

Export-CvadAcToFile   -SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
エクスポートコマンドレットは、CustomerInfo.ymlフォルダーの場所を使用してSiteMerging.ymlファイルを検索します。Eastの場合、SiteRootFolderは完全修飾されています。これはそのまま使用されます。Westの場合、SiteRootFolderは完全修飾されていません。これはCustomerInfo.ymlフォルダーの場所と組み合わされて、Westの完全修飾フォルダーの場所を取得します。
East Delivery Controllerをクラウドにマージするには：
Merge-CvadAcToSite –SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
West Delivery Controllerをクラウドにマージするには：
Merge-CvadAcToSite –SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
以下は、前の例で使用されたSitePrefixes.ymlファイルのサンプルです。
  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: ""

サイトをマージする

Citrix®は、クラウド操作を段階的に実行し、次のクラウド操作を行う前に各結果を完全にレビューすることを推奨しています。たとえば、3つのサイトを単一のクラウドサイトにマージする場合：
  1. 適切なSiteName値を使用して、最初のサイトをクラウドにマージします。
  2. Studioで結果を確認します。
  3. 結果が正しくない場合は、問題とその原因を特定し、修正してからマージを再実行します。必要に応じて、クラウドコンポーネントを削除し、選択したコンポーネントとメンバーにRemove-CvadAcFromSiteを使用して最初からやり直します。結果が正しい場合は、続行します。
  4. 最初のマージが正しければ、2番目のサイトを単一のクラウドサイトにマージします。
  5. 手順2と3を繰り返します。
  6. 2番目のマージが正しければ、3番目のサイトを単一のクラウドサイトにマージします。
  7. 手順2と3を繰り返します。
  8. ユーザーの視点からリソースを確認し、ビューが目的の状態であることを確認します。

サイトプレフィックスを使用してコンポーネントを削除する

Remove-CvadAcFromSite コマンドレットの –IncludeByName パラメーターにプレフィックスを使用することで、単一サイトのコンポーネントを選択的に削除できます。次の例では、West Delivery Controller のデリバリーグループが正しくありません。West サイトのみのデリバリーグループを削除するには:
Remove-CvadAcFromSite   –DeliveryGroups   –IncludeByName “Western *”
すべてのWestコンポーネントを削除するには、次のコマンドレットを順番に実行します。
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 *”
東コンポーネントのグループポリシーを削除するには、次のサフィックスを使用します。
Remove-CvadAcFromSite   –GroupPolicies   –IncludeByName “*_east”