Citrix Virtual Apps and Desktops

イメージ管理(Technical Preview)

はじめに

MCSカタログの作成または更新プロセスには、次の2つのフェーズがあります:

  • マスタリング:ソースイメージを公開イメージに変換する
  • クローン作成:公開されたイメージから新しいVMが作成される

イメージ管理機能により、MCSはマスタリングフェーズを全体的なプロビジョニングワークフローから分離します。

単一のソースイメージからさまざまなMCSイメージバージョン(準備済みイメージ)を準備し、複数の異なるMCSマシンカタログで使用できます。この実装により、ストレージと時間のコストが大幅に削減され、VMの展開とイメージ更新のプロセスが簡素化されます。

このイメージ管理機能を使用するメリットは次のとおりです:

  • カタログを作成せずに、事前に準備済みイメージを生成します。
  • カタログの作成や更新など、複数のシナリオで準備済みイメージを再利用します。
  • カタログの作成または更新時間を大幅に短縮します。

注:

  • この機能は現在、AzureおよびVMware仮想化環境に適用できます。
  • 準備済みイメージを使用せずにMCSマシンカタログを作成できます。その場合、この機能のメリットを活用することはできません。

使用例

イメージ管理機能のユースケースは次のとおりです:

  • バージョン管理:イメージバージョンを使用すると、次のことが可能になります:

    • 特定のイメージに対するさまざまな反復または更新を管理する。
    • さまざまな目的に合わせてイメージの複数のバージョンを維持する。
  • 論理的なグループ化:複数のイメージ定義を作成して、次のことが可能になります:

    • プロジェクト、部門、アプリケーション、デスクトップの種類などのさまざまな基準に基づいて、イメージバージョンを論理的にグループ化する。
    • 組織内でイメージをより効率的に管理する。

準備済みイメージとは何ですか?

MCSはイメージ管理機能を使用して、マスタリングフェーズをカタログ作成または更新ワークフロー全体から切り離し、プロセスを2つの段階に分割します:

  1. 単一のソースイメージから準備済みイメージを作成します。
  2. 準備済みイメージを使用して、MCSマシンカタログを作成または更新します。

準備済みイメージを事前に作成しておくことができます。1つの準備済みイメージを使用して、複数のMCSでプロビジョニングされたマシンカタログを作成または更新できます。

イメージからWeb Studioを使用する場合に、準備済みイメージが複数のMCSマシン カタログにわたってどのように使用されるかを理解します:

準備済みイメージの概要

イメージ定義:イメージ定義は、イメージのバージョンを論理的にグループ化したものです。イメージ定義には次の情報が保持されます:

  • なぜこのイメージが作られたのか
  • どのOS向けか
  • イメージの使用に関するその他の情報。

カタログはイメージ定義から作成されるのではなく、イメージ定義に基づいて作成されたイメージバージョンから作成されます。

イメージバージョン:イメージバージョンは、イメージ定義のバージョン管理を行います。イメージ定義には複数のイメージバージョンを含めることができます。イメージバージョンを準備済みイメージとして使用して、カタログを作成または更新します。

または、PowerShellコマンドを使用してカタログの作成または更新のためにプロビジョニングスキームを作成する場合は、環境に応じて、マスターイメージバージョン仕様に基づいた準備済みイメージバージョン仕様を作成する必要があります。

Technical Previewへの参加

Technical Previewへの参加に関心がある場合は、こちらに連絡先情報を入力していただくようお願いします。

テスト環境の設定をお手伝いし、必要に応じて技術サポートも提供いたします。

条件

  • Windowsマスターイメージの場合、バージョン2311以降のVDAイメージで、MCS/IOが有効になっているもののみがサポートされています。

制限事項

現在、この機能は以下をサポートしていません:

  • Azureの複数のNIC
  • 永続データディスク機能
  • マルチセッションの休止状態
  • イメージの種類の変更

Web Studioを使用したイメージライフサイクル管理

