Udostępnij przez


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 .