複数のサイトを単一のサイトに統合する
Automated Configuration のマルチサイトサポートは、複数のオンプレミスサイトを単一のクラウドサイトに統合する方法を提供します。
マルチサイトサポートは、オンプレミスサイトごとにコンポーネント名に一意のプレフィックスとサフィックスを追加し、複数のオンプレミスサイトが単一のクラウドサイトに統合された後でも名前の一意性を確保します。
プレフィックスとサフィックスは、オンプレミスサイトごとに以下の各コンポーネントに割り当てることができます。
AdminScopeAdminRoleApplicationAdminApplicationFolderApplicationGroupApplicationUserDeliveryGroupGroupPolicyHostConnectionMachineCatalogStoreFrontTag
アプリケーションフォルダーは、プレフィックス、サフィックス、および再ルートをサポートします。再ルートにより、アプリケーションの既存のフォルダー構造に最上位のフォルダーが追加されます。
プレフィックスとサフィックスのルール
- プレフィックスとサフィックスには、次の特殊文字を含めることはできません:
\ , / ; : # . * ? = < > | ( ) " ' { } [ ] - プレフィックスとサフィックスには末尾のスペースを含めることができますが、先頭のスペースは含めることができません。
- 末尾のスペースを含めるには、プレフィックスとサフィックスを二重引用符で囲む必要があります。
- プレフィックスとサフィックスは、インポート、マージ、および追加時に適用されます。ソースの.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 パラメーターを使用します。
東のデリバリーコントローラー™から：
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: ""
<!--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
エクスポートコマンドレットは、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つのサイトを単一のクラウドサイトにマージする場合：
- 適切な
SiteName値を使用して、最初のサイトをクラウドにマージします。 - Studioで結果を確認します。
- 結果が正しくない場合は、問題とその原因を特定し、修正してからマージを再実行します。必要に応じて、クラウドコンポーネントを削除し、選択したコンポーネントとメンバーに
Remove-CvadAcFromSiteを使用して最初からやり直します。結果が正しい場合は、続行します。 - 最初のマージが正しければ、2番目のサイトを単一のクラウドサイトにマージします。
- ステップ2と3を繰り返します。
- 2番目のマージが正しければ、3番目のサイトを単一のクラウドサイトにマージします。
- ステップ2と3を繰り返します。
- ユーザーの視点からリソースを確認し、ビューが目的の状態であることを確認します。
サイトプレフィックスを使用してコンポーネントを削除する
Remove-CvadAcFromSite コマンドレットの –IncludeByName パラメーターにプレフィックスを使用することで、単一サイトのコンポーネントを選択的に削除できます。次の例では、West Delivery Controller のデリバリーグループが正しくありません。West サイトのみのデリバリーグループを削除するには:
Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”
すべての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”