图像管理（预览版）

概况介绍

MCS 目录创建或更新过程包含两个阶段：

• 制作母版：源映像转换为已发布的映像
• 克隆：从已发布的映像创建新的 VM

借助映像管理功能，MCS 将母版制作阶段与整个预配工作流分离。

您可以从单个源映像准备各种 MCS 映像版本 (准备好的映像)，并在多个不同的 MCS 计算机目录中使用。此实现显著降低了存储和时间成本，并简化了 VM 部署和映像更新过程。

使用此映像管理功能具有以下优势：

• 提前生成准备好的映像，无需创建目录。
• 在多个场景中重复使用准备好的映像，例如创建和更新目录。
• 显著缩短目录创建或更新时间。

注意：

• 此功能目前适用于 Azure 和 VMware 虚拟化环境。
• 您可以在不使用准备好的映像的情况下创建 MCS 计算机目录。在这种情况下，您将无法获得此功能的好处。

使用场景

图像管理功能的一些用例包括以下方面：

• 版本管理：图像版本允许您：

  • 管理特定图像的不同迭代或更新版本。
  • 维护图像的多个版本以用于不同目的。

• 逻辑分组：您可以创建多个图像定义以：

  • 根据项目、部门或应用程序和桌面类型等各种标准对图像版本进行逻辑分组。
  • 在组织内部更高效地管理图像资源。

什么是准备好的图像

借助图像管理功能，MCS 将主映像阶段与整体目录创建或更新工作流分离，并将该过程分解为两个阶段：

1. 从单个源图像创建准备好的图像。
2. 使用准备好的图像创建或更新 MCS 计算机目录。

您可以提前创建准备好的图像。您可以使用单个准备好的图像来创建或更新多个 MCS 预配的计算机目录。

了解当您从图像使用 Web Studio 时，准备好的图像如何在多个 MCS 计算机目录中被使用：

图像定义：图像定义是图像版本的逻辑分组。图像定义包含以下信息：

• 创建映像的原因
• 它适用于哪个操作系统
• 有关使用映像的其他信息。

目录不是从映像定义创建的，而是从基于映像定义创建的映像版本创建的。

映像版本：映像版本管理映像定义的版本控制。一个映像定义可以有多个映像版本。使用映像版本作为准备好的映像来创建或更新目录。

或者，如果您想使用 PowerShell 命令创建预配方案来创建或更新目录，则必须根据您的环境需要，基于主映像版本规范创建准备好的映像版本规范。

参与技术预览计划

如果您有兴趣参与技术预览，请在此处提供您的联系信息。

我们将帮助您设置测试环境，并在需要时提供技术支持。

要求事项

• 对于 Windows 主映像，仅支持 VDA 映像版本 2311 或更高版本。必须明确选择并安装 MCS/IO 组件。启用或禁用 MCS I/O 配置必须在计算机目录创建或更新期间确定，因为它默认未启用。

局限性

目前，此功能不支持以下内容：

• Azure 中的多个网络接口卡
• 持久性数据磁盘功能
• 针对多会话的休眠功能
• 映像类型更改

使用 Web Studio 进行映像生命周期管理

使用 Web Studio 时，映像的生命周期为：

1. 创建准备好的映像：创建映像定义及其初始映像版本。
2. 从初始映像版本创建映像版本。
3. 使用映像版本作为准备好的映像来创建目录。
4. 使用不同的准备好的映像更新计算机目录。
5. 管理映像定义和版本：编辑映像版本的名称和描述，以及映像定义的描述。
6. 删除映像版本。
7. 删除映像定义。

或者，您也可以使用 PowerShell 管理映像。请参阅 使用 PowerShell 进行映像生命周期管理。

使用准备好的映像创建或更新目录

创建准备好的映像，并使用这些准备好的映像通过以下方式创建或更新 MCS 计算机目录：

• Web 工作室
• PowerShell commands

使用 Web Studio 进行操作

请参阅以下主题：

• 了解“映像”节点
• 创建映像定义和初始映像版本
• 创建映像版本
• 从“映像”节点创建计算机目录
• 从“计算机目录”节点创建计算机目录
• 使用不同的准备映像更新计算机目录
• 管理映像定义和版本

了解“映像”节点

使用 “映像” 节点创建和管理 MCS 准备的映像。其主视图分为四个部分：

使用准备好的映像创建计算机目录

使用准备好的映像创建 MCS 计算机目录的关键步骤如下：

1. 创建映像定义以及初始映像版本。
2. 使用映像版本作为准备好的映像来创建目录。

