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 コマンドレットは、仮想マシン マネージャー (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 オブジェクトを返します。