Set-SCVirtualHardDisk

模块:

VirtualMachineManager

更改 VMM 中使用的虚拟硬盘对象的属性。

语法

Set-SCVirtualHardDisk
   [-OperatingSystem <OperatingSystem>]
   [-VirtualizationPlatform <VirtualizationPlatform>]
   [-Tag <System.Collections.Generic.List`1[System.String]>]
   [-ProductKey <String>]
   [-UserRole <UserRole>]
   [-Enabled <Boolean>]
   [-VMMServer <ServerConnection>]
   [-VirtualHardDisk] <VirtualHardDisk>
   [-JobGroup <Guid>]
   [-Name <String>]
   [-SharePath <String>]
   [-Description <String>]
   [-Owner <String>]
   [-FamilyName <String>]
   [-Release <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   [-VirtualHardDisks] <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]>
   -FamilyName <String>
   -Release <String>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

说明

Set-SCVirtualHardDisk cmdlet 更改 Virtual Machine Manager （VMM） 环境中使用的虚拟硬盘对象的一个或多个属性。 VMM 中使用的虚拟硬盘文件是基于 Windows 的 .vhd 文件、基于 Citrix XenServer 的 .vhd 文件或基于 VMware 的 .vmdk 文件。

可以更改的属性包括：

• 描述
• 启用
• 名字
• 操作系统
• 所有者
• SharePath

虚拟硬盘文件可能存储在 VMM 库中，或者它可能附加到虚拟机或模板上的虚拟磁盘驱动器。

若要更改虚拟磁盘驱动器的总线和 LUN 设置，请使用 Set-SCVirtualDiskDrive cmdlet。

示例

示例 1：更改虚拟硬盘的说明

PS C:\> $VHD = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "WindowsServer2008R2BootVHD.vhd"}
PS C:\> Set-SCVirtualHardDisk -VirtualHardDisk $VHD -Description "Latest Windows Server 2008 R2 Boot VHD"

第一个命令从 VMMServer01 上的库中检索名为“WindowsServer2003BootVHD.vhd”的虚拟硬盘对象，然后将该对象存储在$VHD变量中。

第二个命令将存储在$VHD中的虚拟硬盘对象的说明更改为“最新的 Windows Server 2008 R2 启动 VHD”。

示例 2：在库中启用基于 VMware 的虚拟硬盘

PS C:\> $VMDK = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "WindowsServer2008.vmdk"}
PS C:\> Set-SCVirtualHardDisk -VirtualHardDisk $VMDK -Enabled $FALSE

第一个命令获取名为 WindowsServer2008.vmdk 的虚拟硬盘对象，然后将虚拟硬盘对象存储在$VMDK变量中。

第二个命令禁用存储在$VMDK中的虚拟硬盘对象。

示例 3：为具有“未知”所有者的所有虚拟硬盘指定所有者

PS C:\> Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where {$_.Owner -eq "Unknown"} | Set-SCVirtualHardDisk -Owner "Contoso\ReneeLo"

此命令从其所有者为“Unknown”的 VMM 库获取所有虚拟硬盘对象，然后为每个虚拟硬盘对象指定所有者。

参数

-Description

指定虚拟硬盘对象的说明。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Enabled

设置为$True时启用对象，或者在设置为$False时禁用对象。 例如，如果要升级虚拟机模板上的软件，可以禁用 VMM 库中的模板对象，以暂时阻止用户使用该对象。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-FamilyName

指定 VMM 库中物理资源的系列名称。 此值与 Release、Namespace 和 Type 结合使用，在库资源之间建立等效性。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-JobGroup

指定一系列命令的标识符，该命令将在包含相同作业组标识符的最终命令运行之前作为集运行。

类型:	Guid
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-JobVariable

指定在此参数命名的变量中跟踪和存储作业进度。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Name

指定 VMM 对象的名称。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-OperatingSystem

指定虚拟机的操作系统类型。 若要列出 VMM 中所有可用操作系统的名称，请键入 Get-SCOperatingSystem。

类型:	OperatingSystem
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Owner

以有效的域用户帐户的形式指定 VMM 对象的所有者。

• 示例格式：-Owner "Contoso\PattiFuller"
• 示例格式：-Owner "PattiFuller@Contoso"

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ProductKey

指定产品密钥。 产品密钥是标识产品许可证的 25 位数字。 产品密钥可用于注册 VMM 或要安装在虚拟机或主机上的操作系统。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PROTipID

指定触发此操作的性能和资源优化提示（PRO 提示）的 ID。 此参数允许你审核 PRO 提示。

类型:	Guid
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Release

指定描述库资源的发布的字符串。 VMM 会自动为导入库的每个资源创建发布值。 导入资源后，可以自定义字符串。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-RunAsynchronously

指示作业以异步方式运行，以便控件立即返回到命令行界面。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SharePath

指定使用通用命名约定 （UNC） 路径的现有库服务器上的有效库共享的路径。

示例格式： -SharePath "\\LibServer01\LibShare"

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Tag

指定要与对象关联的单词或短语，以便可以搜索具有指定标记集的所有对象。 可以搜索标记的子集，也可以搜索完整的标记集。

类型:	System.Collections.Generic.List`1[System.String]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UserRole

指定用户角色对象。

类型:	UserRole
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-VirtualHardDisk

指定虚拟硬盘对象。

类型:	VirtualHardDisk
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-VirtualHardDisks

指定虚拟硬盘对象的数组。

类型:	System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-VirtualizationPlatform

指定 VMM 管理的虚拟机主机的虚拟化平台。 此参数的可接受值为：

• HyperV
• VMwareESX
• XENServer

类型:	VirtualizationPlatform
接受的值:	Unknown, VirtualServer, HyperV, VMWareVC, VMWareESX, XENServer
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-VMMServer

指定 VMM 服务器对象。

类型:	ServerConnection
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

输出

VirtualHardDisk

此 cmdlet 返回 VirtualHardDisk 对象。

备注

• 需要 VMM 虚拟硬盘对象，可以使用 Get-SCVirtualHardDisk cmdlet 进行检索。

相关链接

• Compress-SCVirtualDiskDrive
• Convert-SCVirtualDiskDrive
• Expand-SCVirtualDiskDrive
• Get-SCVirtualDiskDrive
• Get-SCVirtualHardDisk
• Move-SCVirtualHardDisk
• New-SCVirtualDiskDrive
• Remove-SCVirtualDiskDrive
• Remove-SCVirtualHardDisk
• Set-SCVirtualDiskDrive