管理准备好的映像计算机目录

Last published : Nov 13, 2026
您可以使用以下方法，使用不同的准备好的映像更新现有 MCS 计算机目录，并管理映像定义和版本：
Related information
安装和配置

使用 Web Studio

使用不同的准备好的映像更新计算机目录

要使用不同的准备好的映像更新现有 MCS 计算机目录，请执行以下操作：
  1. 在左侧导航窗格中单击计算机目录，然后选择要更新的计算机目录。右键单击并选择更改准备好的映像。
  2. 在“映像”页面上，选择一个准备好的映像。
    注意：
    适用于 Azure：您还可以选择未启用 ACG 的映像，然后选择将准备好的映像放置在 Azure 计算库中复选框以将映像放置在库中。
  3. 在“推出策略”页面上，选择何时要使用选定的准备好的映像更新此目录。
  4. 在摘要页面上，检查详细信息。单击完成。
您可以查看对目录所做映像更改的历史记录。要查看历史记录，请执行以下操作：
  1. 选择一个计算机目录。
  2. 在准备好的映像字段的模板属性选项卡下，单击查看映像历史记录。

管理映像定义和版本

您可以编辑和删除映像定义和版本，以管理各种已创建映像版本和定义的使用。

编辑映像定义

您可以编辑映像定义的名称和描述。
要编辑映像定义，请执行以下操作：
  1. 转到 Images 节点，选择一个映像定义，然后选择 Edit Image Definition。

编辑映像版本

您可以编辑映像版本的描述，以指定该映像版本的用途。
要编辑映像版本，请执行以下操作：
  1. 转到 Images 节点，选择一个映像版本，然后选择 Edit Description。

删除映像版本

要删除映像版本，请执行以下操作：
  1. 转到 Images 节点，选择一个映像版本，然后选择 Delete Image Version。
注意：
如果映像版本正在被计算机目录使用，则无法将其删除。

删除映像定义

要删除映像定义，请执行以下操作：
  1. 转到 Images 节点，选择一个映像定义，然后选择 Delete Image Definition。
注意：
如果映像定义包含映像版本，则无法将其删除。

使用 PowerShell

使用准备好的映像版本规范更新目录

您可以使用 Set-ProvSchemeImage 命令更新目录。例如，
Set-ProvSchemeImage -ProvisioningSchemeUid <Guid> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess]
或者，
Set-ProvSchemeImage -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess]
更新目录的完整 PowerShell 命令集示例：
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 2 -Filter "PreparationType -eq 'Mcs'"

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

删除映像定义、映像版本和准备好的映像版本规范

在删除映像定义、映像版本和准备好的映像版本规范之前，请考虑以下事项：
  • 如果映像定义包含任何映像版本，则无法删除该映像定义。
  • 如果映像版本包含任何映像版本规范，则无法删除该映像版本。
  • 如果主映像版本规范被任何其他准备好的映像版本规范使用，则无法删除该主映像版本规范。
  • 如果准备好的映像版本规范被任何 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>]

更多信息