Web Studioを使用する場合のイメージのライフサイクルは次のとおりです:

  1. 準備済みイメージを作成する:イメージ定義とその初期イメージバージョンを作成します。
  2. 初期イメージバージョンからイメージバージョンを作成します。
  3. イメージバージョンを準備済みイメージとして使用してカタログを作成します。
  4. 別の準備済みイメージでマシンカタログを更新します。
  5. イメージ定義とバージョンの管理:イメージバージョンの名前と説明、およびイメージ定義の説明を編集します。
  6. イメージバージョンを削除します。
  7. イメージ定義を削除します。

または、PowerShellを使用してイメージを管理することもできます。「PowerShellを使用したイメージライフサイクル管理」を参照してください。

準備済みイメージを使用してカタログを作成または更新する

準備済みイメージを作成し、その準備済みイメージを使用して、次の方法でMCSマシンカタログを作成または更新します:

Web Studioの使用

次のトピックを参照してください:

イメージノードについて

イメージノードを使用して、MCSで準備済みのイメージを作成および管理します。メインビューは4つの部分に分かれています:

イメージノードのメインビュー

ラベル 部分 説明
A イメージ定義 以前に作成されたイメージ定義を一覧表示します。
B イメージバージョン 選択したイメージ定義のイメージ バージョンを表示します。
C


詳細


  • [詳細] タブには、マスターイメージ、リソース、ハイパーバイザー、イメージ定義の名前、OSの種類、セッションの種類など、選択したイメージ定義またはバージョンに関する詳細情報が表示されます。
  • [イメージスキーム] タブには、ハード ディスク、マシンサイズ、ライセンスの種類、ディスク暗号化セット、マシンプロファイルなど、イメージの準備に使用されるテンプレートに関する情報が表示されます。
  • [プロビジョニングスキーム] タブには、カタログの作成に使用されたプロビジョニングスキーム名が表示されます。
  • [トラブルシューティング] タブには、選択したイメージバージョンのエラーの状態が表示されます。
D 操作バー [イメージバージョンの作成][説明の編集][イメージバージョンの削除][カタログの作成] など、イメージ定義とバージョンに対して実行できる操作を一覧表示します。

準備済みイメージを使用してマシンカタログを作成する

準備済みイメージを使用してMCSマシンカタログを作成するための主な手順は次のとおりです:

  1. イメージ定義と初期イメージバージョンを作成します。
  2. イメージバージョンを準備済みイメージとして使用してカタログを作成します。

イメージ定義と初期イメージバージョンを作成する

イメージ定義と初期イメージバージョンを作成するには、次の手順を実行します:

  1. Web Studioにサインインし、イメージノードを選択します。[はじめに] ページで [次へ] をクリックします。
  2. [イメージ定義] ページで、イメージ定義の [OSの種類][セッションの種類] を指定します。
  3. [イメージ] ページで、[リソース] と、イメージバージョンを作成するためのテンプレートとして使用するマスターイメージを選択します。[マシンプロファイルを使用する] チェックボックスをオンにして、マシンプロファイルを選択できます。

    注:

    イメージを選択する前に、マスターイメージにVDA 2311以降がインストールされており、VDAにMCSIOドライバーがインストールされていることを確認します。

  4. (Azureのみ)[ストレージとライセンスの種類] ページで、イメージ準備プロセスの一部として使用するストレージとライセンスの種類を選択します。

    注:

    [イメージ] ページでマシンプロファイルを選択すると、プロファイル設定に基づいてマシンプロファイルのライセンスの種類が事前に選択されます。

  5. [マシン仕様] ページ:

    • Azureの場合は、マシンのサイズを選択します。[イメージ] ページでマシンプロファイルを選択した場合、マシンプロファイルのマシンサイズがデフォルトで選択されます。
    • VMwareの場合、マシンプロファイルを選択すると、マシンプロファイルから取得された仮想CPU数が表示されますが、これは変更できません。マシンプロファイルを選択しない場合は、マスターイメージから取得されたメモリサイズのみが表示されます。
  6. [NIC] ページで、準備イメージのNICを選択または追加します。各NICに対して、関連付けられている仮想ネットワークを選択します。

    VMwareの場合、マシンプロファイルを選択しないと、マスターイメージに関連付けられたNICがデフォルトで選択されます。マシンプロファイルを選択した場合、NICはマシンプロファイルから派生し、その数は変更できません。

    注:

    Azureでは複数のNICはサポートされていません。

  7. (Azureのみ)[ディスク設定] ページで、顧客が管理する暗号化キー(CMEK)を選択します。マシンプロファイルにCMEKが存在せず、マスターイメージに存在する場合は、マスターイメージからCMEKが事前に選択されます。
  8. [バージョンの説明] ページで、作成された初期イメージバージョンの説明を入力します。
  9. [概要] ページで、イメージ定義の詳細と作成された初期イメージバージョンを確認します。イメージ定義の名前と説明を入力します。[完了]をクリックします。

