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ętu używanego w środowisku programu Virtual Machine Manager (VMM).

To polecenie cmdlet zwraca obiekt po 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 usuwa obiekt wirtualnej karty sieciowej przechowywany w $Adapter z maszyny wirtualnej VM02.

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 VM03 i przechowuje obiekt w zmiennej $Adapter. W tym przykładzie przyjęto założenie, ż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 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 VM05 i przechowuje obiekty w tablicy obiektów $Adapters. W tym przykładzie przyjęto założenie, że maszyna wirtualna VM05 ma trzy wirtualne karty sieciowe.

Ostatnie polecenie przekazuje drugi wirtualny obiekt karty sieciowej ($Adapters [1]) do Remove-SCVirtualNetworkAdapter polecenia cmdlet, co powoduje usunięcie tego obiektu wirtualnej karty sieciowej z maszyny wirtualnej VM05.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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ń.

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-JobVariable

Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie tego parametru.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-OnBehalfOfUser

Określa nazwę użytkownika. To polecenie cmdlet działa w imieniu użytkownika, który określa ten parametr.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:UserRole
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RunAsynchronously

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SlotID

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

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-VirtualNetworkAdapter

Określa obiekt wirtualnej karty sieciowej dla maszyny wirtualnej.

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

  • Funkcja Hyper-V. Maksymalnie cztery emulowane karty na maszynę wirtualną. Brak dostępnego sterownika dla emulowanej karty sieciowej w systemie operacyjnym Gościa systemu Windows Server 2003 x64.
  • Funkcja Hyper-V. Maksymalnie osiem syntetycznych kart sieciowych na maszynę wirtualną.
  • VMware ESX. Maksymalnie cztery emulowane karty na maszynę wirtualną.
  • Citrix XenServer. Maksymalnie siedem emulowanych kart sieciowych na maszynę wirtualną.
Typ:VirtualNetworkAdapter
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Uwagi

  • Wymaga obiektu wirtualnej karty sieciowej programu VMM, który można pobrać przy użyciu polecenia cmdlet Get-SCVirtualNetworkAdapter.