準備済みイメージを使用して作成されたカタログを管理する

最終公開日 : Oct 24, 2026
既存のMCSマシンカタログを別の準備済みイメージで更新し、イメージ定義とバージョンを以下の方法で管理できます。
  • スタジオ
  • PowerShell
Related information
イメージ管理

Studioを使用する

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

既存のMCSマシンカタログを別の準備済みイメージで更新するには、次の手順を実行します。
  1. 左ペインでマシンカタログをクリックし、更新するマシンカタログを選択します。右クリックして準備済みイメージの変更を選択します。
  2. イメージページで、準備済みイメージを選択します。必要に応じて、選択した準備済みイメージにメモを追加します。
    注：
    (Azureのみ) ACGが有効になっていないイメージを選択し、後で準備済みイメージをAzure Compute Galleryに配置チェックボックスを選択して、イメージをギャラリーに配置することもできます。
  3. 以前に割り当てられた準備済みイメージにロールバックするには、ウィザードの下部にあるクイックロールバックのために以前のイメージ割り当てを使用をクリックします。
    新しいウィンドウが開き、利用可能なすべての履歴イメージ割り当てのリストが表示されます。リストからイメージを選択すると、イメージページの準備済みイメージツリーで対応するバージョンが自動的に選択されます。
  4. ロールアウト戦略ページで、選択した準備済みイメージでこのカタログを更新するタイミングを選択します。
  5. 概要ページで詳細を確認します。完了をクリックします。
カタログに加えられたイメージ変更の履歴を表示するには、次の手順に従います。
  1. マシンカタログを選択します。
  2. Template PropertiesタブのPrepared imageフィールドで、View Image historyをクリックします。

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

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

イメージ定義を編集する

イメージ定義の名前と説明を編集できます。
イメージ定義を編集するには、次の手順を実行します。
  1. Imagesノードに移動し、イメージ定義を選択して、Edit Image Definitionを選択します。

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

イメージバージョンの説明を編集して、そのイメージバージョンの目的を指定できます。
イメージバージョンを編集するには、次の手順を実行します。
  1. Imagesノードに移動し、イメージバージョンを選択して、Edit Descriptionを選択します。

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

イメージバージョンを削除するには、次の手順を実行します。
  1. 「イメージ」ノードに移動し、イメージバージョンを選択して、「イメージバージョンの削除」を選択します。
「注：」:
マシンカタログで使用されているイメージバージョンは削除できません。

イメージ定義を削除する

イメージ定義を削除するには、次の手順を実行します。
  1. 「イメージ」ノードに移動し、イメージ定義を選択して、「イメージ定義の削除」を選択します。
「注：」:
イメージバージョンが含まれているイメージ定義は削除できません。

PowerShellを使用する

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

Set-ProvSchemeImageコマンドを使用してカタログを更新できます。例：
Set-ProvSchemeImage -ProvisioningSchemeUid <Guid> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess]
[-ImageAssignmentNote <string>]
または、,
Set-ProvSchemeImage -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess]
[-ImageAssignmentNote <string>]
カタログを更新するための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"

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

Get-ProvSchemeImageVersionSpecHistory -ProvisioningSchemeName azurecatalog

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

イメージ定義、イメージバージョン、および準備済みイメージバージョン仕様を削除する前に、以下を考慮してください。
  • イメージ定義にイメージバージョンが含まれている場合、そのイメージ定義は削除できません。
  • イメージバージョンにイメージバージョン仕様が含まれている場合、そのイメージバージョンは削除できません。
  • マスターイメージバージョン仕様が他の準備済みイメージバージョン仕様で使用されている場合、そのマスターイメージバージョン仕様は削除できません。
  • 準備済みイメージバージョン仕様がMCSマシンカタログで使用されている場合、その準備済みイメージバージョン仕様は削除できません。
  • ホスティングユニットが他の準備済みイメージバージョン仕様で使用されている場合、そのホスティングユニットは削除できません。
詳細な手順は次のとおりです。
  1. マシンカタログを削除します。例:
    Remove-ProvScheme -ProvisioningScheneName decouplingCatalog
  2. 共有準備済みイメージバージョン仕様を削除します。例:
    Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <uid> -HostingUnitName AzureWest
  3. 準備済みイメージバージョン仕様を削除します。例:
    $PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

    Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
  4. マスターイメージバージョン仕様を削除します。例:
    $MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"

    Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronousl
    注:
    マスターイメージバージョン仕様は、関連付けられた準備済みイメージバージョン仕様がない場合にのみ削除できます。
  5. イメージバージョンを削除します。例:
    Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1
  6. 指定されたホスティング接続内のイメージ定義の構成を削除します。例:
    Remove-ProvImageDefinitionConnection -ImageDefinitionName xx -HypervisorConnectionName xxx
  7. イメージ定義を削除します。例えば、,
    Remove-ProvImageDefinition -ImageDefinitionName image1
