Verwalten von Maschinenkatalogen mit vorbereiteten Images

Last published : Nov 13, 2026
Sie können einen vorhandenen MCS-Maschinenkatalog mit einem anderen vorbereiteten Image aktualisieren und die Imagereferenzen und -versionen verwalten mit:
Related information
Installieren und konfigurieren

Verwenden von Web Studio

Aktualisieren eines Maschinenkatalogs mit einem anderen vorbereiteten Image

Führen Sie folgende Schritte aus, um einen vorhandenen MCS-Maschinenkatalog mit einem anderen vorbereiteten Image zu aktualisieren:
  1. Klicken Sie im linken Navigationsbereich auf Maschinenkataloge, und wählen Sie einen Maschinenkatalog aus, den Sie aktualisieren möchten. Klicken Sie mit der rechten Maustaste und wählen Sie Vorbereitetes Image ändern.
  2. Wählen Sie auf der Seite Image ein vorbereitetes Image aus.
    Hinweis:
    Gilt für Azure: Sie können auch ein Image auswählen, bei dem ACG nicht aktiviert ist, und später das Kontrollkästchen Vorbereitetes Image in Azure Compute Gallery platzieren aktivieren, um die Images in der Galerie zu platzieren.
  3. Wählen Sie auf der Seite Rollout-Strategie aus, wann Sie diesen Katalog mit dem ausgewählten vorbereiteten Image aktualisieren möchten.
  4. Überprüfen Sie auf der Seite Zusammenfassung die Details. Klicken Sie auf Fertig stellen.
Sie können den Verlauf der an einem Katalog vorgenommenen Imageänderungen anzeigen. Gehen Sie dazu wie folgt vor:
  1. Wählen Sie einen Maschinenkatalog aus.
  2. Klicken Sie auf der Registerkarte Vorlageneigenschaften im Feld Vorbereitetes Image auf Imageverlauf anzeigen.

Verwalten der Imagereferenzen und -versionen

Sie können die Imagereferenzen und -versionen bearbeiten und löschen, um die Verwendung verschiedener erstellter Imageversionen und -referenzen zu verwalten.

Bearbeiten einer Imagereferenz

Sie können den Namen und die Beschreibung einer Image-Definition bearbeiten.
Gehen Sie wie folgt vor, um eine Image-Definition zu bearbeiten:
  1. Gehen Sie zum Knoten Images, wählen Sie eine Image-Definition aus und wählen Sie Image-Definition bearbeiten.

Image-Version bearbeiten

Sie können die Beschreibung einer Image-Version bearbeiten, um den Zweck dieser Image-Version anzugeben.
Gehen Sie wie folgt vor, um eine Image-Version zu bearbeiten:
  1. Gehen Sie zum Knoten Images, wählen Sie eine Image-Version aus und wählen Sie Beschreibung bearbeiten.

Image-Version löschen

Gehen Sie wie folgt vor, um eine Image-Version zu löschen:
  1. Gehen Sie zum Knoten Images, wählen Sie eine Image-Version aus und wählen Sie Image-Version löschen.
Hinweis:
Sie können eine Image-Version nicht löschen, wenn sie von einem Maschinenkatalog verwendet wird.

Image-Definition löschen

Gehen Sie wie folgt vor, um eine Image-Definition zu löschen:
  1. Gehen Sie zum Knoten Images, wählen Sie eine Image-Definition aus und wählen Sie Image-Definition löschen.
Hinweis:
Sie können eine Image-Definition nicht löschen, wenn sie eine Image-Version enthält.

Verwenden von PowerShell

Katalog mithilfe einer vorbereiteten Image-Versionsspezifikation aktualisieren

Sie können einen Katalog mithilfe des Befehls Set-ProvSchemeImage aktualisieren. Zum Beispiel:
Set-ProvSchemeImage -ProvisioningSchemeUid <Guid> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess]
Oder,
Set-ProvSchemeImage -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess]
Beispiel für den vollständigen Satz von PowerShell-Befehlen zum Aktualisieren eines Katalogs:
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 2 -Filter "PreparationType -eq 'Mcs'"

Set-ProvSchemeImage -ProvisioningSchemeName azurecatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

Imagedefinition, Imageversion und vorbereitete Image-Versionsspezifikation löschen

Beachten Sie Folgendes, bevor Sie eine Imagedefinition, Imageversion und vorbereitete Image-Versionsspezifikation löschen:
  • Eine Imagedefinition kann nicht gelöscht werden, wenn sie Imageversionen enthält.
  • Eine Imageversion kann nicht gelöscht werden, wenn sie Image-Versionsspezifikationen enthält.
  • Eine Master-Image-Versionsspezifikation kann nicht gelöscht werden, wenn sie von einer anderen vorbereiteten Image-Versionsspezifikation verwendet wird.
  • Eine vorbereitete Image-Versionsspezifikation kann nicht gelöscht werden, wenn sie von einem MCS-Maschinenkatalog verwendet wird.
  • Eine Hostingeinheit kann nicht gelöscht werden, wenn sie von einer anderen vorbereiteten Image-Versionsspezifikation verwendet wird.
