Add-SCVMHostNetworkAdapter
Dodaje fizyczną kartę sieciową na hoście zarządzanym przez program VMM do sieci wirtualnej.
Składnia
Add-SCVMHostNetworkAdapter
-VirtualNetwork <VirtualNetwork>
[-VLanEnabled]
[-VLanMode <VlanMode>]
[-VLanID <UInt16>]
[-VLanTrunkID <UInt16[]>]
[-VMHostNetworkAdapter] <HostNetworkAdapter>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Opis
Polecenie cmdlet Add-SCVMHostNetworkAdapter dodaje fizyczną kartę sieciową (nazywaną również kartą sieciową) na hoście zarządzanym przez program Virtual Machine Manager (VMM) do sieci wirtualnej. Każda maszyna wirtualna na tym hoście może również łączyć się za pośrednictwem wirtualnej karty sieciowej z siecią wirtualną.
Sieć wirtualna skonfigurowana na hoście może łączyć się z wieloma wirtualnymi kartami sieciowymi na maszynach wirtualnych wdrożonych na tym hoście.
Program VMM dla programu System Center 2019 lub nowszego obejmuje obsługę sieci wirtualnych do konfigurowania co najmniej jednej wirtualnej sieci lokalnej (VLAN) na hoście. Możesz użyć polecenia cmdlet Add-SCVMHostNetworkAdapter lub polecenia cmdlet Set-SCVMHostNetworkAdapter, aby skonfigurować jedną sieć VLAN lub wiele sieci VLAN na hoście. Aby skonfigurować odpowiednie ustawienia sieci VLAN na maszynie wirtualnej, użyj polecenia cmdlet New-SCVirtualNetworkAdapter lub polecenia cmdlet Set-SCVirtualNetworkAdapter.
Aby zapoznać się z ilustracją każdego typu sieci VLAN, zobacz przykłady tego polecenia cmdlet.
Przykłady
Przykład 1. Dodawanie fizycznej karty sieciowej hosta do sieci wirtualnej
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalVirtualNetwork01"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter01"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapterPierwsze polecenie pobiera obiekt hosta o nazwie VMHost01 i przechowuje obiekt w zmiennej $VMHost.
Drugie polecenie pobiera obiekt sieci wirtualnej o nazwie ExternalVirtualNetwork01 na vmHost01 i przechowuje obiekt w zmiennej $VirtualNetwork.
Trzecie polecenie pobiera fizyczny obiekt karty sieciowej o nazwie HostAdapter01 na vmHost01 i przechowuje obiekt w zmiennej $VMHostNetworkAdapter.
Ostatnie polecenie dodaje element HostAdapter01 do elementu ExternalVirtualNetwork01.
Uwaga: można dodać tylko jedną fizyczną kartę hosta na sieć wirtualną. W związku z tym ostatnie polecenie zakończy się niepowodzeniem, jeśli karta jest już skojarzona z określoną siecią wirtualną. Aby dodać nową kartę do sieci wirtualnej, należy najpierw usunąć istniejącą kartę hosta.
Przykład 2. Dodawanie fizycznej karty sieciowej hosta do sieci VLAN korzystającej z trybu "Magistrala"
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost02"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalNetwork02"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter02"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124Pierwsze polecenie pobiera obiekt hosta o nazwie VMHost02 i przechowuje obiekt w zmiennej $VMHost.
Drugie polecenie pobiera obiekt sieci wirtualnej o nazwie ExternalNetwork02 na vmHost02 i przechowuje obiekt w zmiennej $VirtualNetwork.
Trzecie polecenie pobiera obiekt karty sieciowej o nazwie HostAdapter02 na vmHost02 i przechowuje obiekt karty w zmiennej $VMHostNetworkAdapter.
Ostatnie polecenie dodaje hostAdapter02 do sieci wirtualnej ExternalNetwork02 i umożliwia dostęp z sieci ExternalNetwork02 do zewnętrznego urządzenia sieciowego przy użyciu 802.1Q oznakowanych sieci VLAN 1, 2, 100, 200 i 1124.
Uwaga: można dodać tylko jedną kartę hosta dla sieci wirtualnej, więc ostatnie polecenie zakończy się niepowodzeniem, jeśli karta jest już skojarzona z określoną siecią wirtualną.
Przykład 3. Dodawanie fizycznej karty sieciowej hosta do sieci VLAN korzystającej z trybu "Dostęp"
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost03.Contoso.com"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalVirtualNetwork03"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter03"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter -VLanEnabled -VLanMode "Access" -VLanID 22Pierwsze polecenie pobiera obiekt hosta o nazwie VMHost03 i przechowuje obiekt w zmiennej $VMHost.
Drugie polecenie pobiera obiekt sieci wirtualnej o nazwie ExternalNetwork03 na vmHost03 i przechowuje obiekt w zmiennej $VirtualNetwork.
Trzecie polecenie pobiera obiekt karty sieciowej o nazwie HostAdapter03 na vmHost03 i przechowuje obiekt karty w zmiennej$VMHostNetworkAdapter.
Ostatnie polecenie dodaje hostAdapter03 do sieci wirtualnej ExternalNetwork03 i ogranicza dostęp do elementu ExternalNetwork03 do identyfikatora VLANID 22.
Uwaga: można dodać tylko jedną kartę hosta dla sieci wirtualnej, więc ostatnie polecenie zakończy się niepowodzeniem, jeśli karta jest już skojarzona z określoną siecią wirtualną.
Uwaga: W tym przykładzie przyjęto założenie, że host jest już połączony z siecią VLAN lub, jeśli nie, upewnij się, że host ma dwie karty sieciowe. Jeśli host ma jedną kartę sieciową, przypisanie karty do sieci VLAN, która jest niedostępna na serwerze programu VMM, uniemożliwi programowi VMM zarządzanie hostem. Kroki opisane w tym przykładzie można wykonać na hoście, który ma tylko jedną kartę sieciową, jeśli najpierw zainstalujesz kartę Microsoft Loopback na serwerze.
Parametry
-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: | False |
| 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 |
-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 |
-VirtualNetwork
Określa obiekt sieci wirtualnej.
| Typ: | VirtualNetwork |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-VLanEnabled
Włącza wirtualną sieć LAN (VLAN) do użycia przez maszyny wirtualne na hoście Hyper-V lub Citrix XenServer.
Przykładowy format pojedynczej sieci VLAN: -VLANEnabled -VLANMode "Access" -VLANID 35 Przykładowy format wielu sieci VLAN: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-VLanID
Przypisuje identyfikator liczbowy z zakresu 1–4094 do wirtualnej karty sieciowej na maszynie wirtualnej lub do fizycznej karty sieciowej na hoście maszyny wirtualnej.
Skonfiguruj identyfikator VLanID na hoście funkcji Hyper-V, VMware ESX lub Citrix XenServer:
-- Na zewnętrznej powiązanej fizycznej karcie sieciowej, gdy tryb VLan ma wartość Access.
Skonfiguruj identyfikator VLanID na wirtualnej karcie sieciowej maszyny wirtualnej:
- Powiązana z fizyczną kartą sieciową na hoście lub
- Powiązana z wewnętrzną siecią wirtualną na hoście.
Przykładowy format: -VLanEnabled``-VLanMode "Access" -VLANID 35
| Typ: | UInt16 |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-VLanMode
Określa, czy wirtualna sieć LAN (VLAN) na hoście maszyny wirtualnej obsługuje ruch w jednej sieci VLAN (tryb dostępu) lub w wielu sieciach VLAN (tryb magistrali). Prawidłowe wartości to: Dostęp, Magistrala.
| Typ: | VlanMode |
| Dopuszczalne wartości: | Access, Trunk, Invalid |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-VLanTrunkID
Przypisuje listę identyfikatorów liczbowych w zakresie 1–4094 do fizycznej karty sieciowej na hoście Hyper-V.
Przykładowy format: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
| Typ: | UInt16[] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-VMHostNetworkAdapter
Określa fizyczny obiekt karty sieciowej na hoście, z którym mogą łączyć się maszyny wirtualne wdrożone na tym hoście.
Przykładowy format: -VMHostNetworkAdapter $VMHostNIC
| Typ: | HostNetworkAdapter |
| Position: | 0 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
Dane wyjściowe
VMHostNetworkAdapter
To polecenie cmdlet zwraca obiekt VMHostNetworkAdapter.