Remove-SCVirtualNetworkAdapter
从 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 从 Virtual Machine Manager (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 之前进行确认。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobGroup
在运行最后一个包含相同作业组标识符的命令之前,为作为集合运行的一系列命令指定标识符。
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobVariable
指定跟踪作业进度,并将其存储在此参数命名的变量中。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
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 |
-PROTipID
指定触发此操作 (PRO 提示) 的性能和资源优化提示的 ID。 此参数允许审核 PRO 提示。
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
指示作业异步运行,以便控件立即返回到命令 shell。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SlotID
指定用于标识设备的数字 ID。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VirtualNetworkAdapter
指定虚拟机的虚拟网络适配器对象。
主机类型支持以下数量的虚拟网络适配器:
- Hyper-V。 每个虚拟机最多四个模拟适配器。 Windows Server 2003 x64 来宾操作系统上没有可用于模拟网络适配器的驱动程序。
- Hyper-V。 每个虚拟机最多 8 个合成适配器。
- VMware ESX。 每个虚拟机最多四个模拟适配器。
- Citrix XenServer。 每个虚拟机最多 7 个模拟适配器。
Type: | VirtualNetworkAdapter |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
备注
- 需要 VMM 虚拟网络适配器对象,可以使用 Get-SCVirtualNetworkAdapter cmdlet 进行检索。