Die detaillierten Schritte sind wie folgt:
  1. Entfernen Sie den Maschinenkatalog. Zum Beispiel:
    Remove-ProvScheme -ProvisioningScheneName decouplingCatalog
  2. Entfernen Sie die freigegebene vorbereitete Image-Versionsspezifikation. Zum Beispiel:
    Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <uid> -HostingUnitName AzureWest
  3. Entfernen Sie eine vorbereitete Image-Versionsspezifikation. Zum Beispiel:
    $PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

    Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
  4. Entfernen Sie die Master-Image-Versionsspezifikation. Zum Beispiel:
    $MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"

    Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronousl
    Hinweis:
    Eine Master-Image-Versionsspezifikation kann nur gelöscht werden, wenn keine zugehörige vorbereitete Image-Versionsspezifikation vorhanden ist.
  5. Eine Image-Version entfernen. Zum Beispiel:
    Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1
  6. Die Konfiguration für die Image-Definition in der angegebenen Hosting-Verbindung entfernen. Zum Beispiel:
    Remove-ProvImageDefinitionConnection -ImageDefinitionName xx -HypervisorConnectionName xxx
  7. Eine Image-Definition entfernen. Zum Beispiel:
    Remove-ProvImageDefinition -ImageDefinitionName image1
Beispiel für den vollständigen Satz von PowerShell-Befehlen, wenn das vorbereitete Image nicht über Hosteinheiten hinweg freigegeben wird:
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
Beispiel für den vollständigen Satz von PowerShell-Befehlen, wenn das vorbereitete Image über Hosteinheiten hinweg freigegeben wird:
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

Image-Definition und Image-Version verwalten

Sie können eine Image-Definition umbenennen und bearbeiten sowie eine Image-Version bearbeiten.
  • Eine Image-Definition mit dem Befehl Rename-ProvImageDefinition umbenennen. Zum Beispiel:
    Rename-ProvImageDefinition -ImageDefinitionUid <Guid> -NewImageDefinitionName <string>
    Oder,
    Rename-ProvImageDefinition -ImageDefinitionName <string> -NewImageDefinitionName <string>
  • Eine Image-Definition mit dem Befehl Set-ProvImageDefinition bearbeiten. Zum Beispiel:
    Set-ProvImageDefinition -ImageDefinitionUid <Guid> [-Description <string>]
    Oder,
    Set-ProvImageDefinition -ImageDefinitionName <string> [-Description <string>]
  • Eine Image-Version mit dem Befehl Set-ProvImageVersion bearbeiten. Zum Beispiel:
    Set-ProvImageVersion -ImageVersionUid <Guid> [-Description <string>]
    Oder,
    Set-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int> [-Description <string>]

Details zu Image-Definition, Image-Version, Spezifikation der vorbereiteten Image-Version und Bereitstellungsschema abrufen

  • Details zur Image-Definition mit dem Befehl Get-ProvImageDefinition abrufen. Zum Beispiel:
    Get-ProvImageDefinition [-ImageDefinitionName <string>] [-ImageDefinitionUid <Guid>] [-ReturnTotalRecordCount] [-MaxRecordCount <int>] [-Skip <int>] [-SortBy <string>] [-Filter <string>]
  • Details zur Image-Version mit dem Befehl Get-ProvImageVersion abrufen. Zum Beispiel:
    • Um Image-Versionen in einer Image-Definition aufzulisten,
      Get-ProvImageVersion -ImageDefinitionUid <Guid>
      Oder,
      Get-ProvImageVersion -ImageDefinitionName <string>
    • Um ein Detail einer Image-Version abzurufen,
      Get-ProvImageVersion -ImageVersionUid <Guid>
      Oder,
      Get-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int>
  • Rufen Sie die Spezifikation der vorbereiteten Image-Version mithilfe des Befehls Get-ProvImageVersionSpec ab. Beispiel:
    • Zum Auflisten aller Spezifikationen der vorbereiteten Image-Versionen in einer Image-Version,
      Get-ProvImageVersionSpec -ImageVersionUid <Guid>
    • Zum Auflisten der Spezifikationen der Master-Image-Version in einer Spezifikation der vorbereiteten Image-Version,
      Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "None"'
    • Zum Auflisten der Spezifikationen der vorbereiteten Image-Versionen in einer Image-Version, die einem Master-Image zugeordnet ist,
      Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "MCS" -and SourceImageVersionSpecUid -eq "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"'
    • Zum Abrufen erfolgreicher Spezifikationen der vorbereiteten Image-Versionen in einer Image-Version,
      Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "MCS" -and SourceImageVersionSpecUid -eq "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -and ImageVersionSpecStatus -eq "Complete"'
    • Zum Abrufen eines Details der Spezifikation der vorbereiteten Image-Version,
      Get-ProvImageVersionSpec -ImageVersionSpecUid <Guid>
  • Rufen Sie Details des Bereitstellungsschemas mithilfe des Befehls Get-ProvScheme ab. Beispiel:
    Get-ProvScheme [[-ProvisioningSchemeName] <String>] [-ProvisioningSchemeUid <Guid>] [-ScopeId <Guid>] [-ScopeName <String>] [-ReturnTotalRecordCount] [-MaxRecordCount <Int32>] [-Skip <Int32>] [-SortBy <String>] [-Filter <String>] [-FilterScope <Guid>]
  • Rufen Sie den Verlauf der Spezifikation der vorbereiteten Image-Version eines Bereitstellungsschemas mithilfe des Befehls Get-ProvSchemeImageVersionSpecHistory ab. Beispiel:
    Get-ProvSchemeImageVersionSpecHistory [-ProvisioningSchemeName <String>] [-ProvisioningSchemeUid <Guid>] [-ImageVersionSpecUid <Guid>] [-ImageVersionSpecHistoryUid <Guid>] [-ReturnTotalRecordCount] [-MaxRecordCount <Int32>] [-Skip <Int32>] [-SortBy <String>] [-Filter <String>] [-FilterScope <Guid>]

Weitere Informationen