创建映像定义和初始映像版本

要创建映像定义和初始映像版本，请执行以下操作：

1. 登录 Web Studio 并选择映像节点。在简介页面上单击下一步。
2. 在映像定义页面上，为映像定义指定操作系统类型和会话类型。

3. 在“映像”页面上，选择“资源”和一个主映像，用作创建映像版本的模板。您可以选中“使用计算机配置文件”复选框并选择一个计算机配置文件。

   注意：

   在选择映像之前，请验证主映像是否已安装 VDA 2311 或更高版本，并且 VDA 上已安装 MCSIO 驱动程序。

4. （仅适用于 Azure）在“存储和许可证类型”页面上，选择要在映像准备过程中使用的存储和许可证类型。

   注意：

   如果您在“映像”页面上选择计算机配置文件，则会根据配置文件设置预先选择计算机配置文件的许可证类型。

5. 在“计算机规范”页面上：

   • 对于 Azure，请选择计算机大小。如果您在“映像”页面上选择计算机配置文件，则默认选择计算机配置文件的计算机大小。
   • 对于 VMware，如果您选择计算机配置文件，则可以看到从计算机配置文件派生的虚拟 CPU 计数，并且该计数不可更改。如果您不选择计算机配置文件，则只能看到从主映像派生的内存大小。

6. 在“网卡”页面上，为准备映像选择或添加网卡。对于每个网卡，选择一个关联的虚拟网络。

   对于 VMware，如果您不选择计算机配置文件，则默认选择与主映像关联的网卡。如果您选择计算机配置文件，则网卡是从计算机配置文件派生的，并且计数不可更改。

   注意：

   Azure 不支持多个网卡。

7. （仅适用于 Azure）在“磁盘设置”页面上，选择客户管理的加密密钥 (CMEK)。如果计算机配置文件没有 CMEK，但主映像有，则会预先选择主映像中的 CMEK。
8. 在“版本描述”页面上，输入所创建的初始映像版本的描述。
9. 在摘要页面上，检查映像定义和创建的初始映像版本的详细信息。输入映像定义的名称和描述。单击完成。

创建映像版本

映像版本功能旨在支持对特定映像的各种迭代和更新进行有效管理。通过此功能，您可以根据不同的需求和目的，维护映像的多个版本。

要从初始映像版本创建映像版本，请执行以下操作：

注意：

所有映像版本的托管单元必须相同。

1. 转到映像节点，选择一个映像版本，然后选择创建映像版本。
2. 如果您希望映像版本的配置与初始配置的映像版本不同，请在创建映像版本对话框的映像、存储和许可证类型、计算机规范、网卡和磁盘设置页面上配置设置。
3. 添加映像版本的描述。单击完成。

从映像节点创建计算机目录

使用映像节点中的创建目录选项，使用映像版本创建目录。

或者，您可以在计算机目录节点中创建目录时选择版本，链接到目录创建工作流中准备好的映像选项。请参阅从计算机目录节点创建计算机目录

要从映像节点创建 MCS 计算机目录，请执行以下操作：

1. 选择一个映像版本，然后单击创建目录。在简介页面上单击下一步。
2. 在“桌面体验”页面上，选择所需的桌面体验。
3. 从“映像”页面到“磁盘设置”页面，设置会根据所选映像版本预先选择。
4. （对于 Azure）在“资源组”页面上，您可以选择创建新的资源组或使用现有资源组来放置此目录的资源。
5. 完成以下页面上的各项设置。
6. 在“摘要”页面上，检查计算机目录的详细信息。输入计算机目录的名称和描述。单击“完成”。
7. 转到“计算机目录”节点以查看已创建的计算机目录。

从“计算机目录”节点创建计算机目录

要从“计算机目录”节点创建 MCS 计算机目录，请执行以下操作：

1. 在左侧导航窗格中单击“计算机目录”。
2. 单击“创建计算机目录”。此时将显示“计算机目录设置”页面。依次单击“简介”、“计算机类型”和“计算机管理”页面上的“下一步”。
3. 在“映像”页面上：
   1. 选择“准备好的映像”。
   2. 在“准备好的映像”下，选择映像定义的映像版本。
   3. 单击映像版本名称。要查看有关所选映像版本的更多详细信息，请单击带下划线的版本号。
   4. 如果所选映像版本配置了计算机配置文件，请选择一个计算机配置文件。如果所选映像版本未配置计算机配置文件，则无法选择使用计算机配置文件。
