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 オブジェクトを返します。