製品ドキュメント
Citrix Virtual Apps and Desktops
Current Release Service 2511 2507 LTSR 2503 2411 2407 2402 LTSR 2311 2203 LTSR

準備済みイメージのマシンカタログを管理する

May 31, 2026
寄稿者: 
C

既存のMCSマシンカタログを別の準備済みイメージで更新し、イメージ定義とバージョンを管理するには、以下を使用します。

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

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

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

  1. 左側のナビゲーションペインで [マシンカタログ] をクリックし、更新するマシンカタログを選択します。右クリックして [準備済みイメージの変更] を選択します。

  2. [イメージ] ページで、準備済みイメージを選択します。必要に応じて、選択した準備済みイメージにメモを追加します。

    注：

    Azureに適用可能：ACGが有効になっていないイメージを選択し、後で [準備済みイメージをAzure Compute Galleryに配置する] チェックボックスをオンにして、イメージをギャラリーに配置することもできます。

  3. 以前に割り当てられた準備済みイメージにロールバックするには、ウィザードの下部にある [クイックロールバックのために以前のイメージ割り当てを使用する] をクリックします。

    新しいウィンドウが開き、利用可能なすべての履歴イメージ割り当てのリストが表示されます。リストからイメージを選択すると、イメージページの準備済みイメージツリーで対応するバージョンが自動的に選択されます。

  4. [ロールアウト戦略] ページで、選択した準備済みイメージでこのカタログを更新するタイミングを選択します。
  5. [概要] ページで詳細を確認します。[完了] をクリックします。

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

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

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

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

イメージ定義を編集する

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

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

  1. Imagesノードに移動し、イメージ定義を選択して、Edit Image Definitionを選択します。

イメージバージョンを編集する

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

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

  1. Imagesノードに移動し、イメージバージョンを選択して、Edit Descriptionを選択します。

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

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

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

注：

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

イメージ定義の削除

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

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

注：

イメージバージョンが含まれているイメージ定義は削除できません。

パワーシェルを使用する

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

Set-ProvSchemeImageコマンドを使用してカタログを更新できます。例：

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

または、

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

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

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 2 -Filter "PreparationType -eq 'Mcs'"

Set-ProvSchemeImage -ProvisioningSchemeName azurecatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously -ImageAssignmentNote "Update from VST team"
<!--NeedCopy-->

プロビジョニングスキームのイメージ変更履歴を取得する 

Get-ProvSchemeImageVersionSpecHistory -ProvisioningSchemeName azurecatalog
<!--NeedCopy-->

イメージ定義、イメージバージョン、および準備されたイメージバージョン仕様の削除

イメージ定義、イメージバージョン、および準備済みイメージバージョン仕様を削除する前に、以下を考慮してください。

  • イメージ定義にイメージバージョンが含まれている場合、そのイメージ定義は削除できません。
  • イメージバージョンにイメージバージョン仕様が含まれている場合、そのイメージバージョンは削除できません。
  • マスターイメージバージョン仕様が他の準備済みイメージバージョン仕様で使用されている場合、そのマスターイメージバージョン仕様は削除できません。
  • 準備済みイメージバージョン仕様がMCSマシンカタログで使用されている場合、その準備済みイメージバージョン仕様は削除できません。
  • ホスティングユニットが他の準備済みイメージバージョン仕様で使用されている場合、そのホスティングユニットは削除できません。

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

  1. マシンカタログを削除します。例:

    Remove-ProvScheme -ProvisioningScheneName decouplingCatalog
<!--NeedCopy-->

  2. 共有準備済みイメージバージョン仕様を削除します。例:

    Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <uid> -HostingUnitName AzureWest
<!--NeedCopy-->

  3. 準備済みイメージバージョン仕様を削除します。例:

    $PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
<!--NeedCopy-->

  4. マスターイメージバージョン仕様を削除します。例:

    $MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronousl
<!--NeedCopy-->

    注:

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

  5. イメージバージョンを削除します。例:

    Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1
<!--NeedCopy-->

  6. 指定されたホスティング接続でイメージ定義の構成を削除します。例:

    Remove-ProvImageDefinitionConnection -ImageDefinitionName xx -HypervisorConnectionName xxx
<!--NeedCopy-->

  7. イメージ定義を削除します。例：

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

準備されたイメージがホストユニット間で共有されていない場合のPowerShellコマンドの完全なセットの例：

Remove-ProvScheme -ProvisioningSchemeName decouplingCatalog

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

$MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $MasterImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1

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

準備されたイメージがホストユニット間で共有されている場合のPowerShellコマンドの完全なセットの例：

Remove-ProvScheme -ProvisioningSchemeName decouplingCatalog

Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <uid>
-HostingUnitName AzureWest

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

$MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $MasterImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1

Remove-ProvImageDefinitionConnection -ImageDefinitionName xx -HypervisorConnectionName xxx

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

詳細情報

準備済みイメージのマシンカタログを管理する
May 31, 2026
寄稿者: 
C
May 31, 2026
寄稿者: 
C

この記事の概要

サイトに関するフィードバック | Your privacy choices footer linkプライバシーに関する選択肢 | プライバシーと法令 | Cookieの設定 | 同意設定 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.