4. 对以下页面上的设置进行配置。
5. 在磁盘设置页面上，如果所选的准备好的映像使用磁盘加密集，则无法删除该加密集，但可以将密钥更改为另一个加密密钥。
6. （对于 Azure）在资源组页面上，您可以选择创建新的资源组或使用现有资源组来放置此目录的资源。
7. 请完成以下页面上的设置。
8. 在摘要页面上，检查计算机目录的详细信息。输入计算机目录的名称和描述。单击完成。

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

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

1. 在左侧导航窗格中单击计算机目录，然后选择要更新的计算机目录。右键单击并选择更改准备好的映像。
2. 在映像页面上，选择一个准备好的映像。
3. 在推出策略页面上，选择何时要使用所选的准备好的映像更新此目录。
4. 在摘要页面上，检查详细信息。单击完成。

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

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

管理映像的定义及其版本

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

编辑映像定义

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

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

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

编辑映像版本

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

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

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

删除映像版本

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

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

注意：

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

删除一个映像定义

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

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

注意：

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

使用 PowerShell 管理映像生命周期

如果要使用 PowerShell 命令创建预配方案，则必须根据主映像版本规范创建准备好的映像版本规范，以满足您的环境需求。

主映像版本规范：主映像版本规范是在映像版本下添加或创建的特定映像。您可以将虚拟机管理程序中的现有映像添加为主映像版本规范，或者根据主映像版本规范创建准备好的映像版本规范，以满足您的环境需求。准备好的映像版本规范可用于多个预配方案。

使用 PowerShell 命令时，映像的生命周期为：

1. 创建映像：

   1. 创建映像定义。
   2. 创建映像版本。
   3. 添加主映像版本规范。
   4. 创建准备好的映像版本规范。

2. 使用准备好的映像版本规范创建 MCS 计算机目录：

   1. 创建代理目录。
   2. 创建身份池。
   3. 使用 New-ProvScheme 命令，创建具有准备好的映像版本规范 Uid 参数的预配方案。
   4. 将代理目录与预配方案进行链接。
3. 在 MCS 计算机目录中创建虚拟机。
4. 使用 Set-ProvScheme 命令更改预配方案的准备好的映像版本规范。
5. 管理映像定义和版本：对映像版本和映像定义进行编辑。
6. 删除 MCS 计算机目录：删除顺序为：准备好的映像版本规范 > 主映像版本规范 > 映像版本 > 映像定义。在删除映像版本规范之前，请确保准备好的映像版本规范未与任何 MCS 计算机目录关联。

Use PowerShell

您可以使用 PowerShell 命令执行以下操作：

• 创建准备好的映像

• 使用准备好的映像版本规范创建目录

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

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

• 管理映像定义和映像版本

• 获取映像定义、映像版本、准备好的映像版本规范和预配方案详细信息

创建准备好的映像

创建准备好的映像版本规范的详细 PowerShell 命令如下：

1. 使用 Test-ProvImageDefinitionNameAvailable command 检查可用的映像定义名称。例如，

   Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]>
   <!--NeedCopy-->
   

2. 使用 New-ProvImageDefinition 命令创建映像定义。例如，

   New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
   <!--NeedCopy-->
   

3. 使用 New-ProvImageVersion 命令创建映像版本。例如，

   New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"
   <!--NeedCopy-->
   

4. 使用 Add-ProvImageVersionSpec 命令将主映像版本规范添加到映像版本。例如，

   Add-ProvImageVersionSpec -ImageDefinitionName  image1  -ImageVersionNumber  1 -HostingUnitName azure -MasterImagePath "XDHyp:\HostingUnits\azure\image.folder\azureresourcegroup.resourcegroup\win2022-snapshot.snapshot"
   <!--NeedCopy-->
   

   注意：

   对于一个托管单元，您只能向一个映像版本添加一个主映像版本规范。

5. 使用 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-->

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

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

• 如果映像定义包含任何映像版本，则无法删除该映像定义。
• 如果映像版本包含任何映像版本规范，则无法删除该映像版本。
• 如果主映像版本规范被任何其他准备好的映像版本规范使用，则无法删除该主映像版本规范。
• 如果准备好的映像版本规范被任何预配方案使用，则无法删除该准备好的映像版本规范。

详细的步骤如下所示：

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

   $PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
   Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
   <!--NeedCopy-->
   

   注意：

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

2. 删除主映像的版本规范。例如，

   $MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"
   Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
   <!--NeedCopy-->
   

3. 删除映像版本。例如，

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

4. 删除映像定义。例如，

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