Sdílet prostřednictvím

Remove-SCVirtualNetworkAdapter

  • Reference
Modul:
VirtualMachineManager

Odebere objekt virtuálního síťového adaptéru z nástroje 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

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

Tato rutina vrátí objekt po úspěchu (s vlastností OznačenoForDeletion 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ží objekt 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ží objekt 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 z virtuálního počítače VM02 adaptér uložený v proměnné $Adapter.

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ží objekt 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ží objekt do proměnné $Adapter. V tomto příkladu se předpokládá, že VM03 má jenom 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ží objekt do proměnné $VM.

Druhý příkaz získá všechny objekty virtuálního síťového adaptéru 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 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ího síťového adaptéru na virtuálním počítači VM05 a uloží objekty do pole objektů $Adapters. Tento příklad předpokládá, že 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]) rutině 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 zobrazí výzvu k potvrzení.

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

-JobGroup

Určuje identifikátor řady příkazů, které se budou spouštět jako sada těsně před posledním příkazem, který obsahuje stejný identifikátor skupiny úloh.

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

-JobVariable

Určuje, že průběh úlohy se sleduje a ukládá do proměnné pojmenované tímto parametrem.

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

-OnBehalfOfUser

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

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

-OnBehalfOfUserRole

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

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

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

-RunAsynchronously

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

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

-SlotID

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

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Poznámky

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