Get-SCVirtualMachine
取得虛擬機器物件。
Syntax
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>] Description
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
指定物件的唯一識別碼。
| 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 物件。