Get-SCVMHost
バーチャル マシン ホスト オブジェクトを Virtual Machine Manager データベースから取得します。
構文
Get-SCVMHost
[-VMMServer <ServerConnection>]
[[-ComputerName] <String>]
[-ID <Guid>]
[<CommonParameters>]
Get-SCVMHost
-VMHostGroup <HostGroup>
[[-ComputerName] <String>]
[<CommonParameters>]
Get-SCVMHost
-VMHostCluster <HostCluster>
[[-ComputerName] <String>]
[<CommonParameters>]
説明
Get-SCVMHost コマンドレットは、Virtual Machine Manager (VMM) データベースから 1 つ以上の仮想マシン ホスト オブジェクトを取得します。 仮想マシン ホストは、仮想マシンを展開できる 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 変数に格納します。
2 番目のコマンドは、$HostGroupに格納されているホスト グループ内のすべてのホスト オブジェクトを取得し、$HostsInHG変数にオブジェクトを格納します。
最後のコマンドでは、パイプライン演算子を使用して、$HostsInHGに格納されているすべてのホスト オブジェクトを Format-Table コマンドレットに渡します。このコマンドレットでは、各ホストの名前と、そのホストにデプロイされた仮想マシンがテーブルに表示されます。
例 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 変数に格納します。
2 番目のコマンドは、Cluster01 内のすべてのホスト オブジェクトを取得し、$HostsInCluster変数にオブジェクトを格納します。
最後のコマンドは、$HostsInClusterに格納されているすべてのホスト オブジェクトを Format-Table コマンドレットに渡します。このコマンドレットには、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 変数に格納します。
2 番目のコマンドでは、パイプライン演算子を使用して、$VMHostのホスト オブジェクトを Select-Object コマンドレットに渡します。このコマンドレットには、ホストのコンピューター名とオペレーティング システムが表示されます。
パラメーター
-ComputerName
ネットワーク内で Virtual Machine Manager が一意に識別できるコンピュータの名前を指定します。 有効な形式:
- FQDN
- IPv4 または IPv6 アドレス
- NetBIOS 名
注: 特定のコマンドレットの例を参照して、そのコマンドレットでコンピューター名を指定する方法を確認してください。
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
このコマンドレットは 、Host オブジェクトを返します。