製品ドキュメント
Citrix Virtual Apps and Desktops
Current Release Service 2511 2507 LTSR 2503 2411 2407 2402 LTSR 2311 2203 LTSR

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

May 31, 2026
寄稿者: 
C

自動構成のマルチサイトサポートは、複数のオンプレミスサイトを単一のクラウドサイトに統合する方法を提供します。

マルチサイトサポートは、オンプレミスサイトごとにコンポーネント名に一意のプレフィックスとサフィックスを追加し、複数のオンプレミスサイトが単一のクラウドサイトに統合された後でも名前の一意性を確保します。

プレフィックスとサフィックスは、オンプレミスサイトごとに、次の各コンポーネントに割り当てることができます。

  • 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ファイルは手動で管理することも、Merging multiple on-premises sites cmdletsセクションに記載されている利用可能なコマンドレットを使用して管理することもできます。

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

オンプレミスサイトをエクスポートするまで、マージを開始できません。オンプレミスサイトをエクスポートするには、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のいずれか。
  • ファイル共有をホストしているマシン。
  • 別のマシン。

クラウドにアクセスするマシンに自動構成をインストールする必要があります。オンプレミスのPowerShell SDK、Delivery Controller、Active Directoryは使用されないため、クラウドアクセス実行要件はエクスポート要件よりもシンプルです。

East デリバリーコントローラーをクラウドにマージするには：

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

West デリバリーコントローラーをクラウドにマージするには：

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: ""
<!--NeedCopy-->

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

エクスポートコマンドレットは、SiteMerging.ymlファイルを特定するためにCustomerInfo.ymlフォルダーの場所を使用します。Eastの場合、SiteRootFolderは完全修飾されています。そのまま使用されます。Westの場合、SiteRootFolderは完全修飾されていません。これは、Westの完全修飾フォルダーの場所を取得するために、CustomerInfo.ymlフォルダーの場所と組み合わされます。

イースト デリバリーコントローラーをクラウドにマージするには:

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

ウエスト デリバリーコントローラーをクラウドにマージするには:

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: ""
<!--NeedCopy-->

中央ファイル共有方法が使用されず、個々の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 *”

East コンポーネントのグループポリシーを削除するには、次のサフィックスを使用します。

Remove-CvadAcFromSite –GroupPolicies –IncludeByName “*_east”

複数のサイトを単一サイトに統合する
May 31, 2026
寄稿者: 
C
May 31, 2026
寄稿者: 
C

この記事の概要

サイトに関するフィードバック | Your privacy choices footer linkプライバシーに関する選択肢 | プライバシーと法令 | Cookieの設定 | 同意設定 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.