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 cmdlet 从虚拟机对象、虚拟机模板对象或 Virtual Machine Manager (VMM) 环境中的硬件配置文件对象获取一个或多个虚拟网络适配器对象。

示例

示例 1:从虚拟机获取虚拟网络适配器

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Get-SCVirtualNetworkAdapter -VM $VM

第一个命令获取名为 VM01 的虚拟机对象,并将该对象存储在$VM变量中。

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

第二个命令获取所有虚拟网络适配器对象 NewHWProfile01,并向用户显示有关这些适配器的信息。

参数

-All

指示此 cmdlet 获取独立于父对象的所有从属对象。

例如,该命令 Get-SCVirtualDiskDrive -All 获取所有虚拟磁盘驱动器对象,而不考虑每个虚拟磁盘驱动器对象关联的虚拟机对象或模板对象。

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

-HardwareProfile

指定硬件配置文件对象。

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

-ID

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

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

-Name

指定网络对象的名称。

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OnBehalfOfUser

指定用户名。 此 cmdlet 代表此参数指定的用户操作。

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

-OnBehalfOfUserRole

指定用户角色。 若要获取用户角色,请使用 Get-SCUserRole cmdlet。 此 cmdlet 代表此参数指定的用户角色进行操作。

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

-ParentTypeVMOrHost

指示父类型为虚拟机或主机。

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

-VM

指定一个虚拟机对象。

Type:VM
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 cmdlet。

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

-VMTemplate

指定一个用于创建虚拟机的 VMM 模板对象。

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

输出

VirtualNetworkAdapter

此 cmdlet 返回 VirtualNetworkAdapter 对象。

备注

  • 需要 VMM 虚拟机对象、虚拟机模板对象或硬件配置文件对象,可以使用 Get-SCVirtualMachineGet-SCVMTemplateGet-SCHardwareProfile cmdlet 分别进行检索。