Megosztás a következőn keresztül:

Remove-SCVirtualNetworkAdapter

  • Referencia
Modul:
VirtualMachineManager

Eltávolít egy virtuális hálózati adapter objektumot a VMM-ből.

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

A Remove-SCVirtualNetworkAdapter parancsmag eltávolít egy vagy több virtuális hálózatiadapter-objektumot egy virtuális gépről, virtuálisgép-sablonról vagy a Virtual Machine Manager(VMM) környezetben használt hardverprofilról.

Ez a parancsmag siker esetén visszaadja az objektumot (a MarkedForDeletion tulajdonság értéke $True), vagy hiba esetén hibaüzenetet ad vissza.

Példák

1. példa: A megadott MAC-címmel rendelkező virtuális hálózati adapter eltávolítása egy virtuális gépről

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

Az első parancs lekéri a VM01 nevű virtuálisgép-objektumot, és az objektumot a $VM változóban tárolja.

A második parancs lekéri a megadott MAC-címmel rendelkező virtuális hálózati adapter objektumot a VM01-en, és az objektumot a $Adapter változóban tárolja.

Az utolsó parancs eltávolítja a $Adapter-ben tárolt virtuális hálózati adaptert a VM01-ből.

2. példa: Egy adott virtuális hálózathoz csatlakoztatott virtuális hálózati adapter eltávolítása egy virtuális gépről

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

Az első parancs lekéri a VM02 nevű virtuálisgép-objektumot, és az objektumot a $VM változóban tárolja.

A második parancs lekéri a megadott virtuális hálózathoz csatlakoztatott VM02 virtuális hálózati adapter objektumát, és az objektumot a $Adapter változóban tárolja.

Az utolsó parancs eltávolítja az $Adapter változóban tárolt virtuális hálózati adapter objektumot a VM02-ből.

3. példa: Az egyetlen virtuális hálózati adapter eltávolítása egy virtuális gépről

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

Az első parancs lekéri a VM03 nevű virtuálisgép-objektumot, és az objektumot a $VM változóban tárolja.

A második parancs lekéri a virtuális hálózati adapter objektumot a VM03-on, és az objektumot a $Adapter változóban tárolja. Ez a példa feltételezi, hogy a VM03 csak egy virtuális hálózati adaptert használ.

Az utolsó parancs eltávolítja a $Adapter-ben tárolt virtuális hálózati adapter objektumot a VM03-ból.

4. példa: Az összes virtuális hálózati adapter eltávolítása egy virtuális gépről

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

Az első parancs lekéri a VM04 nevű virtuálisgép-objektumot, és az objektumot a $VM változóban tárolja.

A második parancs lekéri a VM04 összes virtuális hálózatiadapter-objektumát, és az objektumokat a $Adapters objektumtömbben tárolja.

Az utolsó parancs átadja a $Adapters-ben tárolt összes objektumot a Remove-SCVirtualNetworkAdapter parancsnak, amely eltávolítja az egyes virtuális hálózatiadapter-objektumokat a VM04-ből.

5. példa: Távolítsa el a második virtuális hálózati adaptert egy három virtuális hálózati adapterrel rendelkező virtuális gépről

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

Az első parancs lekéri a VM05 nevű virtuálisgép-objektumot, és az objektumot a $VM változóban tárolja.

A második parancs lekéri a VM05 összes virtuális hálózatiadapter-objektumát, és az objektumokat a $Adapters objektumtömbben tárolja. Ez a példa azt feltételezi, hogy a VM05 három virtuális hálózati adaptert használ.

Az utolsó parancs átadja a második virtuális hálózati adapter objektumot ($Adapters [1]) a Remove-SCVirtualNetworkAdapter parancsmagnak, amely eltávolítja ezt a virtuális hálózati adapter objektumot a VM05-ből.

Paraméterek

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

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

-JobGroup

Egy olyan parancssorozat azonosítóját adja meg, amely készletként fog futni, még mielőtt az ugyanazt a feladatcsoport-azonosítót tartalmazó utolsó parancs lefutna.

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

-JobVariable

Meghatározza, hogy a feladat előrehaladása nyomon legyen követve és tárolva legyen a paraméter által elnevezett változóban.

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

-OnBehalfOfUser

Felhasználónevet ad meg. Ez a parancsmag a paraméter által megadott felhasználó nevében működik.

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

-OnBehalfOfUserRole

Felhasználói szerepkört ad meg. Felhasználói szerepkör beszerzéséhez használja a Get-SCUserRole parancsmagot. Ez a parancsmag a paraméter által megadott felhasználói szerepkör nevében működik.

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

-PROTipID

Megadja a műveletet aktiváló teljesítmény- és erőforrás-optimalizálási tipp (PRO-tipp) azonosítóját. Ez a paraméter lehetővé teszi a PRO-tippek naplózását.

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

-RunAsynchronously

Azt jelzi, hogy a feladat aszinkron módon fut, így a vezérlő azonnal visszatér a parancsfelületre.

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

-SlotID

Egy eszköz azonosításához használt numerikus azonosítót ad meg.

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

-VirtualNetworkAdapter

Egy virtuális gép virtuális hálózati adapter objektumát adja meg.

A gazdagéptípusok a következő számú virtuális hálózati adaptert támogatják:

  • Hyper-V. Virtuális gépenként legfeljebb négy emulált adapter. Windows Server 2003 x64 rendszerű vendég operációs rendszeren nincs elérhető illesztőprogram emulált hálózati adapterhez.
  • Hyper-V. Virtuális gépenként legfeljebb nyolc szintetikus adapter.
  • VMware ESX. Virtuális gépenként legfeljebb négy emulált adapter.
  • Citrix XenServer. Virtuális gépenként legfeljebb hét emulált adapter.
Type:VirtualNetworkAdapter
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

Jegyzetek

  • VMM virtuális hálózati adapter objektumot igényel, amely a Get-SCVirtualNetworkAdapter parancsmaggal kérhető le.