複数のサイトを1つのサイトにマージする
自動構成でのマルチサイトサポートは、複数のオンプレミスサイトを単一のクラウドサイトにマージする方法を提供します。
マルチサイトサポートは、オンプレミスサイトごとにコンポーネント名に一意のプレフィックスとサフィックスを追加し、複数のオンプレミスサイトが単一のクラウドサイトにマージされた後の名前の一意性を保証します。
プレフィックスとサフィックスは、オンプレミスサイトごとに次の各コンポーネントに割り当てることができます。
AdminScopeAdminRoleApplicationAdminApplicationFolderApplicationGroupApplicationUserDeliveryGroupGroupPolicyHostConnectionMachineCatalogStoreFrontタグ
アプリケーションフォルダーは、プレフィックス、サフィックス、およびルート変更をサポートしています。 ルート変更により、アプリケーションの既存のフォルダー構造にトップレベルのフォルダーが追加されます。
プレフィックスとサフィックスの規則
- プレフィックスとサフィックスには、次の特殊文字を含めることができません：
\ , / ; : # . * ? = < > | ( ) " ' { } [ ] - プレフィックスとサフィックスでは、末尾にスペースを入れられますが先頭には入れられません。
- プレフィックスとサフィックスでは、末尾にスペースを入れるために二重引用符で囲む必要があります。
- プレフィックスとサフィックスは、インポート時、マージ時、および追加時に適用されます。 ソースの
.ymlファイルが変更されることはありません。 - プレフィックスとサフィックスの処理では、依存するコンポーネントがある場合にそのコンポーネントの名前に自動的にプレフィックスまたはサフィックスを付けます。 たとえば、マシンカタログ名のプレフィックスが「East」になっている場合、それらのカタログ名を参照するデリバリーグループもプレフィックスが「East」になっています。
- コンポーネント名に既にプレフィックスまたはサフィックスが付いている場合、プレフィックスまたはサフィックスは追加されません。 コンポーネント名に、まったく同じプレフィックスまたはサフィックスを二重に含めることはできません。
- プレフィックスとサフィックスは、個別に使用することも、組み合わせて使用することもできます。
- コンポーネントでプレフィックスまたはサフィックスを使用するかどうかはオプションです。
注
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
<!--NeedCopy-->
West Delivery Controllerからの場合：
mkdir \\share.central.net\AutoConfig\SiteWest
Export-CvadAcToFile –TargetFolder \\share.central.net\AutoConfig\SiteWest`
<!--NeedCopy-->
エクスポートが完了したら、CustomerInfo.ymlファイルとSiteMerging.ymlファイルを作成して\\share.central.net\AutoConfigに配置します。
注
この直接ファイル共有参照方式を使用する場合は、SitePrefixes.ymlを作成するときに
SiteRootFolderパラメーターを使用しないでください。
直接ファイル共有からインポート、マージ、または追加するには、クラウドアクセス操作を実行するマシンを決定する必要があります。 次のオプションがあります。
- ツールが既にインストールされているオンプレミスDelivery Controllerのうちの1つ。
- ファイル共有をホストしているマシン。
- 別のマシン。
自動構成は、クラウドにアクセスするマシンにインストールする必要があります。 オンプレミスの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
<!--NeedCopy-->
West Delivery Controllerをクラウドにマージするには：
Merge-CvadAcToSite –SiteName West –SourceFolder \\share.central.net\AutoConfig\SiteWest -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->
以下は、前の例で使用したサンプルの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
<!--NeedCopy-->
この例では、Eastは完全修飾フォルダー仕様であり、Westは相対フォルダー仕様です。
SiteMerging.ymlファイルを使用して、エクスポートのターゲットをサイト固有のフォルダーにするには：
East Delivery Controllerからの場合：
mkdir \\share.central.net\AutoConfig\SiteEast
Export-CvadAcToFile -SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->
West Delivery Controllerからの場合：
mkdir \\share.central.net\AutoConfig\SiteWest
Export-CvadAcToFile -SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->
エクスポートコマンドレットは、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
<!--NeedCopy-->
West Delivery Controllerをクラウドにマージするには：
Merge-CvadAcToSite –SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->
以下は、前の例で使用したサンプルの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値を使用して、初期サイトをクラウドにマージします。 - Studioで結果を確認します。
- 結果が正しくない場合は、問題とその原因を判別して修正してから、マージを再実行します。 必要に応じて、クラウドコンポーネントを削除し、選択したコンポーネントとメンバーに対して
Remove-CvadAcFromSiteを使用して最初から開始します。 結果が正しい場合は、続行します。 - 最初のマージが正しい場合は、2番目のサイトを単一のクラウドサイトにマージします。
- 手順2と3を繰り返します。
- 2番目のマージが正しい場合は、3番目のサイトを単一のクラウドサイトにマージします。
- 手順2と3を繰り返します。
- ユーザーの観点からリソースを確認し、ビューが望ましい状態になっていることを確認します。
サイトプレフィックスを使用したコンポーネントの削除
Remove-CvadAcFromSiteコマンドレットの–IncludeByNameパラメーターのプレフィックスを使用して、単一サイトコンポーネントを選択して削除できます。 次の例では、West Delivery Controllerデリバリーグループが正しくありません。 Westサイトのみのデリバリーグループを削除するには：
Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”
<!--NeedCopy-->
すべての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 *”
Eastコンポーネントのグループポリシーを削除するには、次のサフィックスを使用します：
Remove-CvadAcFromSite –GroupPolicies –IncludeByName “*_east”
<!--NeedCopy-->