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 コマンドレットは、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 オブジェクトを返します。