Citrix DaaS™

查看 PDF

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

September 12, 2025

投稿者:

C C

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

Studio
PowerShell

使用 Studio

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

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

在左侧窗格中单击计算机目录，然后选择要更新的计算机目录。右键单击并选择更改准备好的映像。
在映像页面上，选择一个准备好的映像。如果需要，为所选的准备好的映像添加备注。

注意：

(仅限 Azure) 您还可以选择未启用 ACG 的映像，然后选中将准备好的映像放置在 Azure 计算库中复选框，以将映像放置在库中。
要回滚到以前分配的准备好的映像，请单击向导底部的使用以前的映像分配进行快速回滚。

此时将打开一个新窗口，其中显示所有可用的历史映像分配列表。当您从列表中选择映像时，映像页面上准备好的映像树中会自动选择相应的版本。
在推出策略页面上，选择何时要使用所选的准备好的映像更新此目录。
在摘要页面上，检查详细信息。单击完成。

要查看对目录所做的映像更改历史记录，请执行以下步骤：

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

管理映像定义和版本

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

编辑映像定义

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

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

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

编辑映像版本

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

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

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

删除映像版本

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

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

注意：

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

删除映像定义

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

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

注意：

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

使用 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 计算机目录使用，则无法将其删除。
如果托管单元正在被任何其他准备好的映像版本规范使用，则无法将其删除。

详细步骤如下：

删除计算机目录。例如，

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