Read-SCVMHost
VMM コンソールで仮想マシン ホストのプロパティを更新します。
構文
Read-SCVMHost
[-VMHost] <Host>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
Read-SCVMHost
[-VMHost] <Host>
[-RefreshOutOfBandProperties]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
説明
Read-SCVMHost コマンドレットは、仮想マシン マネージャー (VMM) コンソールにホストに関する更新された情報が表示されるように、仮想マシン ホストのプロパティを更新します。
このコマンドレットで更新されるホストのプロパティは、次のとおりです。
- 名前
- オペレーティング システム
- 状態 (応答など)
- ホスト ボリューム (通常、ドライブ文字、マウント ポイント、および使用可能な領域の追加または削除)
- ネットワーク アダプター (追加または削除)
例
例 1: 特定のホストに関する情報を更新する
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01"
PS C:\> Read-SCVMHost -VMHost $VMHost
最初のコマンドは、VMHost01 という名前のホスト オブジェクトを取得し、そのオブジェクトを $VMHost 変数に格納します。
2 番目のコマンドは、このホストに関する現在の情報が VMM コンソールに表示されるように、VMHost01 のプロパティを更新します。
例 2: すべてのホストに関する情報を更新する
PS C:\> Get-SCVMHost -VMMServer "VMMServer01.Contoso.com" | Read-SCVMHost
このコマンドは、VMMServer01 によって管理されているすべてのホストに関する情報を更新して、各ホストに関する現在の情報が VMM コンソールに表示されるようにします。
例 3: OOB チャネルを使用して特定のホストに関する情報を更新する
PS C:\> Get-SCVMHost -ComputerName "VMHost02" | Read-SCVMHost -RefreshOutOfBandProperties
このコマンドは、ホスト VMHost02 に関する情報を帯域外インターフェイスを使用して更新し、ホストに関する現在の情報が VMM コンソールに表示されるようにします。
パラメーター
-JobVariable
ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RefreshOutOfBandProperties
帯域外ベースボード管理コントローラー (BMC) を使用して、使用可能なコンピューターのハードウェア プロパティを更新します。 ホスト リフレッシャーはオペレーティング システム (帯域内) 内の VMM エージェントを経由するため、このプロセスは通常のホスト更新ロジックとは異なります。 BMC によって更新されるプロパティは、インバンド リフレッシャーのプロパティとは異なります。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMHost
仮想マシン ホスト オブジェクトを指定します。 VMM では、Hyper-V ホスト、VMware ESX ホスト、Citrix XenServer ホストがサポートされます。
各種類のホストの詳細については、 Add-SCVMHost コマンドレットを参照してください。
Type: | Host |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
出力
Host
このコマンドレットは 、Host オブジェクトを返します。