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

June 2, 2026

投稿者:

您可以使用以下方法，通过不同的准备好的映像更新现有 MCS 计算机目录，并管理映像定义和版本：

Web 工作室
PowerShell

使用 Web Studio 管理界面

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

要使用不同的准备好的映像更新现有 MCS 计算机目录，请执行以下操作：

在左侧导航窗格中单击计算机目录，然后选择要更新的计算机目录。右键单击并选择更改准备好的映像。
在映像页面上，选择一个准备好的映像。

注意：

适用于 Azure：您还可以选择未启用 ACG 的映像，然后选择将准备好的映像放置在 Azure 计算库中复选框以将映像放置在库中。
在推出策略页面上，选择何时使用选定的准备好的映像更新此目录。
在摘要页面上，检查详细信息。单击完成。

您可以查看对目录所做映像更改的历史记录。要查看历史记录，请执行以下操作：

选择一个计算机目录。
在模板属性选项卡中的准备好的映像字段下，单击查看映像历史记录。

对映像的定义和版本进行管理

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

编辑映像定义

您可以编辑映像定义的名称和描述。

要编辑映像定义，请执行以下操作：

转到映像节点，选择一个映像定义，然后选择编辑映像定义。

编辑映像版本

您可以编辑映像版本的描述，以指定该映像版本的用途。

要编辑映像版本，请执行以下操作：

转到映像节点，选择一个映像版本，然后选择编辑描述。

删除映像版本

要删除映像版本，请执行以下操作：

转到映像节点，选择一个映像版本，然后选择删除映像版本。

注意：

如果映像版本正在被计算机目录使用，则无法删除该映像版本。

删除一个映像定义

要删除映像定义，请执行以下操作：

转到“映像”节点，选择一个映像定义，然后选择“删除映像定义”。

注意：

如果映像定义包含映像版本，则无法删除该映像定义。

使用 PowerShell 命令行工具

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

您可以使用 Set-ProvSchemeImage 命令更新目录。例如，

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

或者，

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

更新目录的完整 Powershell 命令集示例：

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

Set-ProvSchemeImage -ProvisioningSchemeName azurecatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
<!--NeedCopy-->

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

在删除映像定义、映像版本和准备好的映像版本规范之前，请考虑以下事项：

如果映像定义包含任何映像版本，则无法删除该映像定义。
如果映像版本包含任何映像版本规范，则无法删除该映像版本。
如果主映像版本规范被任何其他准备好的映像版本规范使用，则无法删除。
如果准备好的映像版本规范被任何 MCS 计算机目录使用，则无法删除。
如果托管单元被任何其他准备好的映像版本规范使用，则无法删除。

详细步骤如下所示：

删除计算机目录。例如，

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

删除共享的准备好的映像版本规范。例如，

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

删除准备好的映像版本规范。例如，

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

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

删除主映像版本的配置规范。例如，

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

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

注意：

仅当没有关联的准备好的映像版本规范时，才能删除主映像版本规范。

删除映像版本。例如，

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

删除在指定托管连接中与映像定义相关的所有配置信息。例如，

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

删除映像定义。例如，

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