Read-SCVMHost

  • リファレンス
モジュール:
VirtualMachineManager

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

このコマンドは、ホストに関する現在の情報が VMM コンソールに表示されるように、ホスト VMHost02 に関する情報を帯域外インターフェイスを使用して更新します。

パラメーター

-JobVariable

ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PROTipID

このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。

型:Guid
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RefreshOutOfBandProperties

帯域外ベースボード管理コントローラー (BMC) を使用して、使用可能なコンピューターのハードウェア プロパティを更新します。 ホスト リフレッシャーはオペレーティング システム (インバンド) 内の VMM エージェントを経由するため、このプロセスは通常のホスト更新ロジックとは異なります。 BMC によって更新されるプロパティは、インバンド リフレッシャーのプロパティとは異なります。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RunAsynchronously

コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-VMHost

仮想マシン ホスト オブジェクトを指定します。 VMM では、Hyper-V ホスト、VMware ESX ホスト、Citrix XenServer ホストがサポートされます。

ホストの各種類の詳細については、Add-SCVMHost コマンドレットを参照してください。

型:Host
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

出力

Host

このコマンドレットは、Host オブジェクトを返します。