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

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

プレフィックスとサフィックスの規則

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

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

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

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

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

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

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

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

オンプレミスサイトをエクスポートするまで、マージを開始できません。オンプレミスサイトをエクスポートするには、「」(/ja-jp/citrix-virtual-apps-desktops/2503/manage-deployment/migrate#export-on-premises-configuration)を参照してください。

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

このセクションで説明する方法では、複数のサイトのエクスポートを中央のファイル共有の場所に配置します。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のいずれも使用されないため、クラウドアクセス実行要件はエクスポート要件よりも単純です。
イーストデリバリーコントローラーをクラウドにマージするには:
Merge-CvadAcToSite –SiteName East –SourceFolder \\share.central.net\AutoConfig\SiteEast -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
ウェストデリバリーコントローラーをクラウドにマージするには:
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: ""
中央ファイル共有方法が使用されておらず、個々のDelivery Controllerからインポート、マージ、または追加が行われる場合は、クラウドに移行される各Delivery Controllerで SiteMerging.yml ファイルを作成して複製します。デフォルトの場所は %HOMEPATH%\Documents\Citrix\AutoConfig です。正しいサイトプレフィックスを選択するには、–SiteName パラメーターを指定する必要があります。

サイトをマージする

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コンポーネントを削除するには、次のコマンドレットを順番に実行します。
  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 *”
東コンポーネントのグループポリシーを削除するには、次のサフィックスを使用します。
Remove-CvadAcFromSite –GroupPolicies –IncludeByName “*_east”