Get-SCVirtualNetworkAdapter
仮想マシン、仮想マシン テンプレート、またはハードウェア プロファイルから VMM 仮想ネットワーク アダプター オブジェクトを取得します。
構文
Get-SCVirtualNetworkAdapter
[-VMMServer <ServerConnection>]
[-All]
[-ParentTypeVMOrHost]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Get-SCVirtualNetworkAdapter
[-VMMServer <ServerConnection>]
-HardwareProfile <HardwareProfile>
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Get-SCVirtualNetworkAdapter
[-VMMServer <ServerConnection>]
-VM <VM>
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Get-SCVirtualNetworkAdapter
[-VMMServer <ServerConnection>]
-VMTemplate <Template>
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Get-SCVirtualNetworkAdapter
[-VMMServer <ServerConnection>]
-VMHost <Host>
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Get-SCVirtualNetworkAdapter
[-VMMServer <ServerConnection>]
[-ID] <Guid>
[[-Name] <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] 説明
Get-SCVirtualNetworkAdapter コマンドレットは、仮想マシン オブジェクト、仮想マシン テンプレート オブジェクト、または仮想マシン マネージャー (VMM) 環境のハードウェア プロファイル オブジェクトから 1 つ以上の仮想ネットワーク アダプター オブジェクトを取得します。
例
例 1: 仮想マシンから仮想ネットワーク アダプターを取得する
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Get-SCVirtualNetworkAdapter -VM $VM最初のコマンドは、VM01 という名前の仮想マシン オブジェクトを取得し、そのオブジェクトを $VM 変数に格納します。
2 番目のコマンドは、VM01 上のすべての仮想ネットワーク アダプター オブジェクトを取得し、アダプターに関する情報をユーザーに表示します。
例 2: 仮想マシン テンプレートから仮想ネットワーク アダプターを取得する
PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> Get-SCVirtualNetworkAdapter -Template $VMTemplate最初のコマンドは、VMM ライブラリからすべての仮想マシン テンプレート オブジェクトを取得し、VMTemplate01 という名前のテンプレート オブジェクトを選択して、$VMTemplate変数に格納します。
最後のコマンドは、すべての仮想ネットワーク アダプター オブジェクト VMTemplate01 を取得し、これらのアダプターに関する情報をユーザーに表示します。
例 3: ハードウェア プロファイルから仮想ネットワーク アダプターを取得する
PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> Get-SCVirtualNetworkAdapter -HardwareProfile $HWProfile最初のコマンドは、VMM ライブラリ内のすべてのハードウェア プロファイル オブジェクトを取得し、NewHWProfile01 という名前のプロファイル オブジェクトを選択し、そのオブジェクトを $HWProfile 変数に格納します。
2 番目のコマンドは、すべての仮想ネットワーク アダプター オブジェクト NewHWProfile01 を取得し、これらのアダプターに関する情報をユーザーに表示します。
パラメーター
-All
このコマンドレットは、親オブジェクトに依存しないすべての下位オブジェクトを取得することを示します。
たとえば、コマンド Get-SCVirtualDiskDrive -All は、各仮想ディスク ドライブ オブジェクトが関連付けられている仮想マシン オブジェクトまたはテンプレート オブジェクトに関係なく、すべての仮想ディスク ドライブ オブジェクトを取得します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-HardwareProfile
ハードウェア プロファイル オブジェクトを指定します。
| 型: | HardwareProfile |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ID
特定のオブジェクトのグローバル一意識別子 (GUID) として数値識別子を指定します。
| 型: | Guid |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Name
ネットワーク オブジェクトの名前を指定します。
| 型: | String |
| 配置: | 1 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-OnBehalfOfUser
ユーザー名を指定します。 このコマンドレットは、このパラメーターが指定したユーザーに代わって動作します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。 ユーザー ロールを取得するには、Get-SCUserRole コマンドレットを使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールに代わって動作します。
| 型: | UserRole |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ParentTypeVMOrHost
親の種類が仮想マシンまたはホストであることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-VM
仮想マシン オブジェクトを指定します。
| 型: | VM |
| 配置: | 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 |
-VMTemplate
仮想マシンの作成に使用する VMM テンプレート オブジェクトを指定します。
| 型: | Template |
| Aliases: | Template |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
出力
VirtualNetworkAdapter
このコマンドレットは、VirtualNetworkAdapter オブジェクト
メモ
- Get-SCVirtualMachine、Get-SCVMTemplate、または Get-SCHardwareProfile コマンドレットをそれぞれ使用して取得できる VMM 仮想マシン オブジェクト、仮想マシン テンプレート オブジェクト、またはハードウェア プロファイル オブジェクトが必要です。