Sdílet prostřednictvím

Remove-SCVirtualNetworkAdapter

  • Reference
Modul:
VirtualMachineManager

Odebere objekt virtuálního síťového adaptéru z nástroje VMM.

Syntaxe

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

Rutina Remove-SCVirtualNetworkAdapter odebere jeden nebo více objektů virtuálního síťového adaptéru z virtuálního počítače, šablony virtuálního počítače nebo profilu hardwaru používaného v prostředí nástroje Virtual Machine Manager (VMM).

Tato rutina vrátí objekt po úspěchu (s vlastností MarkedForDeletion nastavenou na $True) nebo vrátí chybovou zprávu při selhání.

Příklady

Příklad 1: Odebrání virtuálního síťového adaptéru se zadanou adresou MAC z virtuálního počítače

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

První příkaz získá objekt virtuálního počítače s názvem VM01 a uloží ho do proměnné $VM.

Druhý příkaz získá objekt virtuálního síťového adaptéru na virtuálním počítači VM01, který má zadanou adresu MAC a uloží objekt do proměnné $Adapter.

Poslední příkaz odebere virtuální síťový adaptér uložený v $Adapter z virtuálního počítače VM01.

Příklad 2: Odebrání virtuálního síťového adaptéru připojeného ke konkrétní virtuální síti z virtuálního počítače

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

První příkaz získá objekt virtuálního počítače s názvem VM02 a uloží ho do proměnné $VM.

Druhý příkaz získá objekt virtuálního síťového adaptéru na virtuálním počítači VM02, který je připojený k zadané virtuální síti a uloží objekt do proměnné $Adapter.

Poslední příkaz odebere objekt virtuálního síťového adaptéru uložený v $Adapter z virtuálního počítače VM02.

Příklad 3: Odebrání jediného virtuálního síťového adaptéru z virtuálního počítače

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

První příkaz získá objekt virtuálního počítače s názvem VM03 a uloží ho do proměnné $VM.

Druhý příkaz získá objekt virtuálního síťového adaptéru na virtuálním počítači VM03 a uloží ho do proměnné $Adapter. Tento příklad předpokládá, že virtuální počítač VM03 má pouze jeden virtuální síťový adaptér.

Poslední příkaz odebere objekt virtuálního síťového adaptéru uložený v $Adapter z virtuálního počítače VM03.

Příklad 4: Odebrání všech virtuálních síťových adaptérů z virtuálního počítače

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

První příkaz získá objekt virtuálního počítače s názvem VM04 a uloží ho do proměnné $VM.

Druhý příkaz získá všechny objekty virtuálních síťových adaptérů na virtuálním počítači VM04 a uloží objekty do pole objektů $Adapters.

Poslední příkaz předá každý objekt uložený v $Adapters Remove-SCVirtualNetworkAdapter, který odebere každý objekt virtuálního síťového adaptéru z virtuálního počítače VM04.

Příklad 5: Odebrání druhého virtuálního síťového adaptéru z virtuálního počítače se třemi virtuálními síťovými adaptéry

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

První příkaz získá objekt virtuálního počítače s názvem VM05 a uloží objekt do proměnné $VM.

Druhý příkaz získá všechny objekty virtuálních síťových adaptérů na virtuálním počítači VM05 a uloží objekty do pole objektů $Adapters. Tento příklad předpokládá, že virtuální počítač VM05 má tři virtuální síťové adaptéry.

Poslední příkaz předá druhý objekt virtuálního síťového adaptéru ($Adapters [1]) do rutiny Remove-SCVirtualNetworkAdapter, která odebere tento objekt virtuálního síťového adaptéru z virtuálního počítače VM05.

Parametry

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-JobGroup

Určuje identifikátor pro řadu příkazů, které se spustí jako sada těsně před posledním příkazem, který obsahuje stejné spuštění identifikátoru skupiny úloh.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-JobVariable

Určuje, že průběh úlohy je sledován a uložen v proměnné pojmenované tímto parametrem.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OnBehalfOfUser

Určuje uživatelské jméno. Tato rutina funguje jménem uživatele, který tento parametr určuje.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OnBehalfOfUserRole

Určuje roli uživatele. Pokud chcete získat roli uživatele, použijte rutinu Get-SCUserRole. Tato rutina funguje jménem role uživatele, kterou tento parametr určuje.

Typ:UserRole
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PROTipID

Určuje ID tipu pro optimalizaci výkonu a prostředků (TIP PRO), který tuto akci aktivoval. Tento parametr umožňuje auditovat tipy PRO.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RunAsynchronously

Označuje, že úloha běží asynchronně, aby se ovládací prvek okamžitě vrátil do příkazového prostředí.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SlotID

Určuje číselné ID použité k identifikaci zařízení.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-VirtualNetworkAdapter

Určuje objekt virtuálního síťového adaptéru pro virtuální počítač.

Typy hostitelů podporují následující počet virtuálních síťových adaptérů:

  • Hyper-V. Až čtyři emulované adaptéry na virtuální počítač. Pro emulovaný síťový adaptér v hostovaném operačním systému Windows Server 2003 x64 není k dispozici žádný ovladač.
  • Hyper-V. Až osm syntetických adaptérů na virtuální počítač.
  • VMware ESX. Až čtyři emulované adaptéry na virtuální počítač.
  • Citrix XenServer. Až sedm emulovaných adaptérů na virtuální počítač.
Typ:VirtualNetworkAdapter
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Poznámky

  • Vyžaduje objekt virtuálního síťového adaptéru VMM, který lze načíst pomocí rutiny Get-SCVirtualNetworkAdapter.