Udostępnij za pośrednictwem

Remove-SCVirtualNetworkAdapter

  • Odwołanie
Moduł:
VirtualMachineManager

Usuwa obiekt wirtualnej karty sieciowej z programu VMM.

Składnia

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>]

Opis

Polecenie cmdlet Remove-SCVirtualNetworkAdapter usuwa co najmniej jeden obiekt wirtualnej karty sieciowej z maszyny wirtualnej, szablonu maszyny wirtualnej lub profilu sprzętowego używanego w środowisku programu Virtual Machine Manager (VMM).

To polecenie cmdlet zwraca obiekt po pomyślnym powodzeniu (z właściwością MarkedForDeletion ustawioną na $True) lub zwraca komunikat o błędzie po awarii.

Przykłady

Przykład 1. Usuwanie wirtualnej karty sieciowej z określonym adresem MAC z maszyny wirtualnej

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

Pierwsze polecenie pobiera obiekt maszyny wirtualnej o nazwie VM01 i przechowuje obiekt w zmiennej $VM.

Drugie polecenie pobiera obiekt wirtualnej karty sieciowej na maszynie wirtualnej VM01, który ma określony adres MAC i przechowuje obiekt w zmiennej $Adapter.

Ostatnie polecenie usuwa wirtualną kartę sieciową przechowywaną w $Adapter z maszyny wirtualnej VM01.

Przykład 2. Usuwanie wirtualnej karty sieciowej połączonej z określoną siecią wirtualną z maszyny wirtualnej

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

Pierwsze polecenie pobiera obiekt maszyny wirtualnej o nazwie VM02 i przechowuje obiekt w zmiennej $VM.

Drugie polecenie pobiera obiekt wirtualnej karty sieciowej na maszynie wirtualnej VM02, który jest połączony z określoną siecią wirtualną i przechowuje obiekt w zmiennej $Adapter.

Ostatnie polecenie powoduje usunięcie z maszyny wirtualnej VM02 obiektu wirtualnej karty sieciowej przechowywanego w zmiennej $Adapter.

Przykład 3. Usuwanie jedynej wirtualnej karty sieciowej z maszyny wirtualnej

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

Pierwsze polecenie pobiera obiekt maszyny wirtualnej o nazwie VM03 i przechowuje obiekt w zmiennej $VM.

Drugie polecenie pobiera obiekt wirtualnej karty sieciowej na maszynie wirtualnej VM03 i przechowuje obiekt w zmiennej $Adapter. W tym przykładzie założono, że maszyna wirtualna VM03 ma tylko jedną wirtualną kartę sieciową.

Ostatnie polecenie usuwa obiekt wirtualnej karty sieciowej przechowywany w $Adapter z maszyny wirtualnej VM03.

Przykład 4. Usuwanie wszystkich wirtualnych kart sieciowych z maszyny wirtualnej

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

Pierwsze polecenie pobiera obiekt maszyny wirtualnej o nazwie VM04 i przechowuje obiekt w zmiennej $VM.

Drugie polecenie pobiera wszystkie obiekty wirtualnej karty sieciowej na maszynie wirtualnej VM04 i przechowuje obiekty w tablicy obiektów $Adapters.

Ostatnie polecenie przekazuje każdy obiekt przechowywany w $Adapters do polecenia Remove-SCVirtualNetworkAdapter, który usuwa każdy obiekt wirtualnej karty sieciowej z maszyny wirtualnej VM04.

Przykład 5. Usuwanie drugiej wirtualnej karty sieciowej z maszyny wirtualnej z trzema wirtualnymi kartami sieciowymi

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

Pierwsze polecenie pobiera obiekt maszyny wirtualnej o nazwie VM05 i przechowuje obiekt w zmiennej $VM.

Drugie polecenie pobiera wszystkie obiekty wirtualnej karty sieciowej na maszynie wirtualnej VM05 i przechowuje obiekty w tablicy obiektów $Adapters. W tym przykładzie założono, że maszyna wirtualna VM05 ma trzy wirtualne karty sieciowe.

Ostatnie polecenie przekazuje drugi obiekt wirtualnej karty sieciowej ($Adapters [1]) do polecenia cmdlet Remove-SCVirtualNetworkAdapter , które usuwa ten obiekt wirtualnej karty sieciowej z maszyny wirtualnej VM05.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-JobGroup

Określa identyfikator serii poleceń, które będą uruchamiane jako zestaw tuż przed ostatnim poleceniem zawierającym ten sam identyfikator grupy zadań.

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

-JobVariable

Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie przez ten parametr.

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

-OnBehalfOfUser

Określa nazwę użytkownika. To polecenie cmdlet działa w imieniu użytkownika określonego przez ten parametr.

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

-OnBehalfOfUserRole

Określa rolę użytkownika. Aby uzyskać rolę użytkownika, użyj polecenia cmdlet Get-SCUserRole . To polecenie cmdlet działa w imieniu roli użytkownika, którą określa ten parametr.

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

-PROTipID

Określa identyfikator porady wydajności i optymalizacji zasobów (porada PRO), która wyzwoliła tę akcję. Ten parametr umożliwia inspekcję porad PRO.

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

-RunAsynchronously

Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.

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

-SlotID

Określa identyfikator liczbowy używany do identyfikowania urządzenia.

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

-VirtualNetworkAdapter

Określa obiekt wirtualnej karty sieciowej dla maszyny wirtualnej.

Typy hostów obsługują następującą liczbę wirtualnych kart sieciowych:

  • Hyper-V. Maksymalnie cztery emulowane karty na maszynę wirtualną. W systemie operacyjnym gościa systemu Windows Server 2003 x64 nie ma dostępnego sterownika emulowanej karty sieciowej.
  • Hyper-V. Maksymalnie osiem syntetycznych kart na maszynę wirtualną.
  • VMware ESX. Maksymalnie cztery emulowane karty na maszynę wirtualną.
  • Citrix XenServer. Maksymalnie siedem emulowanych kart na maszynę wirtualną.
Type:VirtualNetworkAdapter
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

Uwagi

  • Wymaga obiektu wirtualnej karty sieciowej programu VMM, który można pobrać za pomocą polecenia cmdlet Get-SCVirtualNetworkAdapter .