Dela via

Remove-SCVirtualNetworkAdapter

  • Referens
Modul:
VirtualMachineManager

Tar bort ett virtuellt nätverkskortobjekt från 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

Cmdleten remove-SCVirtualNetworkAdapter removes one or more virtual network adapter objects from a virtual machine, virtual machine template eller hardware profile used in a Virtual Machine Manager (VMM).

Den här cmdleten returnerar objektet när det lyckas (med egenskapen MarkedForDeletion inställd på $True) eller returnerar ett felmeddelande vid fel.

Exempel

Exempel 1: Ta bort ett virtuellt nätverkskort med den angivna MAC-adressen från en virtuell dator

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

Det första kommandot hämtar objektet för den virtuella datorn med namnet VM01 och lagrar objektet i variabeln $VM.

Det andra kommandot hämtar det virtuella nätverkskortobjektet på VM01 som har den angivna MAC-adressen och lagrar objektet i variabeln $Adapter.

Det senaste kommandot tar bort det virtuella nätverkskortet som lagras i $Adapter från VM01.

Exempel 2: Ta bort ett virtuellt nätverkskort som är anslutet till ett specifikt virtuellt nätverk från en virtuell dator

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

Det första kommandot hämtar objektet för den virtuella datorn med namnet VM02 och lagrar objektet i variabeln $VM.

Det andra kommandot hämtar det virtuella nätverkskortobjektet på VM02 som är anslutet till det angivna virtuella nätverket och lagrar objektet i variabeln $Adapter.

Det senaste kommandot tar bort det virtuella nätverkskortobjektet som lagras i $Adapter från VM02.

Exempel 3: Ta bort det enda virtuella nätverkskortet från en virtuell dator

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

Det första kommandot hämtar det virtuella datorobjektet vm03 och lagrar objektet i variabeln $VM.

Det andra kommandot hämtar det virtuella nätverkskortobjektet på VM03 och lagrar objektet i variabeln $Adapter. Det här exemplet förutsätter att VM03 bara har ett virtuellt nätverkskort.

Det senaste kommandot tar bort det virtuella nätverkskortobjektet som lagras i $Adapter från VM03.

Exempel 4: Ta bort alla virtuella nätverkskort från en virtuell dator

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

Det första kommandot hämtar objektet för den virtuella datorn med namnet VM04 och lagrar objektet i variabeln $VM.

Det andra kommandot hämtar alla virtuella nätverkskortobjekt på VM04 och lagrar objekten i $Adapters-objektmatrisen.

Det sista kommandot skickar varje objekt som lagras i $Adapters till Remove-SCVirtualNetworkAdapter, som tar bort varje virtuellt nätverkskortobjekt från VM04.

Exempel 5: Ta bort det andra virtuella nätverkskortet från en virtuell dator som har tre virtuella nätverkskort

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

Det första kommandot hämtar det virtuella datorobjektet vm05 och lagrar objektet i variabeln $VM.

Det andra kommandot hämtar alla virtuella nätverkskortobjekt på VM05 och lagrar objekten i $Adapters-objektmatrisen. Det här exemplet förutsätter att VM05 har tre virtuella nätverkskort.

Det sista kommandot skickar det andra objektet för virtuellt nätverkskort ($Adapters [1]) till Remove-SCVirtualNetworkAdapter cmdlet, som tar bort det här virtuella nätverkskortobjektet från VM05.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-JobGroup

Anger en identifierare för en serie kommandon som ska köras som en uppsättning precis innan det slutliga kommandot som innehåller samma jobbgruppsidentifierare körs.

Typ:Guid
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-JobVariable

Anger att jobbstatus spåras och lagras i variabeln med namnet av den här parametern.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-OnBehalfOfUser

Anger ett användarnamn. Den här cmdleten fungerar för användaren som den här parametern anger.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-OnBehalfOfUserRole

Anger en användarroll. Om du vill skaffa en användarroll använder du cmdleten Get-SCUserRole. Den här cmdleten fungerar för den användarroll som den här parametern anger.

Typ:UserRole
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PROTipID

Anger ID för tipset prestanda- och resursoptimering (PRO-tips) som utlöste den här åtgärden. Med den här parametern kan du granska PRO-tips.

Typ:Guid
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RunAsynchronously

Anger att jobbet körs asynkront så att kontrollen omedelbart återgår till kommandogränssnittet.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SlotID

Anger ett numeriskt ID som används för att identifiera en enhet.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-VirtualNetworkAdapter

Anger ett virtuellt nätverkskortobjekt för en virtuell dator.

Typer av värdar stöder följande antal virtuella nätverkskort:

  • Hyper-V. Upp till fyra emulerade kort per virtuell dator. Det finns ingen tillgänglig drivrutin för ett emulerat nätverkskort på ett Windows Server 2003 x64-gästoperativsystem.
  • Hyper-V. Upp till åtta syntetiska kort per virtuell dator.
  • VMware ESX. Upp till fyra emulerade kort per virtuell dator.
  • Citrix XenServer. Upp till sju emulerade kort per virtuell dator.
Typ:VirtualNetworkAdapter
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Kommentarer

  • Kräver ett virtuellt VMM-nätverkskortobjekt som kan hämtas med hjälp av cmdleten Get-SCVirtualNetworkAdapter.