Get-SCVMHost
從 Virtual Machine Manager 資料庫取得虛擬機器主機物件。
Syntax
Get-SCVMHost
[-VMMServer <ServerConnection>]
[[-ComputerName] <String>]
[-ID <Guid>]
[<CommonParameters>]
Get-SCVMHost
-VMHostGroup <HostGroup>
[[-ComputerName] <String>]
[<CommonParameters>]
Get-SCVMHost
-VMHostCluster <HostCluster>
[[-ComputerName] <String>]
[<CommonParameters>]
Description
Get-SCVMHost Cmdlet 會從 Virtual Machine Manager (VMM) 資料庫取得一或多個虛擬機器主機物件。 虛擬機器主機是由 VMM 管理的實體電腦,您可以在其中部署虛擬機器。
VMM 支援下列主機類型:
- Hyper-V 主機
- VMware ESX 主機
- Citrix XenServer 主機
如需 Virtual Machine Manager 中虛擬機器主機的詳細資訊,請輸入 Get-Help Add-VMHost -Detailed
。
範例
範例 1:取得由指定 VMM 伺服器管理的所有主機
PS C:\> Get-SCVMHost -VMMServer "VMMServer01.Contoso.com"
此命令會取得 VMMServer01 所管理之所有主機物件,並向使用者顯示主機屬性。
範例 2:依名稱取得主機名稱
PS C:\> Get-SCVMHost -ComputerName "VMHost01.Contoso.com"
此命令會取得 Contoso.com 網域中名為 VMHost01 的主機物件,並向使用者顯示主機屬性。
範例 3:取得特定主機群組中的所有主機,並向使用者顯示相關資訊
PS C:\> $HostGroup = Get-SCVMHostGroup -Name "HostGroup01" -VMMServer "VMMServer01.Contoso.com"
PS C:\> $HostsInHG = Get-SCVMHost -VMHostGroup $HostGroup
PS C:\> $HostsInHG | Format-Table -Property Name, VMs
第一個命令會從 VMMServer01 取得名為 HostGroup01 的主機群組物件,並將物件儲存在$HostGroup變數中。
第二個命令會取得儲存在$HostGroup之主機群組中的所有主機物件,並將物件儲存在$HostsInHG變數中。
最後一個命令會使用管線運算子,將儲存在 $HostsInHG 中的所有主機物件傳遞至 Format-Table Cmdlet,以顯示資料表中部署在該主機上的每個主機和虛擬機器的名稱。
範例 4:取得特定主機叢集中的所有主機,並向使用者顯示相關資訊
PS C:\> $Cluster = Get-SCVMHostCluster -Name "Cluster01.Contoso.com" -VMMServer "VMMServer01.Contoso.com"
PS C:\> $HostsInCluster = Get-SCVMHost -VMHostCluster $Cluster
PS C:\> $HostsInCluster | Format-Table -Property Name, VirtualizationPlatform
第一個命令會從 VMMServer01 取得名為 Cluster01 的主機叢集物件,並將物件儲存在 $Cluster 變數中。
第二個命令會取得 Cluster01 中的所有主機物件,並將物件儲存在 $HostsInCluster 變數中。
最後一個命令會將儲存在 $HostsInCluster 中的所有主機物件傳遞給 Format-Table Cmdlet,以顯示 Cluster01 中每個主機的名稱和虛擬化平臺。
範例 5:依其 IP 位址取得位於周邊網路上的特定主機
PS C:\> $VMHost = Get-VMHost -ComputerName 10.199.53.5 -VMMServer "VMMServer01.Contoso.com"
PS C:\> $VMHost | Select-Object -Property ComputerName, OperatingSystem
第一個命令會從 VMMServer01 取得位於周邊網路上的主機物件,其 IP 位址為 10.199.53.5,並將物件儲存在$VMHost變數中。
第二個命令會使用管線運算子,將主物件傳遞 $VMHost至 select-Object Cmdlet,以顯示主機的電腦名稱稱和作業系統。
參數
-ComputerName
指定 VMM 可在您的網路中唯一識別的電腦名稱。 有效格式為:
- FQDN
- IPv4 或 IPv6 位址
- NetBIOS 名稱
注意:請參閱特定 Cmdlet 的範例,以判斷該 Cmdlet 如何指定電腦名稱稱。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ID
將數值識別碼指定為特定物件的全域唯一識別碼或 GUID。
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMHostCluster
指定 VMM 主機叢集物件。
Type: | HostCluster |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMHostGroup
指定虛擬機器主機群組物件。
Type: | HostGroup |
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 |
輸出
Host
此 Cmdlet 會傳回 Host 物件。