イメージバージョンを作成する

イメージバージョンを使用すると、特定のイメージに対するさまざまな反復または更新を管理できます。この機能を使用すると、さまざまな目的に合わせてイメージの複数のバージョンを維持できます。

初期イメージバージョンからイメージバージョンを作成するには、次の手順を実行します:

注:

すべてのイメージバージョンのホスティング ユニットは同じである必要があります。

  1. [イメージ] ノードに移動し、イメージバージョンを選択して、[イメージバージョンの作成] を選択します。
  2. イメージバージョンの構成を初期構成のイメージバージョンと異なるものにする場合は、[イメージバージョンの作成] ダイアログの [イメージ][ストレージとライセンスの種類][マシン仕様][NIC]、および [ディスク設定] ページで設定を構成します。
  3. イメージバージョンの説明を追加します。[完了]をクリックします。

イメージバージョンの作成

イメージノードからマシンカタログを作成する

イメージバージョンを使用してカタログを作成するには、[イメージ] ノードの [カタログの作成] オプションを使用します。

または、[マシンカタログ] ノードでカタログを作成するときにバージョンを選択し、カタログ作成ワークフローの準備済みイメージオプションにリンクすることもできます。「マシンカタログノードからマシンカタログを作成する」を参照してください

[イメージ] ノードからMCSマシンカタログを作成するには、次の手順を実行します:

  1. イメージバージョンを選択し、[カタログの作成] をクリックします。[はじめに] ページで [次へ] をクリックします。
  2. [デスクトップエクスペリエンス] ページで、必要なデスクトップエクスペリエンスを選択します。
  3. [イメージ] ページから [ディスク設定] ページまで、選択したイメージバージョンに基づいて設定が事前に選択されます。
  4. (Azureの場合)[リソースグループ] ページで、新しいリソースグループを作成するか、既存のリソースグループを使用してこのカタログのリソースを配置するかを選択できます。
  5. 次のページで設定を完了します。
  6. [概要] ページで、マシンカタログの詳細を確認します。マシンカタログの名前と説明を入力します。[完了]をクリックします。
  7. 作成されたマシンカタログを表示するには、[マシンカタログ] ノードに移動します。

マシンカタログノードからマシンカタログを作成する

[マシンカタログ] ノードからMCSマシンカタログを作成するには、次の手順を実行します:

  1. 左側のナビゲーションペインで [マシンカタログ] をクリックします。
  2. [マシンカタログの作成] をクリックします。[マシンカタログのセットアップ] ページが表示されます。[はじめに][マシンの種類][マシン管理] の各ページで [次へ] をクリックします。
  3. イメージ ページ:
    1. 提供されたイメージを選択します。
    2. [準備済みイメージ] の下で、イメージ定義のイメージバージョンを選択します。
    3. イメージバージョン名をクリックします。選択したイメージバージョンの詳細を表示するには、下線が引かれたバージョン番号をクリックします。
    4. 選択したイメージバージョンがマシンプロファイルで構成されている場合は、マシンプロファイルを選択します。選択したイメージバージョンがマシンプロファイルで構成されていない場合は、マシンプロファイルの使用を選択することはできません。
  4. 次のページで設定を構成します。
  5. [ディスク設定] ページで、選択した準備済みイメージがディスク暗号化セットを使用している場合、暗号化セットを削除することはできませんが、キーを別の暗号化キーに変更することはできます。
  6. (Azureの場合)[リソースグループ] ページで、新しいリソースグループを作成するか、既存のリソースグループを使用してこのカタログのリソースを配置するかを選択できます。
  7. 次のページで設定を完了します。
  8. [概要] ページで、マシンカタログの詳細を確認します。マシンカタログの名前と説明を入力します。[完了]をクリックします。

