Remove-SCVirtualNetworkAdapter
Usuwa obiekt wirtualnej karty sieciowej z programu VMM.
Składnia
VirtualNicSpecified
Remove-SCVirtualNetworkAdapter
[-VirtualNetworkAdapter] <VirtualNetworkAdapter>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
SlotIdSpecified
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 w przypadku powodzenia (z właściwością MarkedForDeletion ustawioną na wartość $True) lub zwraca komunikat o błędzie w przypadku niepowodzenia.
Przykłady
Przykład 1: Usuwanie wirtualnej karty sieciowej o określonym adresie 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 zapisuje obiekt w zmiennej $Adapter.
Ostatnie polecenie usuwa wirtualną kartę sieciową przechowywaną w $Adapter z 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 zapisuje go 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 zapisuje obiekt w zmiennej $VM.
Drugie polecenie pobiera obiekt wirtualnej karty sieciowej na maszynie wirtualnej VM03 i zapisuje 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 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 zapisuje go w zmiennej $VM.
Drugie polecenie pobiera wszystkie obiekty wirtualnej karty sieciowej na maszynie wirtualnej VM04 i zapisuje je 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, która ma trzy wirtualne karty sieciowe
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 zapisuje obiekt w zmiennej $VM.
Drugie polecenie pobiera wszystkie obiekty wirtualnej karty sieciowej na maszynie wirtualnej VM05 i zapisuje je 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
Prosi o potwierdzenie przed uruchomieniem cmdletu.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | por |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | 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ń.
Właściwości parametru
| Typ: | Guid |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
VirtualNicSpecified
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-JobVariable
Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie tego parametru.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-OnBehalfOfUser
Określa nazwę użytkownika. To polecenie cmdlet działa w imieniu użytkownika, którego określa ten parametr.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | 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 określonej przez ten parametr.
Właściwości parametru
| Typ: | UserRole |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | 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.
Właściwości parametru
| Typ: | Guid |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-RunAsynchronously
Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-SlotID
Określa numeryczny identyfikator używany do identyfikacji urządzenia.
Właściwości parametru
| Typ: | Int32 |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
SlotIdSpecified
| Position: | Named |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | 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ą. W systemie operacyjnym gościa z systemem operacyjnym gościa Windows Server 2003 x64 nie jest dostępny sterownik dla emulowanej karty sieciowej.
- Funkcja Hyper-V. Do ośmiu kart syntetycznych na maszynę wirtualną.
- VMware ESX. Maksymalnie cztery emulowane karty na maszynę wirtualną.
- Citrix XenServer. Do siedmiu emulowanych kart na maszynę wirtualną.
Właściwości parametru
| Typ: | VirtualNetworkAdapter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
VirtualNicSpecified
| Position: | 0 |
| Obowiązkowy: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Wi |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Uwagi
- Wymaga obiektu wirtualnej karty sieciowej programu VMM, który można pobrać przy użyciu polecenia cmdlet Get-SCVirtualNetworkAdapter .