Get-SCVirtualMachine

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

構文

All (既定)

Get-SCVirtualMachine
    [[-Name] <String>]
    [-VMMServer <ServerConnection>]
    [-All]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

VMHostGroup

Get-SCVirtualMachine
    [[-Name] <String>]
    -VMHost <Host>
    [-VMMServer <ServerConnection>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Cloud

Get-SCVirtualMachine
    [[-Name] <String>]
    -Cloud <Cloud>
    [-VMMServer <ServerConnection>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Service

Get-SCVirtualMachine
    [[-Name] <String>]
    -Service <Service>
    [-VMMServer <ServerConnection>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

ComputerTier

Get-SCVirtualMachine
    [[-Name] <String>]
    -ComputerTier <ComputerTier>
    [-VMMServer <ServerConnection>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

StorageQoSPolicy

Get-SCVirtualMachine
    [[-Name] <String>]
    -StorageQoSPolicy <StorageQoSPolicy>
    [-VMMServer <ServerConnection>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

ID

Get-SCVirtualMachine
    [[-Name] <String>]
    [-VMMServer <ServerConnection>]
    [-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 は、各仮想ディスク ドライブ オブジェクトが関連付けられている仮想マシン オブジェクトまたはテンプレート オブジェクトに関係なく、すべての仮想ディスク ドライブ オブジェクトを取得します。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

All
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Cloud

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

パラメーターのプロパティ

型:Cloud
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Cloud
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ComputerTier

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

パラメーターのプロパティ

型:ComputerTier
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ComputerTier
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ID

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

パラメーターのプロパティ

型:Guid
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ID
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Name

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:0
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-OnBehalfOfUser

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-OnBehalfOfUserRole

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

パラメーターのプロパティ

型:UserRole
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Service

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

パラメーターのプロパティ

型:Service
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Service
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-StorageQoSPolicy

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

パラメーターのプロパティ

型:StorageQoSPolicy
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

StorageQoSPolicy
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-VMHost

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

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

パラメーターのプロパティ

型:Host
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

VMHostGroup
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-VMMServer

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

パラメーターのプロパティ

型:ServerConnection
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

出力

VirtualMachine

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