次の方法で共有

Read-SCVirtualMachine

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

VMM コンソールに仮想マシンに関する更新された情報が表示されるように、仮想マシンのプロパティを更新します。

構文

Read-SCVirtualMachine
    [-VM] <VM>
    [-Force]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]
Read-SCVirtualMachine
    [-VMHost] <Host>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

説明

Read-SCVirtualMachine コマンドレットは、仮想マシンマネージャー (VMM) コンソールに仮想マシンに関する更新された情報が表示されるように、仮想マシンのプロパティを更新します。 更新されたプロパティには、Name、Status、Host、Owner、CPUAverage、Service、OperatingSystem、およびその他のプロパティが含まれます。

例

例 1: 特定の仮想マシンに関する情報を更新する

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Read-SCVirtualMachine -VM $VM

最初のコマンドは、VM01 という名前の仮想マシン オブジェクトを取得し、そのオブジェクトを $VM 変数に格納します。

2 番目のコマンドは、$VMに格納されている仮想マシンのプロパティを更新します。 このコマンドが正常に完了すると、この仮想マシンに関する現在の情報が表示されます。

例 2: 指定した文字列と名前が一致するホスト上のすべての仮想マシンを更新する

PS C:\> $VMs = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | Where-Object { $_.VMHost.Name -Match "VMM" }
PS C:\> $VMs | Read-SCVirtualMachine

最初のコマンドは、名前に VMM が含まれるホストに展開されているすべての仮想マシン オブジェクトを VMMServer01 から取得し、それらの仮想マシン オブジェクトを $VMs 配列に格納します。

2 番目のコマンドは、$VMsに格納されている各仮想マシン オブジェクトのプロパティを更新します。

パラメーター

-Force

ユーザーの確認を求めずにコマンドを強制的に実行します。

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

-JobVariable

ジョブの進行状況を追跡して格納する変数を指定します。

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

-OnBehalfOfUser

ユーザー名を指定します。 このコマンドレットは、このパラメーターが指定したユーザーに代わって動作します。

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

-OnBehalfOfUserRole

ユーザー ロールを指定します。 ユーザー ロールを取得するには、Get-SCUserRole コマンドレットを使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールに代わって動作します。

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

-PROTipID

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

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

-RunAsynchronously

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

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

-VM

仮想マシン オブジェクトを指定します。

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

-VMHost

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

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

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

出力

VirtualMachine

メモ

  • このコマンドレットには、Get-SCVirtualMachine コマンドレットを使用して取得できる仮想マシン オブジェクトが必要です。