イメージ管理 (プレビュー)

はじめに

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

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

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

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

このイメージ管理機能を使用する利点は次のとおりです。

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

注:

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

ユースケース

イメージ管理機能のユースケースには、次のようなものがあります。

• バージョン管理: イメージのバージョンを使用すると、次のことができます。

  • 特定のイメージに対するさまざまなイテレーションや更新を管理できます。
  • さまざまな目的のために、イメージの複数のバージョンを維持できます。

• 論理的なグループ化: 複数のイメージ定義を作成して、次のことができます。

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

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

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

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

準備済みイメージは事前に作成できます。単一の準備済みイメージを使用して、複数のMCSプロビジョニング済みマシンカタログを作成または更新できます。

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

イメージ定義: イメージ定義は、イメージのバージョンの論理的なグループ化です。イメージ定義には、次の情報が含まれます。

• イメージが作成された理由
• どのOS向けか
• イメージの使用に関するその他の情報。

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

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

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

テクニカルプレビューに参加する

テクニカルプレビューへの参加にご興味がある場合は、こちらから連絡先情報をご提供ください。

テスト環境のセットアップを支援し、必要に応じてテクニカルサポートを提供します。

要求事項

• Windowsマスターイメージの場合、VDAイメージバージョン2311以降のみがサポートされます。MCS/IOコンポーネントは明示的に選択してインストールする必要があります。MCS I/O構成の有効化または無効化は、デフォルトでは有効になっていないため、マシンカタログの作成または更新時に決定する必要があります。

制限事項

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

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

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

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

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

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

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

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

• ウェブスタジオ
• パワーシェル コマンド

ウェブスタジオを使用する

以下のトピックを参照してください。

• イメージノードについて理解する
• イメージ定義と初期イメージバージョンを作成する
• イメージバージョンを作成する
• イメージノードからマシンカタログを作成する
• マシンカタログノードからマシンカタログを作成する
• 別の準備済みイメージでマシンカタログを更新する
• イメージ定義とバージョンを管理する

イメージノードについて理解する

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

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

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

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

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

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

1. Web Studioにサインインし、イメージノードを選択します。はじめにページで次へをクリックします。
2. イメージ定義ページで、イメージ定義のOSタイプとセッションタイプを指定します。

3. 「イメージ」ページで、「リソース」と、イメージバージョン作成のテンプレートとして使用するマスターイメージを選択します。「マシンプロファイルを使用」チェックボックスを選択し、マシンプロファイルを選択できます。

   注：

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

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コマンドは次のとおりです。

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