Get-SCVirtualMachine

获取虚拟机对象。

语法

Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-All]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   -VMHost <Host>
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   -Cloud <Cloud>
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   -Service <Service>
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   -ComputerTier <ComputerTier>
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   -StorageQoSPolicy <StorageQoSPolicy>
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

说明

Get-SCVirtualMachine cmdlet 从 Virtual Machine Manager (VMM) 数据库中获取一个或多个虚拟机对象。 此 cmdlet 获取部署在虚拟机主机上或存储在 VMM 库中的虚拟机。

示例

示例 1:获取所有虚拟机并显示每个虚拟机的相关信息

PS C:\> Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com"

此命令获取 VMMServer01 上的所有虚拟机对象,并显示有关这些虚拟机对象的信息。

示例 2:获取所有虚拟机并显示有关特定属性的信息

PS C:\> Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | Format-List -Property Name, Owner, Description, HostName, OperatingSystem, CPUCount, Memory

此命令获取 VMMServer01 上的所有虚拟机对象,并显示指定属性的值。

示例 3:按名称获取存储在指定库服务器上的虚拟机

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> Get-SCVirtualMachine | Where-Object { $_.Name -Eq "VM02" -And $_.LibraryServer -Eq "LibraryServer01" } | Select-Object Name,LibraryServer,Status

第一个命令连接到 VMMServer01。

第二个命令获取存储在 LibraryServer01 上的名为 VM02 的虚拟机对象,然后显示虚拟机名称、库服务器的名称以及虚拟机的状态。

示例 4:获取指定主机上的所有虚拟机

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> Get-SCVirtualMachine -VMHost "VMHost01.Contoso.com"

第一个命令连接到 VMMServer01。

第二个命令获取部署在 VMHost01 上的所有虚拟机对象,并显示有关这些虚拟机的信息。

参数

-All

指示此 cmdlet 获取与父对象无关的所有从属对象。 例如,该命令 Get-SCVirtualDiskDrive -All 获取所有虚拟磁盘驱动器对象,而不考虑每个虚拟磁盘驱动器对象关联的虚拟机对象或模板对象。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Cloud

指定私有云对象。

Type:Cloud
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerTier

指定计算机层对象。

Type:ComputerTier
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ID

指定对象的唯一 ID。

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

指定 VMM 对象的名称。

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

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

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Service

指定 VMM 服务对象。

Type:Service
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageQoSPolicy

指定此 cmdlet 获取的虚拟机的服务质量 (QoS) 策略。

Type:StorageQoSPolicy
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMHost

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

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

Type:Host
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMMServer

指定VMM 服务器对象。

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

输出

VirtualMachine

此 cmdlet 返回 VirtualMachine 对象。