Set-SCVirtualHardDisk
更改 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 文件。
您可以更改的属性包括:
- 说明
- Enabled
- 名称
- 操作系统
- 所有者
- 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
指定虚拟硬盘对象的说明。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Enabled
当设置为$True时启用对象,或者在设置为$False时禁用对象。 例如,如果您要对虚拟机模板上的软件进行升级,则可以禁用 VMM 库中的模板对象以临时阻止用户使用该对象。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FamilyName
指定 VMM 库中物理资源的系列名称。 此值与 Release、Namespace 和 Type 结合使用,在库资源之间建立等效性。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobGroup
在运行最后一个包含相同作业组标识符的命令之前,为作为集合运行的一系列命令指定标识符。
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobVariable
指定跟踪作业进度,并将其存储在此参数命名的变量中。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
指定 VMM 对象的名称。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OperatingSystem
指定虚拟机操作系统的类型。
若要列出 VMM 中所有可用操作系统的名称,请键入 Get-SCOperatingSystem
。
Type: | OperatingSystem |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Owner
以一个有效的域用户帐户形式指定 VMM 对象的所有者。
- 示例格式:
-Owner "Contoso\PattiFuller"
- 示例格式:
-Owner "PattiFuller@Contoso"
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProductKey
指定产品密钥。 产品密钥是一个标识产品许可证的 25 位数字。 产品密钥可用于注册要安装在虚拟机或主机上的 VMM 或操作系统。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
指定触发此操作 (PRO 提示) 的性能和资源优化提示的 ID。 此参数允许审核 PRO 提示。
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Release
指定描述库资源的发布的字符串。 VMM 会自动为导入库的每个资源创建发布值。 导入资源后,可以自定义字符串。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
指示作业异步运行,以便控件立即返回到命令 shell。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SharePath
指定现有库服务器上使用通用命名约定 (UNC) 路径的一个有效库共享路径。
示例格式: -SharePath "\\LibServer01\LibShare"
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tag
指定要与对象关联的单词或短语,以便可以使用指定的标记集搜索所有对象。 可以搜索标记的子集,也可以搜索完整的标记集。
Type: | System.Collections.Generic.List`1[System.String] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserRole
指定一个用户角色对象。
Type: | UserRole |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VirtualHardDisk
指定虚拟硬盘对象。
Type: | VirtualHardDisk |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VirtualHardDisks
指定虚拟硬盘对象的数组。
Type: | System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VirtualizationPlatform
指定 VMM 管理的虚拟主机的虚拟化平台。 此参数的可接受值为:
- HyperV
- VMwareESX
- XENServer
Type: | VirtualizationPlatform |
Accepted values: | Unknown, VirtualServer, HyperV, VMWareVC, VMWareESX, XENServer |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMMServer
指定VMM 服务器对象。
Type: | ServerConnection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
输出
VirtualHardDisk
此 cmdlet 返回 VirtualHardDisk 对象。
备注
- 需要 VMM 虚拟硬盘对象,可以使用 Get-SCVirtualHardDisk cmdlet 进行检索。