別の準備済みイメージでマシンカタログを更新する

既存のMCSマシンカタログを別の準備済みイメージで更新するには、次の手順を実行します:

  1. 左側のナビゲーションペインで [マシンカタログ] をクリックし、更新するマシンカタログを選択します。右クリックして [準備済みイメージの変更] を選択します。
  2. [イメージ] ページで、準備済みイメージを選択します。
  3. [ロールアウト方法] ページで、選択した準備済みイメージを使用してこのカタログを更新するタイミングを選択します。
  4. [概要] ページで詳細を確認します。[完了]をクリックします。

カタログで行われたイメージの変更履歴を確認できます。履歴を表示するには、次の手順を実行します:

  1. マシンカタログを選択してください。
  2. [テンプレートのプロパティ] タブの [準備済みイメージ] フィールドで、[イメージの履歴を表示] をクリックします。

イメージ定義とバージョンを管理する

イメージ定義とバージョンを編集および削除して、作成されたさまざまなイメージ バージョンと定義の使用を管理できます。

イメージ定義を編集する

イメージ定義の名前と説明を編集できます。

イメージ定義を編集するには、次の手順を実行します:

  1. [イメージ] ノードに移動し、イメージ定義を選択して、[イメージ定義の編集] を選択します。

イメージバージョンの編集

イメージバージョンの説明を編集して、そのイメージバージョンの目的を指定できます。

イメージバージョンを編集するには、次の手順を実行します:

  1. [イメージ] ノードに移動し、イメージバージョンを選択して、[イメージバージョンの削除] を選択します。

イメージバージョンを削除する

イメージバージョンを削除するには、次の手順を実行します:

  1. [イメージ] ノードに移動し、イメージバージョンを選択して、[イメージバージョンの削除] を選択します。

注:

マシンカタログで使用されているイメージバージョンは削除できません。

イメージ定義を削除する

イメージ定義を削除するには、次の手順を実行します:

  1. [イメージ] ノードに移動し、イメージ定義を選択して、[イメージ定義の削除] を選択します。

注:

イメージ定義にイメージバージョンが含まれている場合は、そのイメージ定義を削除することはできません。

PowerShellを使用したイメージライフサイクル管理

PowerShellコマンドを使用してプロビジョニングスキームを作成する場合は、環境に応じて、マスターイメージバージョン仕様に基づいて準備済みイメージバージョン仕様を作成する必要があります。

マスターイメージバージョン仕様:マスターイメージバージョン仕様は、イメージバージョンの下に追加または作成された特定のイメージです。ハイパーバイザー内の既存のイメージをマスターイメージバージョン仕様として追加したり、環境の必要に応じてマスターイメージバージョン仕様に基づいて準備済みイメージバージョン仕様を作成したりできます。準備済みイメージバージョン仕様は、複数のプロビジョニングスキームに使用できます。

PowerShellコマンドを使用する場合のイメージのライフサイクルは次のとおりです:

  1. イメージを作成します:

    1. イメージ定義を作成します。
    2. イメージバージョンを作成します。
    3. マスターイメージバージョン仕様を追加します。
    4. 準備済みイメージバージョン仕様を作成します。
  2. 準備済みイメージバージョン仕様を使用してMCSマシンカタログを作成します:

    1. ブローカーカタログを作成します。
    2. IDプールを作成します。
    3. New-ProvSchemeコマンドを使用して、準備済みイメージバージョン仕様のUIDのパラメーターを指定してプロビジョニングスキームを作成します。
    4. ブローカーカタログをプロビジョニングスキームにリンクします。
  3. MCSマシンカタログでVMを作成します。
  4. Set-ProvSchemeコマンドを使用して、プロビジョニングスキームの準備済みイメージバージョン仕様を変更します。
  5. イメージ定義とバージョンの管理:イメージバージョンとイメージ定義を編集します。
  6. MCSマシンカタログの削除:削除の順序は次のとおりです。準備済みイメージバージョン仕様 > マスターイメージバージョン仕様 > イメージバージョン > イメージ定義。イメージバージョン使用の削除前に、準備済みイメージバージョン仕様がどのMCSマシンカタログにも関連付けられていないことを確認してください。

