Remove-SCVirtualNetworkAdapter

模組:

VirtualMachineManager

從 VMM 移除虛擬網路介面卡物件。

Syntax

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>]

Description

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，這會從 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 提示 (PRO 提示的識別碼) 。 此參數可讓您稽核 PRO 秘訣。

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

-RunAsynchronously

表示作業會以非同步方式執行，讓控制項立即返回命令殼層。

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

-SlotID

指定用來識別裝置的數值識別碼。

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。 每個虛擬機器最多八個綜合介面卡。
• VMware ESX。 每個虛擬機器最多四個模擬介面卡。
• Citrix XenServer。 每個虛擬機器最多有七個模擬介面卡。

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 來擷取。

相關連結

• Get-SCVirtualMachine
• Get-SCVirtualNetworkAdapter
• New-SCVirtualNetworkAdapter
• Repair-SCVirtualNetworkAdapter
• Set-SCVirtualNetworkAdapter