通过

Remove-SCVirtualNetworkAdapter

  • 参考
模块:
VirtualMachineManager

从 VMM 中删除虚拟网络适配器对象。

语法

Remove-SCVirtualNetworkAdapter
      [-VirtualNetworkAdapter] <VirtualNetworkAdapter>
      [-JobGroup <Guid>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]
Remove-SCVirtualNetworkAdapter
      -SlotID <Int32>
      -JobGroup <Guid>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

说明

Remove-SCVirtualNetworkAdapter cmdlet 从虚拟机、虚拟机模板或虚拟机管理器（VMM）环境中使用的硬件配置文件中删除一个或多个虚拟网络适配器对象。

此 cmdlet 在成功时返回对象（属性 MarkedForDeletion 设置为 $True），或在失败时返回错误消息。

示例

示例 1：从虚拟机中删除具有指定 MAC 地址的虚拟网络适配器

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM | where { $_.PhysicalAddress -eq "00:16:D3:CC:00:1B" }
PS C:\> Remove-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter

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

第二个命令获取 VM01 上的虚拟网络适配器对象，该对象具有指定的 MAC 地址，并将该对象存储在$Adapter变量中。

最后一个命令从 VM01 中删除存储在$Adapter中的虚拟网络适配器。

示例 2：从虚拟机中删除连接到特定虚拟网络的虚拟网络适配器

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM | where { $_.VirtualNetwork -eq "ExternalVirtualNetwork01" }
PS C:\> Remove-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter

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

第二个命令获取连接到指定虚拟网络的 VM02 上的虚拟网络适配器对象，并将该对象存储在$Adapter变量中。

最后一个命令从 VM02 中删除存储在$Adapter中的虚拟网络适配器对象。

示例 3：从虚拟机中删除唯一的虚拟网络适配器

PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> Remove-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter

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

第二个命令获取 VM03 上的虚拟网络适配器对象，并将该对象存储在$Adapter变量中。 此示例假定 VM03 只有一个虚拟网络适配器。

最后一个命令从 VM03 中删除存储在$Adapter中的虚拟网络适配器对象。

示例 4：从虚拟机中删除所有虚拟网络适配器

PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> $Adapters | Remove-SCVirtualNetworkAdapter

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

第二个命令获取 VM04 上的所有虚拟网络适配器对象，并将对象存储在$Adapters对象数组中。

最后一个命令将存储在$Adapters中的每个对象传递给 Remove-SCVirtualNetworkAdapter，这将从 VM04 中删除每个虚拟网络适配器对象。

示例 5：从具有三个虚拟网络适配器的虚拟机中删除第二个虚拟网络适配器

PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> $Adapters[1] | Remove-SCVirtualNetworkAdapter

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

第二个命令获取 VM05 上的所有虚拟网络适配器对象，并将对象存储在$Adapters对象数组中。 此示例假定 VM05 有三个虚拟网络适配器。

最后一个命令将第二个虚拟网络适配器对象（$Adapters [1]）传递给 Remove-SCVirtualNetworkAdapter cmdlet，该 cmdlet 从 VM05 中删除此虚拟网络适配器对象。

参数

-Confirm

在运行 cmdlet 之前，提示你进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-JobGroup

指定一系列命令的标识符，该命令将在包含相同作业组标识符的最终命令运行之前作为集运行。

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

-JobVariable

指定在此参数命名的变量中跟踪和存储作业进度。

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

-OnBehalfOfUser

指定用户名。 此 cmdlet 代表此参数指定的用户运行。

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

-OnBehalfOfUserRole

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

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

-PROTipID

指定触发此操作的性能和资源优化提示（PRO 提示）的 ID。 此参数允许你审核 PRO 提示。

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

-RunAsynchronously

指示作业以异步方式运行，以便控件立即返回到命令行界面。

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

-SlotID

指定用于标识设备的数字 ID。

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

-VirtualNetworkAdapter

指定虚拟机的虚拟网络适配器对象。

主机类型支持以下数量的虚拟网络适配器：

  • Hyper-V。 每个虚拟机最多四个模拟适配器。 Windows Server 2003 x64 来宾操作系统上没有可用于模拟网络适配器的驱动程序。
  • Hyper-V。 每个虚拟机最多 8 个合成适配器。
  • VMware ESX。 每个虚拟机最多四个模拟适配器。
  • Citrix XenServer。 每个虚拟机最多 7 个模拟适配器。
类型:VirtualNetworkAdapter
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

备注

  • 需要 VMM 虚拟网络适配器对象，可以使用 Get-SCVirtualNetworkAdapter cmdlet 进行检索。