Get-SCVirtualNetwork

获取 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 cmdlet 获取在 Virtual Machine Manager(VMM)托管的主机上配置的一个或多个虚拟网络对象。

有关 VMM 中的虚拟网络的信息,请键入 Get-Help New-SCVirtualNetwork -Detailed

示例

示例 1:获取 VMM 数据库中的所有虚拟网络

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

第一个命令获取 VMM 管理的所有主机上的所有虚拟网络对象,并将虚拟网络对象存储在$VirtualNetworks中。

第二个命令显示有关$VirtualNetworks中每个虚拟网络对象的信息子集:每个虚拟网络的名称、每个虚拟网络配置的物理主机以及为每个虚拟网络在主机上配置的物理网络适配器。

示例 2:获取特定主机上的所有虚拟网络

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

第一个命令获取名为 VMHost01 的主机对象,并将该对象存储在$VMHost变量中。

第二个命令获取 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变量中。

第二个命令从 VMHost02 获取名为 InternalVNet01 的虚拟网络对象,并将对象存储在$VN变量中。

最后一个命令显示有关存储在用户$VN中的虚拟网络的信息。

参数

-ID

将数字标识符指定为特定对象的全局唯一标识符或 GUID。

类型:Guid
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Name

指定 VMM 对象的名称。

类型:String
Position:0
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-VMHost

指定虚拟机主机对象。 VMM 支持 Hyper-V 主机、VMware ESX 主机和 Citrix XenServer 主机。

有关每种主机类型的详细信息,请参阅 Add-SCVMHost cmdlet。

类型:Host
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-VMHostCluster

指定 VMM 主机群集对象。

类型:HostCluster
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-VMMServer

指定 VMM 服务器对象。

类型:ServerConnection
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

输出

VirtualNetwork

此 cmdlet 返回 VirtualNetwork 对象。