映像管理（预览版）
简介
MCS 目录创建或更新过程分为两个阶段：
- 控制：将源映像转换为已发布的映像
- 克隆：根据已发布的映像创建新 VM
借助映像管理功能，MCS 将控制阶段与整个预配工作流程分开。
可以基于单个源映像准备各种 MCS 映像版本（准备好的映像），并在多个不同的 MCS 计算机目录中使用。这种实现显著降低了存储和时间成本，并且简化了 VM 部署和映像更新过程。
使用此映像管理功能的优势如下：
- 无需创建目录即可提前生成准备好的映像。
- 在多个场景中重复使用准备好的映像，例如创建和更新目录。
- 显著缩短目录创建或更新时间。
注意：
- 此功能当前适用于 Azure 和 VMware 虚拟化环境。
- 可以在不使用准备好的映像的情况下创建 MCS 计算机目录。在这种情况下，您无法获得该功能的好处。
用例
映像管理功能的一些用例如下：
-
版本管理：映像版本允许您：
- 管理特定映像的不同迭代或更新。
- 维护映像的多个版本以用于不同的目的。
-
逻辑分组：可以创建多个映像定义以：
- 根据项目、部门或应用程序和桌面类型等各种标准对映像版本进行逻辑分组。
- 在组织内更有效地管理映像。
准备好的映像是什么
借助映像管理功能，MCS 将控制阶段与整个目录创建或更新工作流程分开，并将该流程分为两个阶段：
- 基于单个源映像创建准备好的映像。
- 使用准备好的映像创建或更新 MCS 计算机目录。
可以提前创建准备好的映像。可以使用单个准备好的映像来创建或更新多个 MCS 预配的计算机目录。
了解在从映像中使用 Web Studio 时，如何在多个 MCS 计算机目录中使用准备好的映像：
映像定义：映像定义是映像版本的逻辑分组。映像定义包含与以下内容有关的信息：
- 创建该映像的原因
- 该映像适用的操作系统
- 有关使用该映像的其他信息。
目录不是根据映像定义创建的，而是根据基于映像定义创建的映像版本创建的。
映像版本：映像版本管理映像定义的版本控制。一个映像定义可以有多个映像版本。请使用映像版本作为准备好的映像来创建或更新目录。
或者，如果您想使用 PowerShell 命令创建预配方案来创建或更新目录，则必须根据环境需要基于主映像版本规范创建准备好的映像版本规范。
要求
- 对于 Windows 主映像，仅支持版本为 2311 及更高版本且启用了 MCS/IO 的 VDA 映像。
限制
该功能当前不支持以下功能：
- Azure 中的多个 NIC
- 永久性数据磁盘功能
- 多会话的休眠功能
- 映像类型更改
使用 Web Studio 管理映像生命周期
使用 Web Studio 时，映像的生命周期为：
- 创建准备好的映像：创建映像定义及其初始映像版本。
- 基于初始映像版本创建映像版本。
- 使用映像版本作为准备好的映像来创建目录。
- 使用另一个准备好的映像更新计算机目录。
- 管理映像定义和版本：编辑映像版本的名称和说明以及映像定义的说明。
- 删除映像版本。
- 删除映像定义。
或者，您也可以使用 PowerShell 管理映像。请参阅使用 PowerShell 管理映像生命周期。
使用准备好的映像创建或更新目录
请使用以下方法创建准备好的映像并使用准备好的映像创建或更新 MCS 计算机目录：
使用 Web Studio
请参阅以下主题：
了解“映像”节点
使用映像节点可创建和管理 MCS 准备的映像。它的主要视图分为四个部分：
| 标签 | 部分 | 说明 |
|---|---|---|
| A | 映像定义 | 列出之前创建的映像定义。 |
| B | 映像版本 | 显示所选映像定义的映像版本。 |
| C
|
详细信息
|
|
| D | 操作栏 | 列出您可以对映像定义和版本执行的操作，例如创建映像版本、编辑说明、删除映像版本和创建目录。 |
使用准备好的映像创建计算机目录
使用准备好的映像创建 MCS 计算机目录的关键步骤如下：
- 创建映像定义和初始映像版本。
- 使用映像版本作为准备好的映像来创建目录。
创建映像定义和初始映像版本
要创建映像定义和初始映像版本，请执行以下操作：
- 登录 Web Studio 并选择映像节点。单击简介页面上的下一步。
- 在映像定义页面上，指定映像定义的操作系统类型和会话类型。
-
在映像页面上，选择资源和主映像以用作创建映像版本的模板。可以选中使用计算机配置文件复选框并选择一个计算机配置文件。
注意：
在选择映像之前，请验证主映像是否安装了 VDA 2311 或更高版本，并且在 VDA 上安装了 MCSIO 驱动程序。
-
（仅适用于 Azure）在存储和许可类型页面上，选择要在映像准备过程中使用的存储和许可证类型。
注意：
如果在映像页面上选择计算机配置文件，则会根据配置文件设置预先选择计算机配置文件的许可证类型。
-
在计算机规格页面上：
- 对于 Azure，请选择计算机大小。如果在映像页面上选择计算机配置文件，则默认情况下会选择计算机配置文件的计算机大小。
- 对于 VMware，如果选择计算机配置文件，则可以看到源自计算机配置文件的虚拟 CPU 数量，该数量不可更改。如果不选择计算机配置文件，则只能看到源自主映像的内存大小。
-
在 NIC 页面上，为准备映像选择或添加 NIC。对于每个 NIC，请选择一个关联的虚拟网络。
对于 VMware，如果不选择计算机配置文件，则默认情况下会选择与主映像关联的 NIC。如果选择计算机配置文件，NIC 将源自计算机配置文件，并且数量不可更改。
注意：
Azure 不支持多个 NIC。
- （仅适用于 Azure）在磁盘设置页面上，选择客户管理的加密密钥 (CMEK)。如果计算机配置文件没有 CMEK 但主映像有，它将从主映像中预先选择 CMEK。
- 在版本说明页面上，输入创建的初始映像版本的说明。
- 在摘要页面上，查看映像定义和创建的初始映像版本的详细信息。输入映像定义的名称和说明。单击完成。
创建映像版本
映像版本允许管理特定映像的不同迭代或更新。此功能使您可以维护映像的多个版本以用于不同的目的。
要基于初始映像版本创建映像版本，请执行以下操作：
注意：
所有映像版本的托管单元必须相同。
- 转到映像节点，选择映像版本，然后选择创建映像版本。
- 如果您希望映像版本的配置与配置的初始映像版本不同，请配置创建映像版本对话框的映像、存储和许可证类型、计算机规格、NIC 和磁盘设置页面上的设置。
- 为映像版本添加说明。单击完成。
从“映像”节点创建计算机目录
通过映像节点中的创建目录选项可使用映像版本创建目录。
或者，您可以在计算机目录节点中创建目录时选择版本，链接到目录创建工作流程中的准备好的映像选项。请参阅从“计算机目录”节点创建计算机目录
要从映像节点创建 MCS 计算机目录，请执行以下操作：
- 选择映像版本，然后单击创建目录。单击简介页面上的下一步。
- 在 Desktop Experience（桌面体验）页面上，选择所需的桌面体验。
- 从映像页面到磁盘设置页面，根据所选映像版本预先选择设置。
- （适用于 Azure）在资源组页面上，您可以选择创建新资源组或者使用现有资源组来放置此目录的资源。
- 完成以下页面上的设置。
- 在摘要页面上，查看计算机目录的详细信息。输入计算机目录的名称和说明。单击完成。
- 转到计算机目录节点以查看创建的计算机目录。
从“计算机目录”节点创建计算机目录
要从计算机目录节点创建 MCS 计算机目录，请执行以下操作：
- 在左侧导航窗格中单击 Machine Catalogs（计算机目录）。
- 单击 Create Machine Catalog（创建计算机目录）。此时将出现计算机目录设置页面。在简介、计算机类型和计算机管理页面中单击下一步。
- 在映像页面上：
- 选择准备好的映像。
- 在准备好的映像下，选择映像定义的映像版本。
- 单击映像版本名称。要查看有关所选映像版本的更多详细信息，请单击带有下划线的版本号。
- 如果选定的映像版本配置了计算机配置文件，请选择计算机配置文件。如果选定的映像版本未配置计算机配置文件，则无法选择使用计算机配置文件。
- 在以下页面上配置设置。
- 在磁盘设置页面上，如果选定的准备好的映像使用磁盘加密集，则无法删除该加密集，但您可以将密钥更改为另一个加密密钥。
- （适用于 Azure）在资源组页面上，您可以选择创建新资源组或者使用现有资源组来放置此目录的资源。
- 完成以下页面上的设置。
- 在摘要页面上，查看计算机目录的详细信息。输入计算机目录的名称和说明。单击完成。
使用另一个准备好的映像更新计算机目录
要使用不同的准备好的映像更新现有 MCS 计算机目录，请执行以下操作：
- 单击左侧导航窗格上的计算机目录，然后选择要更新的计算机目录。单击鼠标右键，然后选择 Change Prepared Image（更改准备好的映像）。
- 在映像页面上，选择准备好的映像。
- 在前滚策略页面上，选择要使用选定的准备好的映像更新此目录。
- 在摘要页面上，查看详细信息。单击完成。
您可以查看对目录所做的映像更改的历史记录。要查看历史记录，请执行以下操作：
- 选择计算机目录。
- 在模板属性选项卡下的准备好的映像字段中，单击 View Image history（查看映像历史记录）。
管理映像定义和版本
可以编辑和删除映像定义和版本，以管理创建的各种映像版本和定义的使用。
编辑映像定义
您可以编辑映像定义的名称和说明。
要编辑映像定义，请执行以下操作：
- 转到映像节点，选择映像定义，然后选择编辑映像定义。
编辑映像版本
您可以编辑映像版本的说明以指定该映像版本的用途。
要编辑映像版本，请执行以下操作：
- 转到映像节点，选择映像版本，然后选择编辑说明。
删除映像版本
要删除映像版本，请执行以下操作：
- 转到映像节点，选择映像版本，然后选择删除映像版本。
注意：
如果计算机目录使用某个映像版本，则无法删除该版本。
删除映像定义
要删除映像定义，请执行以下操作：
- 转到映像节点，选择映像定义，然后选择删除映像定义。
注意：
如果映像定义包含某个映像版本，则无法删除该映像定义。
使用 PowerShell 管理映像生命周期
如果要使用 PowerShell 命令创建预配方案，则必须根据环境需要基于主映像版本规范创建准备好的映像版本规范。
Master image version spec（主映像版本规范）：主映像版本规范是在映像版本下添加或创建的特定映像。可以在虚拟机管理程序中添加现有映像作为主映像版本规范，也可以根据环境需要基于主映像版本规范创建准备好的映像版本规范。准备好的映像版本规范可用于多种预配方案。
使用 PowerShell 命令时，映像的生命周期如下：
-
创建映像：
- 创建映像定义。
- 创建映像版本。
- 添加主映像版本规范。
- 创建准备好的映像版本规范。
-
使用准备好的映像版本规范创建 MCS 计算机目录：
- 创建 Broker 目录。
- 创建标识池。
- 使用
New-ProvScheme命令通过准备好的映像版本规范 Uid 的参数创建预配方案。 - 将 Broker 目录与预配方案关联起来。
- 在 MCS 计算机目录中创建 VM。
- 使用
Set-ProvScheme命令更改预配方案的准备好的映像版本规范。 - 管理映像定义和版本：编辑映像版本和映像定义。
- 删除 MCS 计算机目录：删除顺序如下：准备好的映像版本规范 > 主映像版本规范 > 映像版本 > 映像定义。在删除映像版本规范之前，请确保准备好的映像版本规范与任何 MCS 计算机目录均不关联。
使用 PowerShell
可以使用 PowerShell 命令执行以下操作：
创建准备好的映像
用于创建准备好的映像版本规范的详细 PowerShell 命令如下所示：
-
使用
Test-ProvImageDefinitionNameAvailable command检查可用的映像定义名称。例如，Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]> <!--NeedCopy--> -
使用
New-ProvImageDefinition命令创建映像定义。例如，New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession <!--NeedCopy--> -
使用
New-ProvImageVersion命令创建映像版本。例如，New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1" <!--NeedCopy--> -
使用
Add-ProvImageVersionSpec命令向映像版本中添加主映像版本规范。例如，Add-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -HostingUnitName azure -MasterImagePath "XDHyp:\HostingUnits\azure\image.folder\azureresourcegroup.resourcegroup\win2022-snapshot.snapshot" <!--NeedCopy-->注意：
只能向托管单元的一个映像版本中添加一个主映像版本规范。
-
使用
New-ProvImageVersionSpec命令基于主映像版本规范创建准备好的映像版本规范。例如，New-ProvImageVersionSpec -SourceImageVersionSpecUid c6e7384c-b2f8-46d6-9519-29a2c57ed3cb -NetworkMapping @{"0"="XDHyp:\HostingUnits\azure\virtualprivatecloud.folder\azureresourcegroup.resourcegroup\azure-vnet-eastus.virtualprivatecloud\dev.network" -ServiceOffering "XDHyp:\HostingUnits\azure\serviceoffering.folder\Standard_B2ms.serviceoffering" -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"></CustomProperties>" -RunAsynchronously <!--NeedCopy-->注意：
一个托管单元和准备类型只能有一个准备好的实例。
用于在 Azure 中创建映像定义、映像版本和准备好的映像版本规范的完整 Powershell 命令集示例：
$ImageDefintion = New-ProvImageDefinition
-ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
$ImageVersion = New-ProvImageVersion -ImageDefinitionName $ImageDefintion.ImageDefinitionName -Description "version 1"
$MasterImagePath = "XDHyp:\HostingUnits\azure\image.folder\azureresourcegroup.resourcegroup\win2022-snapshot.snapshot"
$SourceImageVersionSpec = Add-ProvImageVersionSpec -ImageDefinitionName $ImageVersion.ImageDefinitionName -ImageVersionNumber $ImageVersion.ImageVersionNumber -HostingUnitName azure -MasterImagePath $MasterImagePath
$Task = New-ProvImageVersionSpec -SourceImageVersionSpecUid $SourceImageVersionSpec.ImageVersionSpecUid -NetworkMapping @{"0"="XDHyp:\HostingUnits\azure\virtualprivatecloud.folder\azureresourcegroup.resourcegroup\azure-vnet-eastus.virtualprivatecloud\dev.network"} -ServiceOffering "XDHyp:\HostingUnits\azure\serviceoffering.folder\Standard_B2ms.serviceoffering" -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"></CustomProperties>" -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
<!--NeedCopy-->
用于在 VMware 中创建映像定义、映像版本和准备好的映像版本规范的完整 Powershell 命令集示例：
$ImageDefintion = New-ProvImageDefinition -ImageDefinitionName image2 -OsType Windows -VdaSessionSupport SingleSession
$ImageVersion = New-ProvImageVersion -ImageDefinitionName $ImageDefintion.ImageDefinitionName -Description "version 1"
$MasterImagePath = "XDHyp:\HostingUnits\vmware\win10-master.vm\win10-master-snap.snapshot"
$SourceImageVersionSpec = Add-ProvImageVersionSpec -ImageDefinitionName $ImageVersion.ImageDefinitionName -ImageVersionNumber $ImageVersion.ImageVersionNumber -HostingUnitName vmware -MasterImagePath $MasterImagePath
$Task = New-ProvImageVersionSpec -SourceImageVersionSpecUid $SourceImageVersionSpec.ImageVersionSpecUid -NetworkMapping @{"0"="XDHyp:\HostingUnits\vmware\DSwitch-VM Network.network"} -VMCpuCount 2 -VMMemoryMB 4096 -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
<!--NeedCopy-->
注意：
- 一个映像定义中的所有映像版本规范必须属于同一个托管单元。
- 一个映像版本只能有一个主映像版本规范和一个准备好的映像版本规范。
- 所有映像版本规范必须具有计算机配置文件，或者所有映像版本规范都不必须具有计算机配置文件。
- 在创建映像版本规范时，您无法指定资源组。
使用准备好的映像版本规范创建目录
使用 New-ProvScheme 命令基于准备的映像版本规范创建 MCS 计算机目录。例如，
New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-VMCpuCount <int>] [-VMMemoryMB <int>] [-UseWriteBackCache] [-NetworkMapping <Hashtable>] [-CleanOnBoot] [-Scope <string[]>] [-Metadata <Hashtable>] [-ServiceOffering <string>] [-SecurityGroup <string[]>] [-TenancyType <string>] [-MachineProfile <string>] [-CustomProperties <string>] [-ResetAdministratorPasswords] [-UseFullDiskCloneProvisioning] [-RunAsynchronously] [-PurgeJobOnSuccess] [-ProvisioningSchemeType <ProvisioningSchemeType>]
<!--NeedCopy-->
或者，
New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitName <string> -IdentityPoolName <string> [-VMCpuCount <int>] [-VMMemoryMB <int>] [-UseWriteBackCache] [-NetworkMapping <Hashtable>] [-CleanOnBoot] [-Scope <string[]>] [-Metadata <Hashtable>] [-ServiceOffering <string>] [-SecurityGroup <string[]>] [-TenancyType <string>] [-MachineProfile <string>] [-CustomProperties <string>] [-ResetAdministratorPasswords] [-UseFullDiskCloneProvisioning] [-RunAsynchronously] [-PurgeJobOnSuccess] [-ProvisioningSchemeType <ProvisioningSchemeType>]
<!--NeedCopy-->
用于在 Azure 中创建目录的完整 Powershell 命令集示例：
$Catalog = New-BrokerCatalog -AllocationType "Random" -IsRemotePC $False -MinimumFunctionalLevel "L7_20" -Name "azurecatalog" -PersistUserChanges "Discard" -ProvisioningType "MCS" -Scope @() -SessionSupport "MultiSession"
$IdentityPool = New-AcctIdentityPool -AllowUnicode -Domain "azure.local" -IdentityPoolName "azurecatalog" -IdentityType "ActiveDirectory" -NamingScheme "azure##" -NamingSchemeType "Numeric" -Scope @()
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
$Task = New-ProvScheme -ProvisioningSchemeName azurecatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -HostingUnitName azure -IdentityPoolName azurecatalog -CleanOnBoot -Scope @() -SecurityGroup @() -ServiceOffering "XDHyp:\HostingUnits\azure\serviceoffering.folder\Standard_B2s.serviceoffering" -NetworkMapping @{"0"="XDHyp:\HostingUnits\azure\virtualprivatecloud.folder\azureresourcegroup.resourcegroup\azure-vnet-eastus.virtualprivatecloud\dev.network"} -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"StorageAccountType`" Value=`"StandardSSD_LRS`" /></CustomProperties>" -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
$ProvScheme = Get-ProvScheme -ProvisioningSchemeName azurecatalog
Set-BrokerCatalog -Name $Catalog.Name -ProvisioningSchemeId $ProvScheme.ProvisioningSchemeUid
<!--NeedCopy-->
用于在 VMware 中创建目录的完整 Powershell 命令集示例：
$Catalog = New-BrokerCatalog -AllocationType "Random" -IsRemotePC $False -MinimumFunctionalLevel "L7_20" -Name "vmwarecatalog" -PersistUserChanges "Discard" -ProvisioningType "MCS" -Scope @() -SessionSupport "MultiSession"
$IdentityPool = New-AcctIdentityPool -AllowUnicode -Domain "vmware.local" -IdentityPoolName "vmwarecatalog" -IdentityType "ActiveDirectory" -NamingScheme "vmware##" -NamingSchemeType "Numeric" -Scope @()
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image2 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
$Task = New-ProvScheme -ProvisioningSchemeName vmwarecatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -HostingUnitName vmware -IdentityPoolName vmwarecatalog -CleanOnBoot -Scope @() -SecurityGroup @() -NetworkMapping @{"0"="XDHyp:\HostingUnits\vmware\DSwitch-VM Network.network"} -VMCpuCount 2 -VMMemoryMB 4096 -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
$ProvScheme = Get-ProvScheme -ProvisioningSchemeName vmwarecatalog
Set-BrokerCatalog -Name $Catalog.Name -ProvisioningSchemeId $ProvScheme.ProvisioningSchemeUid
<!--NeedCopy-->
使用准备好的映像版本规范更新目录
可以使用 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-->
删除映像定义、映像版本和准备好的映像版本规范
在删除映像定义、映像版本和准备好的映像版本规范之前，请注意以下事项：
- 如果映像定义包含任何映像版本，则无法将其删除。
- 如果映像版本包含任何映像版本规范，则无法将其删除。
- 如果某个主映像版本规范被任何其他准备好的映像版本规范使用，则无法将其删除。
- 如果某个准备好的映像版本规范被任何预配方案使用，则无法将其删除。
详细步骤如下所示：
-
删除准备好的映像版本规范。例如，
$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 -RunAsynchronously <!--NeedCopy--> -
删除映像版本。例如，
Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1 <!--NeedCopy--> -
删除映像定义。例如，
Remove-ProvImageDefinition -ImageDefinitionName image1 <!--NeedCopy-->
完整 PowerShell 命令集示例：
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
$Task = Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
$MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"
$Task = Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1
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-->
映像管理（预览版）
已复制!
失败!