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

ユーザーに確認せずに、直ちにコマンドを実行します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

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

Type:UserRole
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

-RunAsynchronously

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VM

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

Type:VM
Position:0
Default value:None
Required:True
Accept pipeline input:True
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

出力

VirtualMachine

メモ

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