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-SCVirtualMachine、 Get-SCVMTemplate 或 Get-SCHardwareProfile cmdlet 分别进行检索。