PowerShellの使用

PowerShellコマンドを使用して次の操作を実行できます:

準備済みイメージを作成する

準備済みイメージ バージョン仕様を作成するための詳細なPowerShellコマンドは次のとおりです:

  1. Test-ProvImageDefinitionNameAvailable commandを使用して使用可能なイメージ定義名を確認します。たとえば、

    Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]>
    <!--NeedCopy-->
    
  2. New-ProvImageDefinitionコマンドを使用してイメージ定義を作成します。たとえば、

    New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
    <!--NeedCopy-->
    
  3. New-ProvImageVersionコマンドを使用してイメージバージョンを作成します。たとえば、

    New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"
    <!--NeedCopy-->
    
  4. Add-ProvImageVersionSpecコマンドを使用して、イメージバージョンにマスターイメージバージョン仕様を追加します。たとえば、

    Add-ProvImageVersionSpec -ImageDefinitionName  image1  -ImageVersionNumber  1 -HostingUnitName azure -MasterImagePath "XDHyp:\HostingUnits\azure\image.folder\azureresourcegroup.resourcegroup\win2022-snapshot.snapshot"
    <!--NeedCopy-->
    

    注:

    ホスティングユニットの1つのイメージバージョンに追加できるマスターイメージバージョン仕様は、1つだけです。

  5. New-ProvImageVersionSpecコマンドを使用して、マスターイメージバージョン仕様から準備済みイメージ バージョン仕様を作成します。たとえば、

    New-ProvImageVersionSpec
    -SourceImageVersionSpecUid  c6e7384c-b2f8-46d6-9519-29a2c57ed3cb
    -NetworkMapping @{"0"="XDHyp:\HostingUnits\azure\virtualprivatecloud.folder\azureresourcegroup.resourcegroup\azure-vnet-eastus.virtualprivatecloud\dev.network"
    -ServiceOffering "XDHyp:\HostingUnits\azure\serviceoffering.folder\Standard_B2ms.serviceoffering" -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"></CustomProperties>" -RunAsynchronously
    <!--NeedCopy-->
    

    注:

    1つのホスティングユニットと準備タイプには、準備済みインスタンスを1つだけ含めることができます。

Azureでイメージ定義、イメージバージョン、準備済みイメージバージョン仕様を作成するためのPowershellコマンドの完全なセットの例

$ImageDefintion = New-ProvImageDefinition
-ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
 $ImageVersion = New-ProvImageVersion -ImageDefinitionName $ImageDefintion.ImageDefinitionName -Description "version 1"
$MasterImagePath = "XDHyp:\HostingUnits\azure\image.folder\azureresourcegroup.resourcegroup\win2022-snapshot.snapshot"
$SourceImageVersionSpec = Add-ProvImageVersionSpec -ImageDefinitionName $ImageVersion.ImageDefinitionName -ImageVersionNumber $ImageVersion.ImageVersionNumber -HostingUnitName azure -MasterImagePath $MasterImagePath
$Task = New-ProvImageVersionSpec -SourceImageVersionSpecUid  $SourceImageVersionSpec.ImageVersionSpecUid -NetworkMapping @{"0"="XDHyp:\HostingUnits\azure\virtualprivatecloud.folder\azureresourcegroup.resourcegroup\azure-vnet-eastus.virtualprivatecloud\dev.network"} -ServiceOffering "XDHyp:\HostingUnits\azure\serviceoffering.folder\Standard_B2ms.serviceoffering" -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"></CustomProperties>" -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
<!--NeedCopy-->

VMwareでイメージ定義、イメージバージョン、準備済みイメージバージョン仕様を作成するためのPowershellコマンドの完全なセットの例:

$ImageDefintion = New-ProvImageDefinition -ImageDefinitionName image2 -OsType Windows -VdaSessionSupport SingleSession
$ImageVersion = New-ProvImageVersion -ImageDefinitionName $ImageDefintion.ImageDefinitionName -Description "version 1"
$MasterImagePath = "XDHyp:\HostingUnits\vmware\win10-master.vm\win10-master-snap.snapshot"
$SourceImageVersionSpec = Add-ProvImageVersionSpec -ImageDefinitionName $ImageVersion.ImageDefinitionName -ImageVersionNumber $ImageVersion.ImageVersionNumber -HostingUnitName vmware -MasterImagePath $MasterImagePath
$Task = New-ProvImageVersionSpec -SourceImageVersionSpecUid  $SourceImageVersionSpec.ImageVersionSpecUid -NetworkMapping @{"0"="XDHyp:\HostingUnits\vmware\DSwitch-VM Network.network"} -VMCpuCount 2 -VMMemoryMB 4096 -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
<!--NeedCopy-->

注:

  • イメージ定義内のすべてのイメージバージョン仕様は、同じホスティングユニットに属している必要があります。
  • イメージバージョンには、マスターイメージバージョン仕様を1つと準備済みイメージバージョン仕様を1つだけ含めることができます。
  • すべてのイメージバージョン仕様にマシンプロファイルが存在するか、またはどのイメージバージョン仕様にもマシンプロファイルが存在しないようにする必要があります。
  • イメージバージョン仕様を作成するときにリソースグループを指定することはできません。

準備済みイメージバージョン仕様を使用してカタログを作成する

New-ProvSchemeコマンドを使用して、準備済みイメージバージョン仕様からMCSマシンカタログを作成します。たとえば、

New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-VMCpuCount <int>] [-VMMemoryMB <int>] [-UseWriteBackCache] [-NetworkMapping <Hashtable>] [-CleanOnBoot] [-Scope <string[]>] [-Metadata <Hashtable>] [-ServiceOffering <string>] [-SecurityGroup <string[]>] [-TenancyType <string>] [-MachineProfile <string>] [-CustomProperties <string>] [-ResetAdministratorPasswords] [-UseFullDiskCloneProvisioning] [-RunAsynchronously] [-PurgeJobOnSuccess] [-ProvisioningSchemeType <ProvisioningSchemeType>]
<!--NeedCopy-->

