Read-SCVirtualMachine

刷新虚拟机的属性,以便 VMM 控制台显示有关虚拟机的更新信息。

语法

Read-SCVirtualMachine
    [-VM] <VM>
    [-Force]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]
Read-SCVirtualMachine
    [-VMHost] <Host>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

说明

Read-SCVirtualMachine cmdlet 更新虚拟机的属性,以便 Virtual Machine Manager (VMM) 控制台显示有关虚拟机的更新信息。 更新的属性包括 名称状态主机所有者CPUAverageServiceOperatingSystem和其他属性。

示例

示例 1:刷新有关特定虚拟机的信息

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Read-SCVirtualMachine -VM $VM

第一个命令获取名为 VM01 的虚拟机对象,然后将该对象存储在$VM变量中。

第二个命令更新存储在$VM中的虚拟机的属性。 此命令成功完成后,会显示有关此虚拟机的当前信息。

示例 2:刷新其名称与指定字符串匹配的主机上的所有虚拟机

PS C:\> $VMs = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | Where-Object { $_.VMHost.Name -Match "VMM" }
PS C:\> $VMs | Read-SCVirtualMachine

第一个命令从部署在名称包含字符串 VMM 的主机上部署的所有虚拟机对象,然后将这些虚拟机对象存储在$VMs数组中。

第二个命令更新存储在$VMs中的每个虚拟机对象的属性。

参数

-Force

强制命令运行而不要求用户确认。

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

-JobVariable

指定在其中跟踪和存储作业进度的变量。

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

-OnBehalfOfUser

指定用户名。 此 cmdlet 代表此参数指定的用户运行。

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

-OnBehalfOfUserRole

指定用户角色。 若要获取用户角色,请使用 Get-SCUserRole cmdlet。 此 cmdlet 代表此参数指定的用户角色运行。

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

-PROTipID

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

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

-RunAsynchronously

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

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

-VM

指定虚拟机对象。

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

-VMHost

指定虚拟机主机对象。 VMM 支持 Hyper-V 主机、VMware ESX 主机和 Citrix XenServer 主机。

有关每种主机类型的详细信息,请参阅 Add-SCVMHost cmdlet。

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

输出

VirtualMachine

备注

  • 此 cmdlet 需要虚拟机对象,可以使用 Get-SCVirtualMachine cmdlet 来检索该对象。