製品ドキュメント
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
PDFを表示

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

March 18, 2026
寄稿者: 
C

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

Web Studioの使用

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

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

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

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

    注：

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

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

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

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

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

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

イメージ定義とバージョンの管理

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

イメージ定義の編集

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

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

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

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

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

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

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

イメージバージョンの削除

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

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

注：

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

イメージ定義の削除

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

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

注：

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

PowerShellの使用

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

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

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

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

詳細情報

準備済みイメージマシンカタログの管理
March 18, 2026
寄稿者: 
C
March 18, 2026
寄稿者: 
C

この記事の概要

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