Citrix Virtual Apps and Desktops

複数のサイトを単一サイトにマージする

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

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

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

  • 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パラメーターを使用します。

East Delivery Controller™から::

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

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

West Delivery Controllerから::

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 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: ""
<!--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 Delivery Controller から:

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

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

West Delivery Controller から:

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

複数のサイトを単一サイトにマージする