Dela via

Remove-SCVirtualNetworkAdapter

  • Referens
Modul:
VirtualMachineManager

Tar bort ett virtuellt nätverkskortsobjekt 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 tar bort ett eller flera virtuella nätverkskortobjekt från en virtuell dator, mall för virtuella datorer eller maskinvaruprofil som används i en VMM-miljö (Virtual Machine Manager).

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 det virtuella datorobjektet 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 det virtuella datorobjektet VM02 och lagrar objektet i variabeln $VM.

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

Det sista kommandot tar bort det virtuella nätverkskortsobjektet 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 objektet för det virtuella nätverkskortet 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ätverkskortsobjektet 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 det virtuella datorobjektet VM04 och lagrar objektet i variabeln $VM.

Det andra kommandot hämtar alla virtuella nätverkskortsobjekt 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ätverkskortsobjekt 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ätverkskortsobjekt 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 cmdleten Remove-SCVirtualNetworkAdapter , som tar bort det här virtuella nätverkskortobjektet från VM05.

Parametrar

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-JobVariable

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

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

-OnBehalfOfUser

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

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

-OnBehalfOfUserRole

Anger en användarroll. Om du vill hämta 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.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-RunAsynchronously

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

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

-SlotID

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

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.
Type:VirtualNetworkAdapter
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

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

Kommentarer

  • Kräver ett VMM-objekt för virtuellt nätverkskort som kan hämtas med hjälp av cmdleten Get-SCVirtualNetworkAdapter .