Get-SCVMHost
仮想マシン マネージャー データベースから仮想マシン ホスト オブジェクトを取得します。
構文
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
VMM がネットワーク上で一意に識別できるコンピューターの名前を指定します。 有効な形式は次のとおりです。
- FQDN
- IPv4 または IPv6 アドレス
- NetBIOS 名
注: 特定のコマンドレットの例を参照して、そのコマンドレットでコンピューター名を指定する方法を確認してください。
| 型: | String |
| 配置: | 0 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ID
特定のオブジェクトのグローバル一意識別子 (GUID) として数値識別子を指定します。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VMHostCluster
VMM ホスト クラスター オブジェクトを指定します。
| 型: | HostCluster |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-VMHostGroup
仮想マシン ホスト グループ オブジェクトを指定します。
| 型: | HostGroup |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
| 型: | ServerConnection |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
出力
Host
このコマンドレットは、Host オブジェクトを返します。