Get-SCVirtualMachine

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

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

構文

Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-All]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   -VMHost <Host>
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   -Cloud <Cloud>
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   -Service <Service>
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   -ComputerTier <ComputerTier>
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   -StorageQoSPolicy <StorageQoSPolicy>
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

説明

Get-SCVirtualMachine コマンドレットは、Virtual Machine Manager (VMM) データベースから 1 つ以上の仮想マシン オブジェクトを取得します。 このコマンドレットは、仮想マシン ホストに展開されるか、VMM ライブラリに格納されている仮想マシンを取得します。

例

例 1: すべての仮想マシンを取得し、それぞれに関する情報を表示する

PS C:\> Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com"

このコマンドは、VMMServer01 上のすべての仮想マシン オブジェクトを取得し、これらの仮想マシン オブジェクトに関する情報を表示します。

例 2: すべての仮想マシンを取得し、特定のプロパティに関する情報を表示する

PS C:\> Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | Format-List -Property Name, Owner, Description, HostName, OperatingSystem, CPUCount, Memory

このコマンドは、VMMServer01 上のすべての仮想マシン オブジェクトを取得し、指定したプロパティの値を表示します。

例 3: 指定したライブラリ サーバーに格納されている名前で仮想マシンを取得する

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> Get-SCVirtualMachine | Where-Object { $_.Name -Eq "VM02" -And $_.LibraryServer -Eq "LibraryServer01" } | Select-Object Name,LibraryServer,Status

最初のコマンドは VMMServer01 に接続します。

2 番目のコマンドは、LibraryServer01 に格納されている VM02 という名前の仮想マシン オブジェクトを取得し、仮想マシン名、ライブラリ サーバーの名前、および仮想マシンの状態を表示します。

例 4: 指定したホスト上のすべての仮想マシンを取得する

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> Get-SCVirtualMachine -VMHost "VMHost01.Contoso.com"

最初のコマンドは VMMServer01 に接続します。

2 番目のコマンドは、VMHost01 にデプロイされているすべての仮想マシン オブジェクトを取得し、これらの仮想マシンに関する情報を表示します。

パラメーター

-All

このコマンドレットは、親オブジェクトに関係なくすべての下位オブジェクトを取得することを示します。 たとえば、コマンドは、各仮想ディスク ドライブ オブジェクトが関連付けられている仮想マシン オブジェクトまたはテンプレート オブジェクトに関係なく、すべての仮想ディスク ドライブ オブジェクトを取得します Get-SCVirtualDiskDrive -All 。

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

-Cloud

プライベート クラウド オブジェクトを指定します。

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

-ComputerTier

コンピューター層オブジェクトを指定します。

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

-ID

オブジェクトの一意の ID を指定します。

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

-Name

VMM オブジェクトの名前を指定します。

Type:String
Position:0
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

-Service

VMM サービス オブジェクトを指定します。

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

-StorageQoSPolicy

このコマンドレットが取得する仮想マシンのサービス品質 (QoS) ポリシーを指定します。

Type:StorageQoSPolicy
Position:Named
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:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMMServer

VMM サーバー オブジェクトを指定します。

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

出力

VirtualMachine

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