Get-SCVirtualNetwork

  • リファレンス
モジュール:
VirtualMachineManager

VMM ホストで構成された仮想ネットワーク オブジェクトを取得します。

構文

Get-SCVirtualNetwork
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [<CommonParameters>]
Get-SCVirtualNetwork
   -VMHostCluster <HostCluster>
   [[-Name] <String>]
   [<CommonParameters>]
Get-SCVirtualNetwork
   -ID <Guid>
   [[-Name] <String>]
   [<CommonParameters>]
Get-SCVirtualNetwork
   -VMHost <Host>
   [[-Name] <String>]
   [<CommonParameters>]

説明

Get-SCVirtualNetwork コマンドレットは、Virtual Machine Manager (VMM) によって管理されるホストで構成された 1 つ以上の仮想ネットワーク オブジェクトを取得します。

VMM の仮想ネットワークの詳細については、「.」と入力します Get-Help New-SCVirtualNetwork -Detailed。

例

例 1: VMM データベース内のすべての仮想ネットワークを取得する

PS C:\> $VirtualNetworks = Get-SCVirtualNetwork 
PS C:\> $VirtualNetworks | Format-List Name,VMHost,VMHostNetworkadapters

最初のコマンドは、VMM によって管理されているすべてのホスト上のすべての仮想ネットワーク オブジェクトを取得し、仮想ネットワーク オブジェクトを$VirtualNetworksに格納します。

2 番目のコマンドは、$VirtualNetworks内の各仮想ネットワーク オブジェクトに関する情報のサブセットを表示します。各仮想ネットワークの名前、各仮想ネットワークが構成されている物理ホスト、および各仮想ネットワークのホストに構成されている物理ネットワーク アダプター。

例 2: 特定のホスト上のすべての仮想ネットワークを取得する

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com" 
PS C:\> Get-SCVirtualNetwork -VMHost $VMHost

最初のコマンドは、VMHost01 という名前のホスト オブジェクトを取得し、そのオブジェクトを $VMHost 変数に格納します。

2 番目のコマンドは、VMHost01 上のすべての仮想ネットワーク オブジェクトを取得し、各仮想ネットワークに関する情報を表示します。

例 3: 特定のホストから名前で仮想ネットワークを取得する

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost02.Contoso.com" 
PS C:\> $VN = Get-SCVirtualNetwork -VMHost $VMHost -Name "InternalVNet01"
PS C:\> $VN

最初のコマンドは、VMHost02 という名前のホスト オブジェクトを取得し、$VMHost変数にオブジェクトを格納します。

2 番目のコマンドは、VMHost02 から InternalVNet01 という名前の仮想ネットワーク オブジェクトを取得し、$VN変数にオブジェクトを格納します。

最後のコマンドは、ユーザーに$VNに格納されている仮想ネットワークに関する情報を表示します。

パラメーター

-ID

特定のオブジェクトのグローバル一意識別子 (GUID) として数値識別子を指定します。

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
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

-VMHostCluster

VMM ホスト クラスタ オブジェクトを指定します。

Type:HostCluster
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

出力

VirtualNetwork

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