準備されたイメージがホストユニット間で共有されていない場合の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
準備されたイメージがホストユニット間で共有されている場合の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

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

イメージ定義の名前変更と編集、およびイメージバージョンの編集が可能です。
  • Rename-ProvImageDefinitionコマンドを使用してイメージ定義の名前を変更します。例えば、:
    Rename-ProvImageDefinition -ImageDefinitionUid <Guid> -NewImageDefinitionName <string>
    または、,
    Rename-ProvImageDefinition -ImageDefinitionName <string> -NewImageDefinitionName <string>
  • Set-ProvImageDefinitionコマンドを使用してイメージ定義を編集します。例えば、:
    Set-ProvImageDefinition -ImageDefinitionUid <Guid> [-Description <string>]
    または、,
    Set-ProvImageDefinition -ImageDefinitionName <string> [-Description <string>]
  • Set-ProvImageVersionコマンドを使用してイメージバージョンを編集します。例えば、:
    Set-ProvImageVersion -ImageVersionUid <Guid> [-Description <string>]
    または、,
    Set-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int> [-Description <string>]

イメージ定義、イメージバージョン、準備されたイメージバージョンスペック、およびプロビジョニングスキームの詳細を取得する

  • Get-ProvImageDefinitionコマンドを使用してイメージ定義の詳細を取得します。例えば、:
    Get-ProvImageDefinition [-ImageDefinitionName <string>] [-ImageDefinitionUid <Guid>] [-ReturnTotalRecordCount] [-MaxRecordCount <int>] [-Skip <int>] [-SortBy <string>] [-Filter <string>]
  • Get-ProvImageVersionコマンドを使用してイメージバージョンの詳細を取得します。例えば、:
    • イメージ定義内のイメージバージョンを一覧表示するには、,
      Get-ProvImageVersion -ImageDefinitionUid <Guid>
      または、,
      Get-ProvImageVersion -ImageDefinitionName <string>
    • イメージバージョンの詳細を取得するには、,
      Get-ProvImageVersion -ImageVersionUid <Guid>
      または、,
      Get-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int>
  • Get-ProvImageVersionSpecコマンドを使用して、準備されたイメージバージョンの仕様を取得します。例:
    • イメージバージョン内のすべての準備されたイメージバージョンの仕様を一覧表示するには、,
      Get-ProvImageVersionSpec -ImageVersionUid <Guid>
    • 準備されたイメージバージョンの仕様内のマスターイメージバージョンの仕様を一覧表示するには、,
      Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "None"'
    • マスターイメージに関連付けられているイメージバージョン内の準備されたイメージバージョンの仕様を一覧表示するには、,
      Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "MCS" -and SourceImageVersionSpecUid -eq "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"'
    • イメージバージョン内の正常に準備されたイメージバージョンの仕様を取得するには、,
      Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "MCS" -and SourceImageVersionSpecUid -eq "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -and ImageVersionSpecStatus -eq "Complete"'
    • 準備されたイメージバージョンの仕様の詳細を取得するには、,
      Get-ProvImageVersionSpec -ImageVersionSpecUid <Guid>
  • Get-ProvSchemeコマンドを使用して、プロビジョニングスキームの詳細を取得します。例:
    Get-ProvScheme [[-ProvisioningSchemeName] <String>] [-ProvisioningSchemeUid <Guid>] [-ScopeId <Guid>] [-ScopeName <String>] [-ReturnTotalRecordCount] [-MaxRecordCount <Int32>] [-Skip <Int32>] [-SortBy <String>] [-Filter <String>] [-FilterScope <Guid>]
  • Get-ProvSchemeImageVersionSpecHistoryコマンドを使用して、プロビジョニングスキームの準備されたイメージバージョンの仕様履歴を取得します。例:
    Get-ProvSchemeImageVersionSpecHistory [-ProvisioningSchemeName <String>] [-ProvisioningSchemeUid <Guid>] [-ImageVersionSpecUid <Guid>] [-ImageVersionSpecHistoryUid <Guid>] [-ReturnTotalRecordCount] [-MaxRecordCount <Int32>] [-Skip <Int32>] [-SortBy <String>] [-Filter <String>] [-FilterScope <Guid>]

詳細情報

  • イメージ管理