Get-SCVirtualMachine
仮想マシン オブジェクトを取得します。
構文
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 コマンドレットは、仮想マシン マネージャー (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 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Cloud
プライベート クラウド オブジェクトを指定します。
型: | Cloud |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ComputerTier
コンピューター層オブジェクトを指定します。
型: | ComputerTier |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ID
オブジェクトの一意の ID を指定します。
型: | Guid |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Name
VMM オブジェクトの名前を指定します。
型: | String |
配置: | 0 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-OnBehalfOfUser
ユーザー名を指定します。 このコマンドレットは、このパラメーターが指定したユーザーに代わって動作します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。 ユーザー ロールを取得するには、Get-SCUserRole コマンドレットを使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールに代わって動作します。
型: | UserRole |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Service
VMM サービス オブジェクトを指定します。
型: | Service |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-StorageQoSPolicy
このコマンドレットが取得する仮想マシンのサービス品質 (QoS) ポリシーを指定します。
型: | StorageQoSPolicy |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-VMHost
仮想マシン ホスト オブジェクトを指定します。 VMM では、Hyper-V ホスト、VMware ESX ホスト、Citrix XenServer ホストがサポートされます。
ホストの各種類の詳細については、Add-SCVMHost コマンドレットを参照してください。
型: | Host |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
型: | ServerConnection |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
出力
VirtualMachine
このコマンドレットは、VirtualMachine オブジェクト