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

このコマンドは、ホスト 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 オブジェクトを返します。