製品ドキュメント

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

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ファイルは手動で管理することも、複数のオンプレミスサイトの統合に関するコマンドレットセクションに記載されている利用可能なコマンドレットを使用して管理することもできます。

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

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

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

このセクションで説明する方法では、複数のサイトのエクスポートを中央のファイル共有場所に配置します。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 デリバリーコントローラーをクラウドに統合するには:

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 ファイルを使用して、エクスポートをサイト固有のフォルダーにターゲット設定するには:

East デリバリーコントローラーから:

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 の完全修飾されたフォルダーの場所を取得します。

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

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 *”

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

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.