または、

New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitName <string> -IdentityPoolName <string> [-VMCpuCount <int>] [-VMMemoryMB <int>] [-UseWriteBackCache] [-NetworkMapping <Hashtable>] [-CleanOnBoot] [-Scope <string[]>] [-Metadata <Hashtable>] [-ServiceOffering <string>] [-SecurityGroup <string[]>] [-TenancyType <string>] [-MachineProfile <string>] [-CustomProperties <string>] [-ResetAdministratorPasswords] [-UseFullDiskCloneProvisioning] [-RunAsynchronously] [-PurgeJobOnSuccess] [-ProvisioningSchemeType <ProvisioningSchemeType>]
<!--NeedCopy-->

Azureでカタログを作成するためのPowershellコマンドの完全なセットの例:

$Catalog = New-BrokerCatalog  -AllocationType "Random"  -IsRemotePC $False  -MinimumFunctionalLevel "L7_20" -Name "azurecatalog" -PersistUserChanges "Discard" -ProvisioningType "MCS" -Scope @() -SessionSupport "MultiSession"
$IdentityPool = New-AcctIdentityPool  -AllowUnicode  -Domain "azure.local" -IdentityPoolName "azurecatalog" -IdentityType "ActiveDirectory"  -NamingScheme "azure##" -NamingSchemeType "Numeric" -Scope @()
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
$Task = New-ProvScheme -ProvisioningSchemeName azurecatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -HostingUnitName azure -IdentityPoolName azurecatalog -CleanOnBoot -Scope @() -SecurityGroup @() -ServiceOffering "XDHyp:\HostingUnits\azure\serviceoffering.folder\Standard_B2s.serviceoffering" -NetworkMapping @{"0"="XDHyp:\HostingUnits\azure\virtualprivatecloud.folder\azureresourcegroup.resourcegroup\azure-vnet-eastus.virtualprivatecloud\dev.network"} -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"StorageAccountType`" Value=`"StandardSSD_LRS`" /></CustomProperties>" -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
$ProvScheme = Get-ProvScheme -ProvisioningSchemeName azurecatalog
Set-BrokerCatalog -Name $Catalog.Name -ProvisioningSchemeId $ProvScheme.ProvisioningSchemeUid
<!--NeedCopy-->

VMwareでカタログを作成するためのPowershellコマンドの完全なセットの例:

$Catalog = New-BrokerCatalog  -AllocationType "Random"  -IsRemotePC $False  -MinimumFunctionalLevel "L7_20" -Name "vmwarecatalog" -PersistUserChanges "Discard" -ProvisioningType "MCS" -Scope @() -SessionSupport "MultiSession"
$IdentityPool = New-AcctIdentityPool  -AllowUnicode  -Domain "vmware.local" -IdentityPoolName "vmwarecatalog" -IdentityType "ActiveDirectory"  -NamingScheme "vmware##" -NamingSchemeType "Numeric" -Scope @()
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image2 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
$Task = New-ProvScheme -ProvisioningSchemeName vmwarecatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -HostingUnitName vmware -IdentityPoolName vmwarecatalog -CleanOnBoot -Scope @() -SecurityGroup @() -NetworkMapping @{"0"="XDHyp:\HostingUnits\vmware\DSwitch-VM Network.network"} -VMCpuCount 2 -VMMemoryMB 4096 -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
$ProvScheme = Get-ProvScheme -ProvisioningSchemeName vmwarecatalog
Set-BrokerCatalog -Name $Catalog.Name -ProvisioningSchemeId $ProvScheme.ProvisioningSchemeUid
<!--NeedCopy-->

準備済みイメージバージョン仕様を使用してカタログを更新する

Set-ProvSchemeImageコマンドを使用してカタログを更新できます。たとえば、

Set-ProvSchemeImage -ProvisioningSchemeUid <Guid> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess]
<!--NeedCopy-->

または、

Set-ProvSchemeImage -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess]
<!--NeedCopy-->

カタログを更新するためのPowershellコマンドの完全なセットの例:

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 2 -Filter "PreparationType -eq 'Mcs'"
Set-ProvSchemeImage -ProvisioningSchemeName azurecatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
<!--NeedCopy-->

イメージ定義、イメージバージョン、準備済みイメージバージョン仕様を削除する

イメージ定義、イメージバージョン、準備済みイメージバージョン仕様を削除する前に、次の点を考慮してください:

  • イメージ定義にイメージバージョンが含まれている場合、そのイメージ定義は削除できません。
  • イメージバージョン仕様が含まれている場合、イメージバージョンを削除することはできません。
  • マスターイメージバージョン仕様は、他の準備済みイメージバージョン仕様によって使用されている場合は削除できません。
  • 準備済みイメージバージョン仕様は、プロビジョニングスキームによって使用されている場合は削除できません。

詳細な手順は次のとおりです:

  1. 準備済みイメージ バージョン仕様を削除します。たとえば、

    $PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
    Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
    <!--NeedCopy-->
    

    注:

    マスターイメージバージョン仕様は、関連付けられている準備済みイメージバージョン仕様がない場合にのみ削除できます。

  2. マスターイメージバージョン仕様を削除します。たとえば、

    $MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"
    Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
    <!--NeedCopy-->
    
  3. イメージバージョンを削除します。たとえば、

    Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1
    <!--NeedCopy-->
    
  4. イメージ定義を削除します。たとえば、

    Remove-ProvImageDefinition -ImageDefinitionName image1
    <!--NeedCopy-->
    

PowerShellコマンドの完全なセットの例:

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
$Task = Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
$MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"
$Task = Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1
Remove-ProvImageDefinition -ImageDefinitionName image1
<!--NeedCopy-->

イメージ定義とイメージバージョンを管理する

イメージ定義の名前変更や編集、イメージバージョンの編集を実行できます。

  • Rename-ProvImageDefinitionコマンドを使用してイメージ定義の名前を変更します。例:

     Rename-ProvImageDefinition -ImageDefinitionUid <Guid> -NewImageDefinitionName <string>
     <!--NeedCopy-->
    

    または、

     Rename-ProvImageDefinition -ImageDefinitionName <string> -NewImageDefinitionName <string>
     <!--NeedCopy-->
    
  • Set-ProvImageDefinitionコマンドを使用してイメージ定義を編集します。例:

     Set-ProvImageDefinition -ImageDefinitionUid <Guid> [-Description <string>]
     <!--NeedCopy-->
    

    または、

     Set-ProvImageDefinition -ImageDefinitionName <string> [-Description <string>]
     <!--NeedCopy-->
    
  • Set-ProvImageVersionコマンドを使用してイメージバージョンを編集します。例:

     Set-ProvImageVersion -ImageVersionUid <Guid> [-Description <string>]
     <!--NeedCopy-->
    

    または、

     Set-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int> [-Description <string>]
     <!--NeedCopy-->
    

イメージ定義、イメージバージョン、準備済みイメージバージョン仕様、プロビジョニングスキームの詳細を取得する

  • Get-ProvImageDefinitionコマンドを使用してイメージ定義の詳細を取得します。例:

     Get-ProvImageDefinition [-ImageDefinitionName <string>] [-ImageDefinitionUid <Guid>] [-ReturnTotalRecordCount] [-MaxRecordCount <int>] [-Skip <int>] [-SortBy <string>] [-Filter <string>]
     <!--NeedCopy-->
    
  • Get-ProvImageVersionコマンドを使用してイメージバージョンの詳細を取得します。例:

    • イメージ定義でイメージバージョンを一覧表示する場合、

       Get-ProvImageVersion -ImageDefinitionUid <Guid>
       <!--NeedCopy-->
      

      または、

       Get-ProvImageVersion -ImageDefinitionName <string>
       <!--NeedCopy-->
      
    • イメージバージョンの詳細を取得する場合、

       Get-ProvImageVersion -ImageVersionUid <Guid>
       <!--NeedCopy-->
      

      または、

       Get-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int>
       <!--NeedCopy-->
      
  • Get-ProvImageVersionSpecコマンドを使用して、準備済みイメージバージョン仕様を取得します。例:

    • イメージバージョンで準備されたすべてのイメージバージョン仕様を一覧表示する場合、

       Get-ProvImageVersionSpec -ImageVersionUid <Guid>
       <!--NeedCopy-->
      
    • 準備済みイメージバージョン仕様でマスターイメージバージョン仕様を一覧表示する場合、

       Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "None"'
       <!--NeedCopy-->
      
    • マスターイメージに関連付けられたイメージバージョンに準備済みイメージバージョン仕様を一覧表示する場合、

       Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "MCS" -and SourceImageVersionSpecUid -eq "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"'
       <!--NeedCopy-->
      
    • イメージバージョンで準備済みイメージバージョン仕様を正常に取得する場合、

       Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "MCS" -and SourceImageVersionSpecUid -eq "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -and ImageVersionSpecStatus -eq "Complete"'
       <!--NeedCopy-->
      
    • 準備済みイメージバージョン仕様の詳細を取得する場合、

       Get-ProvImageVersionSpec -ImageVersionSpecUid <Guid>
       <!--NeedCopy-->
      
  • Get-ProvSchemeコマンドを使用してプロビジョニング スキームの詳細を取得します。例:

     Get-ProvScheme [[-ProvisioningSchemeName] <String>] [-ProvisioningSchemeUid <Guid>] [-ScopeId <Guid>] [-ScopeName <String>] [-ReturnTotalRecordCount] [-MaxRecordCount <Int32>] [-Skip <Int32>] [-SortBy <String>] [-Filter <String>] [-FilterScope <Guid>]
     <!--NeedCopy-->
    
  • Get-ProvSchemeImageVersionSpecHistoryコマンドを使用して、プロビジョニングスキームの準備済みイメージバージョン仕様の履歴を取得します。例:

     Get-ProvSchemeImageVersionSpecHistory [-ProvisioningSchemeName <String>] [-ProvisioningSchemeUid <Guid>] [-ImageVersionSpecUid <Guid>] [-ImageVersionSpecHistoryUid <Guid>] [-ReturnTotalRecordCount] [-MaxRecordCount <Int32>] [-Skip <Int32>] [-SortBy <String>] [-Filter <String>] [-FilterScope <Guid>]
     <!--NeedCopy-->
    
イメージ管理(Technical Preview)